New-OfficeWebAppsFarm

Синтаксис

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

New-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

New-OfficeWebAppsFarm -ExternalUrl "https://office.contoso.com" -CertificateName "Office Server Cert" -EditingEnabled:$true

Параметры

-AllowCEIP

Включает отчеты по программе улучшения качества программного обеспечения (CEIP) на всех серверах в ферме 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. Поэтому на каждом сервере в ферме должен быть сертификат с таким понятным именем.

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

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

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

-ClipartEnabled

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

Параметру OpenFromUrlEnabled следует задать значение True, чтобы работала служба изображений Bing. Значение по умолчанию - false.

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

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

-Confirm

Предлагает подтвердить выполнение команды. Для получения дополнительных сведений введите такую команду: get-help about_commonparameters

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

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

-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

Позволяет использовать параметр Analysis Services EffectiveUserName с 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 до любого положительного целого числа. Значение по умолчанию: 75 МБ.

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

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

-MaxTranslationCharacterCount

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

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

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

-OpenFromUncEnabled

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

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

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

-OpenFromUrlEnabled

Включает или отключает возможность просмотра файлов Office по URL-адресу или по пути UNC с помощью веб-средств просмотра. Значение по умолчанию - false. При использовании ClipartEnabled для этого параметра необходимо задать значение True.

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

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

-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. Обычно этот параметр не используется (за исключением случая, когда требуется изменить службы перевода).

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

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

-TranslationServiceAppId

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

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

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

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Для получения дополнительных сведений введите такую команду: get-help about_commonparameters

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

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