Set-SPWordConversionServiceApplication

设置 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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-ClearSupportedFormats

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-ConversionsPerInstance

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

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-DisableBinaryFileScan

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-DisableEmbeddedFonts

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition