Set-OfficeWebAppsFarm
配置现有 Office Online Server 场的设置。
语法
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] 说明
Set-OfficeWebAppsFarm cmdlet 配置现有Office Online Server场的设置。
示例
------------------示例 1---------------------
Set-OfficeWebAppsFarm -ClipartEnabled:$true此示例允许插入来自 Office.com 的剪贴画。
------------------示例 2---------------------
Set-OfficeWebAppsFarm -EditingEnabled:$true本示例在浏览器中启用 Office 的编辑功能。
------------------示例 3---------------------
Set-OfficeWebAppsFarm -OpenFromUncEnabled:$false此示例禁用从 UNC 路径查看任何 Office 文件的功能。
参数
-AllowCEIP
启用客户体验改善计划 (Office Online Server场中所有服务器上的 CEIP) 报告。
必须重启Office Online Server场中的每个服务器才能使此更改生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHttp
指示应在端口 80 上预配 IIS 站点，以便进行 HTTP 访问。 应只在所有计算机都需要 IPSEC（完全加密）的环境或不包含敏感文件的测试环境中使用 AllowHTTP。
在启用 SSLOffloaded 时自动启用。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowHttpSecureStoreConnections
指示可使用非 SSL 连接（如 HTTP）进行安全存储连接。 默认值为 False。
仅在所有计算机均需要 IPSEC（完全加密）的环境中或在不包含敏感文件的测试环境中使用 AllowHTTPSecureStoreConnections。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowOutboundHttp
允许来自Office Online Server的出站 HTTP 连接。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CacheLocation
指定用于存储呈现的图像文件的全局磁盘缓存的位置。 默认位置为 %programdata%\Microsoft\OfficeWebApps\Working\d。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CacheSizeInGB
指定全局磁盘缓存的最大大小（以 GB 为单位）。
键入的值必须是 0 或任何正整数。 默认大小为 15 GB。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CertificateName
指定Office Online Server用于创建 HTTPS 绑定的证书的友好名称。
如果指定的证书找不到或已过期，或者指定的值与多个证书关联，则会记录一条错误，并且不会创建服务器场。
此值用于加入Office Online Server场的每个服务器。 因此，场中的每台服务器都必须拥有具有此友好名称的证书。
如果使用 AllowHttp 或 SSLOffloaded 参数，则无需指定 CertificateName 参数。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClipartEnabled
支持将剪贴画从 Office.com 插入 Office 文档。 此功能需要服务器与 Web 进行通信，这种通信可直接配置，也可使用通过 Proxy 参数指定的代理配置。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
执行命令前，看到确认提示。 有关详细信息，请键入以下命令：get-help about_commonparameters。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DocumentInfoCacheSize
指定内存缓存中存储的文档转换记录的最大数量。
默认值为 5000 条记录。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EditingEnabled
允许在浏览器中进行编辑。 默认值为 False。 只有在您具有使用编辑功能的适当许可的情况下，才应将其设置为 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAbortOnRefreshOnOpenFail
防止数据刷新失败后加载工作簿。 这有助于防止用户查看过期信息或他们不应查看的可能信息。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAllowExternalData
启用在 Excel 工作簿中刷新 Excel 工作簿中支持的外部数据，其中工作簿包含到外部数据的连接。 默认值为 True。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelAutomaticVolatileFunctionCacheLifeTime
指定缓存可变函数的计算值以进行自动重新计算的最长时间（以秒为单位）。 -1：在工作簿加载时计算一次。 0：始终计算。 1 到 2073600：缓存时间为 1 秒到 24 天。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelCachingUnusedFiles
启用 Web Excel 会话不再使用的文件的缓存。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelChartAndImageSizeMax
指定 Excel 可在浏览器中打开的图表或图像的最大大小（以兆字节为单位）。 值必须是大于 0 的整数。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelConcurrentDataRequestsPerSessionMax
指定每个会话中允许的并发外部数据请求的最大数目。 如果会话必须发出多于此数目的请求，则附加请求必须进入队列。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelConnectionLifetime
指定浏览器中 Excel 的外部数据连接的持续时间（以秒为单位）。 默认值为 1800 秒。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelDefaultWorkbookCalcMode
参数值：文件 | 手动 | 自动 | AutoDataTables
| Type: | DefaultWorkbookCalcMode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelExternalDataCacheLifetime
指定浏览器中 Excel 中外部数据缓存生存期的持续时间（以秒为单位）。 默认值为 300 秒。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelMemoryCacheThreshold
可以分配给非活动对象的最大专用字节所占的百分比。 如果超过内存缓存阈值，则将释放当前未使用的缓存对象。 有效值：0（禁用非活动对象的缓存）；从 1 到 95。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelPrivateBytesMax
指定 Excel 在浏览器中使用的最大专用字节（以兆字节为单位）。 如果设置为 -1，则最大专用字节数使用 50% 的计算机物理内存。
键入的值必须为 -1 或任何正整数。 默认值为 -1。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelRequestDurationMax
指定会话中单个请求的最长持续时间（以秒为单位）。 此时间过后，该请求超时。
键入的值必须为 -1（无限制）或介于 1 到 2073600 之间的某个整数。 默认值为 300。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelRestExternalDataEnabled
允许来自 REST API 的刷新外部数据连接的请求。 如果将“允许外部数据”设置为 None，则该设置不起作用。 复选框布尔值。 默认值为 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelSessionTimeout
指定当没有用户活动时，会话在浏览器中在 Excel 中保持活动的时间（以秒为单位）。 有效值包括：
-1 会话永不过期。
0 会话在单个请求结束时过期。
1 到 2073600 会话保持活动状态的时间为 1 秒到 24 天。 默认值为 450。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUdfsAllowed
在浏览器中为 Excel 启用用户定义的函数。 默认值为 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUnusedObjectAgeMax
非活动对象保留在内存缓存中的最大时间（以分钟为单位）。 非活动状态的对象是指不在会话中使用的对象。 有效值：-1（无最大值）；从 1 到 34560（24 天）。 默认值为 -1。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelUseEffectiveUserName
允许在浏览器中将 Analysis Services EffectiveUserName 参数与 Excel 配合使用。 默认值为 False。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelWarnOnDataRefresh
关闭或关闭在浏览器中的 Excel 中刷新数据时显示的警告对话框。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcelWorkbookSizeMax
指定可以加载的工作簿的最大大小（以 MB 为单位）。
键入的值必须为 1 到 2000 之间的整数。 默认值为 10。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExternalURL
指定客户端用于从 Internet 访问Office Online Server场的 URL 根。 对于负载均衡的多服务器Office Online Server场，外部 URL 绑定到面向外部的负载均衡器的 IP 地址。
Office Online Server场至少需要一个 URL，该 URL 使用 ExternalURL 或 InternalURL 进行设置。 也可以同时设置内部和外部 URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FarmOU
指定 Active Directory 组织单位的名称， (OU) 服务器必须是 其成员才能加入Office Online Server场。 使用此参数可防止未经授权的服务器 (即不在 OU 中的服务器) 加入Office Online Server场。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
通过回答“是”禁止显示任何用户提示。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InternalURL
指定客户端必须用来从 Intranet 访问Office Online Server场的 URL 根。
Office Online Server场至少需要一个 URL。 此 URL 是使用 ExternalURL 或 InternalURL 设置的。 也可以同时设置内部和外部 URL。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogLocation
指定本地计算机上存储活动日志的位置。
该位置应用于场中的每台服务器，不能基于服务器进行自定义。 默认位置为 %programdata%\Microsoft\OfficeWebApps\Data\Logs\ULS。
务必在存储日志的驱动器上留有足够的磁盘空间。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogRetentionInDays
指定日志条目的存储天数。 超过配置天数的日志条目将被修剪。
键入的值必须是介于 0 到 365 之间的整数。 默认值为 7 天。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogVerbosity
指定跟踪日志文件中存储的信息量。 有以下值：
VerboseEX 将非常详细的信息写入跟踪日志文件。 适用于数量可能非常大的跟踪。
Verbose 将详细的信息写入跟踪日志文件。
Medium 将中等详细程度的信息写入跟踪日志文件。
High 将高度概括性的信息写入跟踪日志文件。
Monitorable 写入表示应受到监视的不寻常代码路径和操作的跟踪。
Unexpected 写入表示应受到监视的意外代码路径和操作的跟踪。
None 不向跟踪日志文件写入任何跟踪信息。
长时间将 LogVerbosity 保持为较低级别将会对性能产生不利影响。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxMemoryCacheSizeInMB
指定呈现缓存可以使用的最大内存容量（以 MB 为单位）。
键入的值必须是 0 或任何正整数。 默认大小为 1024 MB。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxTranslationCharacterCount
指定要翻译的文档可包含的最大字符数。
键入的值必须是整数值。 该值可设置为 0 以指示没有限制或设置为 2000 到 2,000,000 之间的一个值。 默认值为 125,000。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUncEnabled
启用或禁用使用联机查看器从 UNC 路径查看 Office 文件的功能。
必须先将 OpenFromUrlEnabled 设置为 True，然后才能允许联机查看器显示 UNC 路径中的文件。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUrlEnabled
打开或关闭使用联机查看者从 URL 或 UNC 路径查看 Office 文件的功能。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OpenFromUrlThrottlingEnabled
限制在一定时段内来自任何给定服务器的 URL 打开请求的次数。 默认限制值（不可配置）可确保Office Online Server场不会因请求在联机查看器中查看内容而使单个服务器不堪重负。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PicturePasteDisabled
关闭用户在浏览器中将图像从网页粘贴到 Office 的功能。 默认值为 False。 如果 OpenFromURLEnabled 设置为 True，并且未将 PicturePasteDisabled 设置为 False，则用户可以在浏览器中将图像粘贴到 Office 中。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
指定配置为允许向外部网站发出 HTTP 请求的代理服务器的 URL。 通常与 ClipartEnabled 和 TranslationEnabled 参数一起配置。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecycleActiveProcessCount
指定在回收进程之前，单个 Word 或 PowerPoint 进程可以呈现的文件数。
键入的值必须是介于 1 到 1000 之间的整数。 默认值为 5。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemovePersonalInformationFromLogs
尽最大努力清理Office Online Server日志中的个人信息，并将值替换为 SHA256 哈希。 可能会擦除信息包括：
文档名称和 URL
IP 地址
电子邮件地址
用户名
默认值为 False。 请注意，启用此参数并不保证个人信息不会记录到Office Online Server日志中。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RenderingLocalCacheLocation
指定 Word 和 PowerPoint 查看服务使用的临时缓存的位置。
默认位置为 %programdata%\Microsoft\OfficeWebApps\Working\waccache。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-S2SCertificateName
用于 SharePoint Server 的服务器到服务器身份验证的证书的友好名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SSLOffloaded
向Office Online Server场中的服务器指示 SSL 已卸载到负载均衡器。 如果启用 SSLOffloaded，Web 应用程序将绑定到本地服务器上的端口 80 (HTTP)。 但是，引用其他资源（如 CSS 或图像）的 HTML 将对这些引用使用 HTTPS URL。
必须重新启动场中的每台服务器，此更改才会生效。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationEnabled
启用对使用 Microsoft Translator 的自动文档翻译的支持，Microsoft Translator 是一种在不同的语言之间翻译文本的联机服务。 已翻译的文件显示在 Word 中。 因为 Microsoft Translator 是一项联机服务，您必须直接启用或使用通过 Proxy 参数指定的代理启用服务器与 Web 的通信。
Microsoft Translator 可能会收集数据以改善翻译质量。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationServiceAddress
指定将翻译请求发送到的翻译服务器的 URL。 默认为 Microsoft Translator 联机服务。 一般不使用此参数，除非必须更改翻译服务。
必须重启Office Online Server场中的每个服务器才能使此更改生效。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TranslationServiceAppId
指定翻译服务的应用程序 ID。 默认值为浏览器中 Office 的公共应用程序 ID。 一般不使用此参数，除非您已与 Microsoft Translator 协商要求其他服务，并且他们向您提供了专用应用程序 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示一条描述命令作用的消息，而不执行命令。 有关详细信息，请键入以下命令：get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |