Set-SPWordConversionServiceApplication
適用版本: SharePoint Server 2010
上次修改主題的時間: 2015-03-09
設定 Word Automation Services 應用程式。
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 Automation Services 應用程式的全域屬性。
如需 Windows PowerShell for SharePoint Server 2010 的權限及最新資訊,請參閱 TechNet (https://go.microsoft.com/fwlink/?LinkId=163183)。
Parameters
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind |
指定要更新的 Word Automation Services 應用程式。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的 Word Automation Services 應用程式 (例如 WordSvcApp1);或有效之 SPServiceApplication 物件的執行個體。 |
ActiveProcesses |
選用 |
System.Nullable |
指定每部執行此服務應用程式之電腦的轉換程序數。此值相當於同時轉換數。預設值為 8。 此類型必須是介於 1 到 1000 之間的有效整數。 |
AddSupportedFormats |
選用 |
System.String[] |
指定要供應服務應用程式使用的一組檔案格式。 值必須是以逗號分隔的清單,檔案格式為下列一個或多個:docx、doc、mht、rtf、xml。 |
ApplicationPool |
選用 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
指定此 Word Automation Services 執行個體執行所在之現有的 IIS 受管理應用程式集區。 此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;有效的應用程式集區名稱 (例如 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 Automation Services 應用程式資料庫的認證。唯有在 SQL 驗證用於存取服務應用程式資料庫時,才使用此參數。 指定 DatabaseCredential 參數時,需有 DatabaseName 及 DatabaseServer 參數。 |
DatabaseName |
選用 |
System.String |
指定用於此 Word Automation Services 應用程式執行個體的資料庫名稱。 此類型必須是有效的 SQL 資料庫名稱,例如 MeatadataDB1。 |
DatabaseServer |
選用 |
System.String |
指定 Word Automation Services 資料庫之主機伺服器的名稱。 此類型必須是有效的 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
分鐘。