Set-CMTaskSequenceDeploymentType

模組:

ConfigurationManager

在應用程式上設定工作順序部署類型。

語法

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -Application <IResultObject>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

適用於 2006 版和更新版本。 使用此 Cmdlet 在應用程式上設定工作順序部署類型。 如需詳細資訊，請 參閱工作順序部署類型。

此 Cmdlet 的語法與 MSI 部署類型 Cmdlet Set-CMMsiDeploymentType 類似。 主要差異如下：

• -InstallTaskSequenceId <string> (必要) ：安裝應用程式的工作順序標識碼

• -UninstallTaskSequenceId <string> (選擇性) ：要卸載應用程式的工作順序標識碼

這兩個參數與部署類型工作順序選項有關。 它們會 -InstallCommand 取代 MSI Cmdlet 上的 和 -UninstallCommand 參數。

範例

範例 1：修改工作順序部署類型

此命令會將部署類型的名稱從 [複雜安裝 ] 變更為 [ 進階安裝]。 它會將 英文 (美國) () en-US 和 簡體中文 (簡體) () zh-CN 新增為支持的語言。 它指定安裝大約需要 14 分鐘才能完成，而且只有在沒有使用者登入 Windows 時才會執行。

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

如需需求規則和偵測方法的其他範例，請參閱 Set-CMScriptDeploymentType 和 Add-CMMsiDeploymentType。

參數

-AddDetectionClause

為此部署類型指定偵測方法子句的陣列。 若要建立偵測子句，請使用下列其中一個 Cmdlet：

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

將這些 Cmdlet 的輸出儲存到變數中。 然後將這些變數指定為此參數的陣列。 例如，-AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3。

您也可以使用 Get-CMDeploymentTypeDetectionClause 從另一個應用程式取得現有的偵測子句。

類型:	DetectionClause[]
別名:	AddDetectionClauses
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddLanguage

指定部署類型支援的語言標記陣列。 例如，若要新增 俄 (俄羅斯) ，請指定 標籤 ru-RU。

如需詳細資訊和語言標記清單，請參閱 Windows 語言代碼識別子 (LCID) 參考。

類型:	String[]
別名:	AddLanguages, Languages, Language
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AddRequirement

指定部署類型的需求物件陣列。 若要建立需求規則物件，請使用下列其中一個 Cmdlet：

• New-CMRequirementRuleActiveDirectorySiteValue
• New-CMRequirementRuleBooleanValue
• New-CMRequirementRuleCMSiteValue
• New-CMRequirementRuleCommonValue
• New-CMRequirementRuleDeviceOwnershipValue
• New-CMRequirementRuleExistential
• New-CMRequirementRuleExpression
• New-CMRequirementRuleFileAttributeValue
• New-CMRequirementRuleFilePermissionValue
• New-CMRequirementRuleFreeDiskSpaceValue
• New-CMRequirementRuleInputTypeValue
• New-CMRequirementRuleOperatingSystemLanguageValue
• New-CMRequirementRuleOperatingSystemValue
• New-CMRequirementRuleOUValue
• New-CMRequirementRuleRegistryKeyPermissionValue
• New-CMRequirementRuleScreenResolutionValue

從 2111 版開始，您可以使用 Get-CMDeploymentTypeRequirement Cmdlet 從另一個部署類型複製規則。

類型:	Rule[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Application

指定此部署類型的應用程式物件。 若要取得此物件，請使用 Get-CMApplication Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ApplicationId

指定此部署類型的應用程式識別碼。

類型:	Int32
別名:	CI_ID, CIId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ApplicationName

指定此部署類型的應用程式名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Comment

指定部署類型的選擇性描述。

類型:	String
別名:	AdministratorComment
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeploymentTypeName

指定要設定的部署類型名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DetectionClauseConnector

當您使用 GroupDetectionClauses 參數將偵測子句分組時，請使用此參數來指定連接器。

下列範例會定義 OR 連接器： @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

類型:	Hashtable[]
別名:	DetectionClauseConnectors
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EstimatedRuntimeMins

為應用程式指定此部署類型的預估安裝時間，以分鐘為單位。 軟體中心會在應用程式安裝之前，向用戶顯示此估計值。

類型:	Int32
別名:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Force

強制命令在不要求使用者確認的情況下執行。

類型:	SwitchParameter
別名:	ForceForUnknownPublisher
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceScriptDetection32Bit

如果您使用自定義腳本來偵測此部署類型是否存在，請將此參數 $true 設定為 ，以在64位用戶端上以32位進程執行腳本。

類型:	Boolean
別名:	Force32BitDetectionScript
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GroupDetectionClauses

當您設定規則來偵測此部署類型是否存在時，請使用此參數來群組子句。 若要建立偵測子句，請使用下列其中一個 Cmdlet：

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

將這些 Cmdlet 的輸出儲存到變數中。 然後使用下列格式來分組子句： $clause2.Setting.LogicalName, $clause3.Setting.LogicalName。

提示

在 Configuration Manager 控制台中，當您選取 [群組 ] 動作時，子句會在群組子句前後顯示括弧。

類型:	String[]
別名:	GroupDetectionClausesByLogicalName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定要設定的部署類型物件。 若要取得這個物件，請使用 Get-CMDeploymentType Cmdlet。

類型:	IResultObject
別名:	DeploymentType
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-InstallationBehaviorType

指定此部署類型的安裝行為：

• InstallForUser：用戶端只會為您部署應用程式的使用者安裝應用程式。
• InstallForSystem：用戶端只會安裝應用程式一次。 它可供所有使用者使用。
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser：如果您將應用程式部署到裝置，用戶端會為所有使用者安裝它。 如果您將應用程式部署至使用者，用戶端只會為該使用者安裝它。

類型:	InstallationBehaviorType
接受的值:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InstallTaskSequenceId

要安裝應用程式之工作順序的標識碼。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-LogonRequirementType

指定已登入使用者的需求：

• OnlyWhenNoUserLoggedOn：只有當沒有任何使用者登入 Windows 時。

• OnlyWhenUserLoggedOn：只有當使用者登入時。 此選項為預設值。

• WhetherOrNotUserLoggedOn：使用者是否已登入。

  注意事項

  值 WhereOrNotUserLoggedOn 已被取代。 它會由 WhetherOrNotUserLoggedOn取代。

如果您將 InstallationBehaviorType 設定為 InstallForUser，則無法設定此參數。

類型:	LogonRequirementType
接受的值:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MaximumRuntimeMins

指定此應用程式部署程式允許的運行時間上限。 以分鐘為單位設定整數值。

類型:	Int32
別名:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-NewName

指定要重新命名此部署類型的新名稱。

類型:	String
別名:	NewDeploymentTypeName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProductCode

如果應用程式使用 Windows Installer 技術，請指定要設定為偵測方法的 MSI 產品代碼。 當您使用此參數時，它會覆寫任何現有的偵測方法。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RebootBehavior

指定安裝後行為：

• BasedOnExitCode：根據傳回碼判斷行為。

• NoAction：沒有特定動作。

• ProgramReboot：軟體安裝程式可能會強制裝置重新啟動。

• ForceReboot：Configuration Manager 用戶端會強制裝置重新啟動。

如需這些行為的詳細資訊，請參閱 在 Configuration Manager 中建立應用程式。

類型:	PostExecutionBehavior
接受的值:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveDetectionClause

指定要移除的偵測方法子句數位。

類型:	String[]
別名:	RemoveDetectionClauses
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveLanguage

指定要從此部署類型移除的支持語言陣列。

類型:	String[]
別名:	RemoveLanguages
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveRequirement

指定要從此部署類型移除的需求規則陣列。

類型:	Rule[]
別名:	RemoveRequirements
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RequireUserInteraction

將此參數設定為 $true ，可讓用戶檢視部署類型安裝並與其互動。

類型:	Boolean
別名:	RequiresUserInteraction
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ScriptFile

指定要用來偵測此部署類型的腳本檔案。 也請使用 ScriptLanguage 參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ScriptLanguage

如果您使用 ScriptFile 或 ScriptText 參數，請使用此參數來指定腳本語言。

類型:	ScriptLanguage
別名:	ScriptType
接受的值:	PowerShell, VBScript, JavaScript
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ScriptText

指定要偵測此部署類型的腳本文字。 也請使用 ScriptLanguage 參數。

如需詳細資訊，請 參閱關於自定義腳本偵測方法。

類型:	String
別名:	ScriptContent, Script
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SlowNetworkDeploymentMode

當用戶端使用鄰近界限群組或預設月臺界限群組中的發佈點時，請指定部署選項：

• DoNothing：不要下載內容
• Download：從發佈點下載內容並在本機執行

類型:	ContentHandlingMode
接受的值:	DoNothing, Download
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UninstallTaskSequenceId

要卸載應用程式之工作順序的標識碼。

類型:	String
別名:	ContentLocation, UninstallId
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserInteractionMode

指定安裝程式可見度：

• Normal：部署類型會根據系統和程序預設值，以一般模式執行。 此模式為預設值。
• Minimized：部署類型會在用戶端裝置上最小化執行。 使用者可能會在通知區域或任務欄中看到安裝活動。
• Maximized：部署類型會在用戶端裝置上最大化執行。 使用者會看到所有安裝活動。
• Hidden：部署類型會在用戶端裝置上隱藏執行。 使用者看不到任何安裝活動。

類型:	UserInteractionMode
別名:	InstallationProgramVisibility
接受的值:	Normal, Minimized, Maximized, Hidden
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

相關連結

• Add-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• 工作順序部署類型