Set-SPWordConversionServiceApplication
适用于： SharePoint Server 2010
上一次修改主题： 2015-03-09
设置 Word 自动化服务应用程序的属性。
Syntax
Set-SPWordConversionServiceApplication [-Identity] <WordServiceApplicationPipeBind> [-ActiveProcesses <Nullable>] [-AddSupportedFormats <String[]>] [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-ClearSupportedFormats <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-ConversionsPerInstance <Nullable>] [-ConversionTimeout <Nullable>] [-DatabaseCredential <PSCredential>] [-DatabaseName <String>] [-DatabaseServer <String>] [-DisableBinaryFileScan <SwitchParameter>] [-DisableEmbeddedFonts <SwitchParameter>] [-KeepAliveTimeout <Nullable>] [-MaximumConversionAttempts <Nullable>] [-MaximumConversionTime <Nullable>] [-MaximumGroupSize <Nullable>] [-MaximumMemoryUsage <Nullable>] [-RecycleProcessThreshold <Nullable>] [-RemoveSupportedFormats <String[]>] [-TimerJobFrequency <Nullable>] [-WhatIf [<SwitchParameter>]]
详细说明
Set-SPWordConversionServiceApplication cmdlet 将设置 Word 自动化服务应用程序的全局属性。
有关 Windows PowerShell for SharePoint Server 2010 的权限及最新信息，请参阅 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
| 参数 | 是否必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind |
指定要更新的 Word 自动化服务应用程序。 键入的值必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh；Word 自动化服务应用程序的有效名称（例如，WordSvcApp1）；或者有效 SPServiceApplication 对象的实例。 |
ActiveProcesses |
可选 |
System.Nullable |
指定运行服务应用程序的每台计算机上的转换进程数量。此值相当于同时进行的转换的数量。默认值为 8。 键入的值必须是 1 到 1000 之间的有效整数。 |
AddSupportedFormats |
可选 |
System.String[] |
指定要启用的一组文件格式，启用后服务应用程序可使用这些格式。 该值必须是包含下列一个或多个值的逗号分隔列表：docx、doc、mht、rtf、xml。 |
ApplicationPool |
可选 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
指定运行此 Word 自动化服务实例的由 IIS 管理的现有应用程序池。 键入的值必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh；应用程序池的有效名称（例如，AppPoolName1）；或者有效 IISWebServiceApplicationPool 对象的实例。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 备注 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。 |
ClearSupportedFormats |
可选 |
System.Management.Automation.SwitchParameter |
指定应当对该服务应用程序禁用所有文件格式。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
ConversionsPerInstance |
可选 |
System.Nullable |
指定在每次运行计时器作业时，发送到每个转换进程的项目的数量（请参阅本表前面的 ActiveProcesses 参数说明）。默认值为 12。 键入的值必须为有效整数。 |
ConversionTimeout |
可选 |
System.Nullable |
指定单位为分钟的时间，超过该时间后，每次计时器作业运行时，标记为 InProgress 的转换将由系统确认为仍在运行，如有必要，将重新启动转换。默认值为 5。 键入的值必须是 1 到 60 之间的有效整数。 |
DatabaseCredential |
可选 |
System.Management.Automation.PSCredential |
指定要用于连接到 Word 自动化服务应用程序的数据库的凭据。只有在使用 SQL 身份验证来访问服务应用程序数据库时，才需要使用此参数。 如果指定了 DatabaseCredential 参数，则还需要 DatabaseName 和 DatabaseServer 参数。 |
DatabaseName |
可选 |
System.String |
指定要用于此 Word 自动化服务应用程序实例的数据库的名称。 键入的值必须是有效的 SQL 数据库名称；例如，MetadataDB1。 |
DatabaseServer |
可选 |
System.String |
指定 Word 自动化服务数据库的主机服务器的名称。 键入的值必须是有效的 SQL 数据库服务器主机名；例如，SQLServerHost1。 |
DisableBinaryFileScan |
可选 |
System.Management.Automation.SwitchParameter |
指定在处理 Microsoft Word 97 到 Word 2003 文档时，是否运行额外的检查。仅在服务所处理的所有文档都受信任时关闭此设置。 |
DisableEmbeddedFonts |
可选 |
System.Management.Automation.SwitchParameter |
指定如果输入文档中存在嵌入字体，是否忽略这些字体。 |
KeepAliveTimeout |
可选 |
System.Nullable |
指定以秒为单位的时间长度，超过这段时间后，无响应的转换将终止。默认值为 30。 键入的值必须是 10 到 60 之间的有效整数。 |
MaximumConversionAttempts |
可选 |
System.Nullable |
尝试转换的最大次数，超过该次数后，转换状态标记为“Failed”。默认值为 2。 键入的值必须是 1 到 10 之间的有效整数。 |
MaximumConversionTime |
可选 |
System.Nullable |
指定以秒为单位的最大时间长度，超过这段时间后，转换终止。默认值为 300。 键入的值必须是 60 到 MaxInt 之间的有效整数。 |
MaximumMemoryUsage |
可选 |
System.Nullable |
指定服务应用程序可使用的系统内存的最大百分比。默认值为 100。 键入的值必须是 10 到 100 之间的有效整数。 |
RecycleProcessThreshold |
可选 |
System.Nullable |
指定在回收转换进程之前转换的文档的数量。有关转换进程的更多信息，请参阅本表前面的 ActiveProcess 参数说明。 键入的值必须是 1 到 1000 之间的有效整数。 |
RemoveSupportedFormats |
可选 |
System.String[] |
指定要禁用的一组文件格式，禁用后服务应用程序将不能使用这些格式。 该值必须是以逗号分隔的下列一个或多个值的列表：docx、doc、mht、rtf、xml。 |
TimerJobFrequency |
可选 |
System.Nullable |
指定以分钟为单位的频率，此服务应用程序的计时器作业以此频率运行。默认值为 15。 键入的值必须是 1 到 59 之间的有效整数。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
-----------示例-----------------
Get-SPServiceApplication -Name WordServices1 | Set-SPWordConversionServiceApplication -TimerJobFrequency 30
此示例将 WordServices1 应用程序的计时器作业频率设置为 30 分钟。