通过

Set-SPWordConversionServiceApplication

  • 参考
模块:
SharePointServer
适用于:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

设置 Word Automation Services 应用程序的属性。

语法

Set-SPWordConversionServiceApplication
   [-Identity] <WordServiceApplicationPipeBind>
   [-ActiveProcesses <Int32>]
   [-AddSupportedFormats <String[]>]
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearSupportedFormats]
   [-Confirm]
   [-ConversionsPerInstance <Int32>]
   [-ConversionTimeout <Int32>]
   [-DatabaseCredential <PSCredential>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-DisableBinaryFileScan]
   [-DisableEmbeddedFonts]
   [-KeepAliveTimeout <Int32>]
   [-MaximumConversionAttempts <Int32>]
   [-MaximumConversionTime <Int32>]
   [-MaximumMemoryUsage <Int32>]
   [-RecycleProcessThreshold <Int32>]
   [-RemoveSupportedFormats <String[]>]
   [-TimerJobFrequency <Int32>]
   [-WhatIf]
   [-MaximumGroupSize <Int32>]
   [-MaximumSyncConversionRequests <Int32>]
   [<CommonParameters>]

说明

cmdlet Set-SPWordConversionServiceApplication 设置 Word Automation Services 应用程序的全局属性。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

-----------例子-----------------

Get-SPServiceApplication -Name WordServices1 | Set-SPWordConversionServiceApplication -TimerJobFrequency 30

此示例将 WordServices1 应用程序的计时器作业频率设置为 30 分钟。

参数

-ActiveProcesses

指定运行服务应用程序的每台计算机上的转换进程数量。 此值相当于同时进行的转换的数量。 默认值为 8。

键入的值必须是 1 到 1000 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AddSupportedFormats

指定要启用的一组文件格式，启用后服务应用程序可使用这些格式。

该值必须是包含下列一个或多个值的逗号分隔列表：docx、doc、mht、rtf、xml。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPool

指定运行此 Word Automation Services 实例的由 IIS 管理的现有应用程序池。

键入的值必须是有效的 GUID（格式为 12345678-90ab-cdef-1234-567890bcdefgh）；是应用程序池的有效名称（例如 AppPoolName1）；或者是有效 IISWebServiceApplicationPool 对象的实例。

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AssignmentCollection

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。 如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ClearSupportedFormats

指定应当对该服务应用程序禁用所有文件格式。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

执行命令前，看到确认提示。 有关详细信息，请键入以下命令：get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionsPerInstance

指定在每次运行计时器作业时，发送到每个转换进程的项目的数量（请参阅本表前面的 ActiveProcesses 参数说明）。 默认值为 12。

键入的值必须为有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionTimeout

指定在每次运行计时器作业时确认标记为 InProgress 的转换仍在运行的时间（以分钟为单位），并在必要时重启转换。 默认值为 5。

键入的值必须是 1 到 60 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredential

指定要用于连接到 Word Automation Services 应用程序的数据库的凭据。 只有在使用 SQL 身份验证来访问服务应用程序数据库时，才需要使用此参数。

如果指定了 DatabaseCredential 参数，则还需要 DatabaseName 和 DatabaseServer 参数。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

指定要用于此 Word Automation Services 应用程序实例的数据库的名称。

键入的值必须是有效的 SQL 数据库名称；例如，MetadataDB1。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

指定 Word Automation Services 数据库的主机服务器的名称。

键入的值必须是有效的 SQL 数据库服务器主机名；例如，SQLServerHost1。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableBinaryFileScan

指定在处理 Word 文档时是否运行其他检查。 仅在服务所处理的所有文档都受信任时关闭此设置。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableEmbeddedFonts

指定如果输入文档中存在嵌入字体，是否忽略这些字体。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

指定要更新的 Word Automation Services 应用程序。

键入的值必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh；Word Automation Services 应用程序的有效名称（例如，WordSvcApp1）；或者有效 SPServiceApplication 对象的实例。

Type:WordServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-KeepAliveTimeout

指定以秒为单位的时间长度，超过这段时间后，无响应的转换将终止。 默认值为 30。

键入的值必须是 10 到 60 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionAttempts

尝试转换的最大次数，超过该次数后，转换状态标记为“Failed”。 默认值为 2。

键入的值必须是 1 到 10 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionTime

指定以秒为单位的最大时间长度，超过这段时间后，转换终止。 默认值为 300。

键入的值必须是 60 到 MaxInt 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumGroupSize

{{Fill MaximumGroupSize Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumMemoryUsage

指定服务应用程序可使用的系统内存的最大百分比。 默认值为 100。

键入的值必须是 10 到 100 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumSyncConversionRequests

{{Fill MaximumSyncConversionRequests Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RecycleProcessThreshold

指定在回收转换进程之前转换的文档的数量。 有关转换进程的更多信息，请参阅本表前面的 ActiveProcess 参数说明。

键入的值必须是 1 到 1000 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RemoveSupportedFormats

指定要禁用的一组文件格式，禁用后服务应用程序将不能使用这些格式。

该值必须是以逗号分隔的下列一个或多个值的列表：docx、doc、mht、rtf、xml。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TimerJobFrequency

指定以分钟为单位的频率，此服务应用程序的计时器作业以此频率运行。 默认值为 15。

键入的值必须是 1 到 59 之间的有效整数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

显示一条描述命令作用的消息，而不执行命令。 有关详细信息，请键入以下命令：get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019