Set-OfficeWebAppsFarm

Синтаксис

Default (По умолчанию)

Set-OfficeWebAppsFarm
    [-Force]
    [-FarmOU <String>]
    [-InternalURL <String>]
    [-ExternalURL <String>]
    [-AllowHttp]
    [-AllowOutboundHttp]
    [-SSLOffloaded]
    [-CertificateName <String>]
    [-S2SCertificateName <String>]
    [-EditingEnabled]
    [-Proxy <String>]
    [-LogLocation <String>]
    [-LogRetentionInDays <UInt32>]
    [-LogVerbosity <String>]
    [-CacheLocation <String>]
    [-MaxMemoryCacheSizeInMB <Int32>]
    [-DocumentInfoCacheSize <UInt32>]
    [-CacheSizeInGB <Int32>]
    [-ClipartEnabled]
    [-TranslationEnabled]
    [-MaxTranslationCharacterCount <Int32>]
    [-TranslationServiceAppId <String>]
    [-TranslationServiceAddress <String>]
    [-RenderingLocalCacheLocation <String>]
    [-RecycleActiveProcessCount <UInt32>]
    [-AllowCEIP]
    [-ExcelRequestDurationMax <Int32>]
    [-ExcelSessionTimeout <Int32>]
    [-ExcelWorkbookSizeMax <Int32>]
    [-ExcelPrivateBytesMax <Int32>]
    [-ExcelConnectionLifetime <Int32>]
    [-ExcelExternalDataCacheLifetime <Int32>]
    [-ExcelAllowExternalData]
    [-ExcelUseEffectiveUserName]
    [-ExcelWarnOnDataRefresh]
    [-ExcelUdfsAllowed]
    [-ExcelMemoryCacheThreshold <Int32>]
    [-ExcelUnusedObjectAgeMax <Int32>]
    [-ExcelCachingUnusedFiles]
    [-ExcelAbortOnRefreshOnOpenFail]
    [-ExcelAutomaticVolatileFunctionCacheLifeTime <Int32>]
    [-ExcelConcurrentDataRequestsPerSessionMax <Int32>]
    [-ExcelDefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
    [-ExcelRestExternalDataEnabled]
    [-ExcelChartAndImageSizeMax <Int32>]
    [-OpenFromUrlEnabled]
    [-OpenFromUncEnabled]
    [-OpenFromUrlThrottlingEnabled]
    [-PicturePasteDisabled]
    [-RemovePersonalInformationFromLogs]
    [-AllowHttpSecureStoreConnections]
    [-WhatIf]
    [-Confirm]

Описание

Примеры

ПРИМЕР 1

Set-OfficeWebAppsFarm -ClipartEnabled:$true

ПРИМЕР 2

Set-OfficeWebAppsFarm -EditingEnabled:$true

ПРИМЕР 3

Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false

Параметры

-AllowCEIP

Включение отчетов по программе улучшения качества программного обеспечения (CEIP) на всех серверах фермы Office Online Server.

Чтобы изменения вступили в силу, необходимо перезапустить каждый сервер в ферме Office Online Server.

Свойства параметров

Наборы параметров

-AllowHttp

Указывает, что сайты IIS должны быть подготовлены на порту 80 для доступа по протоколу HTTP. Используйте параметр AllowHTTP только в средах, в которых все компьютеры применяют IPSEC (полное шифрование), или в тестовых средах без конфиденциальных файлов.

Включается автоматически при включении параметра SSLOffloaded.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-AllowHttpSecureStoreConnections

Указывает, что подключения Secure Store могут выполняться с помощью подключений, не использующих протокол SSL (например, HTTP). Значение по умолчанию - false.

Используйте AllowHTTPSecureStoreConnections только в средах, где для всех компьютеров требуется IPSEC (полное шифрование), либо в тестовых средах без конфиденциальных файлов.

Свойства параметров

Наборы параметров

-AllowOutboundHttp

Разрешает исходящие HTTP-подключения из Office Online Server.

Свойства параметров

Наборы параметров

-CacheLocation

Определяет расположение глобального кэша диска, используемого для хранения файлов сформированных изображений. Расположение по умолчанию: %programdata%\Microsoft\OfficeWebApps\Working\d\.

Свойства параметров

Наборы параметров

-CacheSizeInGB

Определяет максимальный размер глобального кэша диска в гигабайтах. Типом должно быть целое значение в диапазоне от 0 до любого положительного целого числа. Значение по умолчанию: 15 ГБ.

Свойства параметров

Наборы параметров

-CertificateName

Указывает понятное имя сертификата, который Office Online Server использует для создания привязок HTTPS.

Если указанный сертификат не найден или срок его действия истек, или если заданное значение связано с несколькими сертификатами, в журнал записывается ошибка, а ферма не создается.

Это значение используется на каждом сервере, присоединяющемся к ферме Office Online Server. Поэтому на каждом сервере в ферме должен быть сертификат с таким понятным именем.

Вам не нужно указывать параметр CertificateName, если вы используете параметр AllowHttp или SSLOffloaded.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-ClipartEnabled

Обеспечивает поддержку вставки картинок из Office.com в документы Office. Чтобы эта функция работала, сервер должен быть подключен к Интернету напрямую или с использованием прокси-сервера, заданного в параметре Proxy.

Свойства параметров

Наборы параметров

-Confirm

Предлагает подтвердить выполнение команды.

Свойства параметров

Наборы параметров

-DocumentInfoCacheSize

Определяет максимальное число записей преобразования документа, которые хранятся в кэше памяти.

Значение по умолчанию — 5000 записей.

Свойства параметров

Наборы параметров

-EditingEnabled

Включает поддержку редактирования в браузере. Значение по умолчанию - false. Значение True задается только при наличии соответствующей лицензии на использование возможностей редактирования.

Свойства параметров

Наборы параметров

-ExcelAbortOnRefreshOnOpenFail

Запрещает загрузку книги в случае сбоя при обновлении данных. Благодаря этому пользователи не смогут просматривать устаревшие сведения или те данные, к которым у них не должно быть доступа.

Свойства параметров

Наборы параметров

-ExcelAllowExternalData

Включает обновление поддерживаемых внешних данных в книгах Excel в браузере, если книги содержат подключения к внешним данным. Значение по умолчанию — True.

Свойства параметров

Наборы параметров

-ExcelAutomaticVolatileFunctionCacheLifeTime

Задает максимальное время (в секундах) кэширования вычисленного значения переменной функции для автоматического пересчета.

• -1: вычисление осуществляется один раз при загрузке книги.
• 0: вычисления осуществляются всегда.
• От 1 до 2 073 600: значение кэшируется от 1 секунды до 24 дней.

Свойства параметров

Наборы параметров

-ExcelCachingUnusedFiles

Включает кэширование файлов, которые больше не используются сеансами веб-приложения Excel.

Свойства параметров

Наборы параметров

-ExcelChartAndImageSizeMax

Определяет максимальный размер диаграммы или изображения в мегабайтах, которые можно открыть в Excel в браузере. Значение должно быть положительным целым числом больше 0.

Свойства параметров

Наборы параметров

-ExcelConcurrentDataRequestsPerSessionMax

Задает максимальное число одновременных запросов внешних данных, разрешенное для одного сеанса. Если это ограничение превышено, дополнительные запросы помещаются в очередь.

Свойства параметров

Наборы параметров

-ExcelConnectionLifetime

Указывает длительность подключения к внешним данным для Excel в браузере (в секундах). Значение по умолчанию: 1800 секунд.

Свойства параметров

Наборы параметров

-ExcelDefaultWorkbookCalcMode

PARAMVALUE: File | Manual | Auto | AutoDataTables

Свойства параметров

Наборы параметров

-ExcelExternalDataCacheLifetime

Указывает длительность в секундах времени существования внешнего кэша данных в Excel в браузере. По умолчанию используется значение 300 секунд.

Свойства параметров

Наборы параметров

-ExcelMemoryCacheThreshold

Процентная доля от максимального числа байтов исключительного пользования, которая может быть выделена для размещения неактивных объектов. При превышении порогового значения кэша памяти неиспользуемые в настоящий момент кэшированные объекты удаляются. Допустимые значения: 0 (отключает кэширование неактивных объектов) и 1–95.

Свойства параметров

Наборы параметров

-ExcelPrivateBytesMax

Указывает максимальное число байтов закрытого пользования (в мегабайтах), используемое Excel в браузере. Если значение равно -1, под байты исключительного пользования по умолчанию выделяется 50 процентов физической памяти компьютера.

Типом должно быть значение -1 или любое положительное целое число. Значение по умолчанию равно -1.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-ExcelRequestDurationMax

Указывает максимальную длительность одного запроса в сеансе (сек). В случае превышения этого значения время ожидания запроса истекает.

Типом должно быть значение -1 (без ограничений) или целое число от 1 до 2 073 600. Значение по умолчанию равно 300.

Свойства параметров

Наборы параметров

-ExcelRestExternalDataEnabled

Разрешает запросы из REST API на обновление подключений к внешним данным. Этот параметр не действует, если параметру "Разрешить внешние данные" присвоено значение None. Логическое значение флажка. Значение по умолчанию — False.

Свойства параметров

Наборы параметров

-ExcelSessionTimeout

Время в секундах, в течение которого сеанс остается активным в Excel в браузере при отсутствии активности пользователя. Допустимые значения:

• -1 сеанс не ограничен.
• 0 Сеанс истекает в конце одного запроса.
• От 1 до 2 073 600 Сеанс остается активным от 1 секунды до 24 дней.

Значение по умолчанию: 450.

Свойства параметров

Наборы параметров

-ExcelUdfsAllowed

Включает пользовательские функции для Excel в браузере. Значение по умолчанию - false.

Свойства параметров

Наборы параметров

-ExcelUnusedObjectAgeMax

Максимальное время (в минутах), в течение которого неактивные объекты остаются в кэше памяти. Неактивные объекты — это те объекты, которые не используются в сеансе.

Допустимые значения:

• -1 (нет максимума)
• С 1 по 34560 (24 дня).

Значение по умолчанию — -1.

Свойства параметров

Наборы параметров

-ExcelUseEffectiveUserName

Позволяет использовать параметр EffectiveUserName служб Analysis Services в Excel в браузере. Значение по умолчанию - false.

Свойства параметров

Наборы параметров

-ExcelWarnOnDataRefresh

Отключает или включает предупреждающее диалоговое окно, отображаемое при обновлении данных в Excel в браузере.

Свойства параметров

Наборы параметров

-ExcelWorkbookSizeMax

Указывает наибольший размер книги, при котором ее можно загрузить (МБ).

Типом должно быть целое число от 1 до 2000. Значение по умолчанию — 10.

Свойства параметров

Наборы параметров

-ExternalURL

Указывает корневой URL-адрес, используемый клиентами для доступа к ферме Office Online Server из Интернета. В случае фермы Office Online Server с балансировкой нагрузки и несколькими серверами внешний URL-адрес привязан к IP-адресу внешней подсистемы балансировки нагрузки.

Ферме Office Online Server требуется по крайней мере один URL-адрес, заданный с помощью ExternalURL или InternalURL. Можно также задать и внутренний и внешний URL-адрес.

Свойства параметров

Наборы параметров

-FarmOU

Указывает имя подразделения Active Directory, участником которого должны быть серверы для присоединения к ферме Office Online Server. Этот параметр используется для предотвращения присоединения неавторизованных серверов (т. е. серверов не в подразделении) к ферме Office Online Server.

Свойства параметров

Наборы параметров

-Force

Подавляет все запросы, отвечая «Да».

Свойства параметров

Наборы параметров

-InternalURL

Указывает корневой URL-адрес, который клиенты должны использовать для доступа к ферме Office Online Server из интрасети.

Ферме Office Online Server требуется хотя бы один URL-адрес. Он задается с помощью параметра ExternalURL или InternalURL. Можно также задать и внутренний и внешний URL-адрес.

Свойства параметров

Наборы параметров

-LogLocation

Определяет расположение на локальном компьютере, в котором хранятся журналы активности.

Данное расположение применяется на всех серверах в ферме и его нельзя настроить для каждого из них отдельно. Расположение по умолчанию: %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS\.

Обязательно освободите достаточно места на диске, на котором хранятся журналы.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-LogRetentionInDays

Определяет период хранения записей журнала в днях. Записи, срок хранения которых превышает заданный, удаляются.

Тип значения: целое число в диапазоне от 0 до 365. Значение по умолчанию — 7 дней.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-LogVerbosity

Определяет объем информации, хранимой в файлах журналов трассировки. Доступны следующие значения:

• VerboseEX — запись сведений низкого уровня в журнал трассировки. Это полезно для трассировок большого объема.
• Verbose — запись сведений низкого уровня в журнал трассировки.
• Medium — запись сведений среднего уровня в журнал трассировки.
• High — запись сведений высокого уровня в журнал трассировки.
• Monitorable — запись сведений трассировки, представляющих необычный путь к коду и действия, которые должны отслеживаться.
• Unexpected — запись сведений трассировки, представляющих непредвиденный путь к коду и действия, которые должны отслеживаться.
• None — трассировки не записываются в файл журнала.

Если для параметра LogVerbosity в течение длительного времени используется низкий уровень сведений, это может значительно ухудшить производительность системы.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-MaxMemoryCacheSizeInMB

Определяет максимальный объем памяти в мегабайтах, который может использовать кэш отображения.

Типом должно быть целое значение в диапазоне от 0 до любого положительного целого числа. Значение по умолчанию: 1024 МБ.

Свойства параметров

Наборы параметров

-MaxTranslationCharacterCount

Задает максимальное число знаков, которое может содержать документ, чтобы его можно было перевести.

Типом должно являться целое значение. Может быть задано значение 0, указывающее на отсутствие такого ограничения, или же значения в диапазоне 2000–2 000 000. Значение по умолчанию: 125 000.

Свойства параметров

Наборы параметров

-OpenFromUncEnabled

Отключает или включает возможность использования средств просмотра Online Viewer для просмотра файлов Office по UNC-пути.

Чтобы разрешить в средствах просмотра Online Viewer отображение файлов в UNC-путях, следует сначала задать для параметра OpenFromUrlEnabled значение True.

Свойства параметров

Наборы параметров

-OpenFromUrlEnabled

Включает или отключает возможность просматривать файлы Office по URL-адресу или UNC-пути.

Свойства параметров

Наборы параметров

-OpenFromUrlThrottlingEnabled

Регулирует число URL-запросов "Открыть из" с любого заданного сервера в течение определенного периода времени. Значения регулирования по умолчанию, которые не настраиваются, гарантируют, что ферма Office Online Server не будет перегружать один сервер запросами на контент для просмотра в онлайн-приложениях просмотра.

Свойства параметров

Наборы параметров

-PicturePasteDisabled

Отключает для пользователей возможность вставки изображений с веб-страницы в Office в браузере. Значение по умолчанию - false. Если параметру OpenFromURLEnabled присвоено значение True, а параметру PicturePasteDisabled не присвоено значение False, пользователи могут вставлять изображения в Office в браузере.

Свойства параметров

Наборы параметров

-Proxy

Определяет URL-адрес прокси-сервера, который разрешает HTTP-запросы на внешние сайты. Обычно этот параметр задается вместе с параметрами ClipartEnabled и TranslationEnabled.

Свойства параметров

Наборы параметров

-RecycleActiveProcessCount

Указывает количество файлов, которые может отображаться в одном процессе Word или PowerPoint перед его повторным использованием. Тип значения: целое число в диапазоне от 1 до 1000. Значение по умолчанию равно 5.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-RemovePersonalInformationFromLogs

Обеспечивает максимально эффективную очистку личных сведений из журналов Office Online Server и заменяет значения хэшем SHA256. Потенциально скрытые данные могут быть:

• Имена документов и URL-адреса
• IP-адреса
• Адреса электронной почты
• Имена пользователей

Значение по умолчанию - false. Обратите внимание, что включение этого параметра не гарантирует, что личные сведения не будут записаны в журналы Office Online Server.

Свойства параметров

Наборы параметров

-RenderingLocalCacheLocation

Указывает расположение временного кэша для использования службами просмотра Word и PowerPoint.

Расположение по умолчанию: %programdata%\Microsoft\OfficeWebApps\Working\waccache\.

Свойства параметров

Наборы параметров

-S2SCertificateName

Понятное имя сертификата, используемого для проверки подлинности между серверами в SharePoint Server.

Свойства параметров

Наборы параметров

-SSLOffloaded

Указывает серверам в ферме Office Online Server, что SSL выгружен в балансировщик нагрузки. Если параметр SSLOffloaded включен, веб-приложения привязаны к порту 80 (HTTP) на локальном сервере. Однако HTML-код, ссылающийся на другие ресурсы, например CSS и изображения, использует URL-адреса HTTPS для этих ссылок.

Необходимо перезапустить все серверы в ферме, чтобы это изменение вступило в силу.

Свойства параметров

Наборы параметров

-TranslationEnabled

Включает поддержку автоматического перевода документа с помощью Microsoft Translator, интерактивной службы, переводящей текст с разных языков. Переведенный файл отображается в Word. Так как Microsoft Translator — это интерактивная служба, необходимо включить связь сервера с Интернетом напрямую или через прокси-сервер, указанный в параметре Proxy.

Служба Microsoft Translator может собирать данные для улучшения качества перевода.

Свойства параметров

Наборы параметров

-TranslationServiceAddress

Указывает URL-адрес сервера переводов, на который отправляются запросы переводов. Значение по умолчанию: интернет-служба Microsoft Translator. Обычно этот параметр не используется (за исключением случая, когда требуется изменить службы перевода).

Чтобы изменения вступили в силу, необходимо перезапустить каждый сервер в ферме Office Online Server.

Свойства параметров

Наборы параметров

-TranslationServiceAppId

Указывает идентификатор приложения для службы перевода. По умолчанию используется общедоступный идентификатор приложения Office в браузере. Обычно этот параметр не используется (за исключением случая, когда с Microsoft Translator согласовано предоставление дополнительных служб и был получен соответствующий идентификатор частного приложения).

Свойства параметров

Наборы параметров

-WhatIf

Отображает описание команды. При этом сама команда не выполняется.

Свойства параметров

Наборы параметров