New-OfficeWebAppsFarm

参考

模块:: OfficeOnlineServerPowerShell

在本地计算机上创建新 Office Online Server 场。

语法

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]

说明

New-OfficeWebAppsFarm cmdlet 在本地计算机上创建新的Office Online Server场。在 Office Online Server 场中的第一台服务器上运行此 cmdlet，然后使用 New-OfficeWebAppsMachine cmdlet 将更多服务器添加到场。

示例

------------------示例 1---------------------

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

本示例在本地服务器上创建一个Office Online Server场，该服务器场已在浏览器中为 Office 启用编辑。在本示例中，内部用户和外部用户仅使用一个 URL。 “证书名称”值是显示在计算机证书存储中的证书的友好名称。

参数

-AllowCEIP

启用客户体验改善计划 (Office Online Server场中所有服务器上的 CEIP) 报告。

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 文档的支持。此功能需要服务器与 Web 进行通信，这种通信可直接配置，也可使用通过 Proxy 参数指定的代理配置。

必须将 OpenFromUrlEnabled 参数设置为 True，必应图像才能正常工作。默认值为 False。

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，使用 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，使用 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 或任何正整数。默认大小为 75 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 文件的功能。默认值为 False。

使用 ClipartEnabled 时，必须将此参数设置为 True。

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 联机服务。一般不使用此参数，除非必须更改翻译服务。

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