Set-SPWordConversionServiceApplication

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

语法

Default (默认值)

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

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AddSupportedFormats

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ApplicationPool

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SPIisWebServiceApplicationPoolPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ClearSupportedFormats

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConversionsPerInstance

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConversionTimeout

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定每次运行计时器作业时确认标记为 InProgress 的转换仍在运行的时间(以分钟为单位),如有必要,将重启转换。 默认值为 5。

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseCredential

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseName

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseServer

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableBinaryFileScan

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableEmbeddedFonts

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:WordServiceApplicationPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-KeepAliveTimeout

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumConversionAttempts

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumConversionTime

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumGroupSize

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

{{Fill MaximumGroupSize Description}}

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumMemoryUsage

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MaximumSyncConversionRequests

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

{{Fill MaximumSyncConversionRequests Description}}

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RecycleProcessThreshold

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RemoveSupportedFormats

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TimerJobFrequency

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters