Add-CMTaskSequenceDeploymentType

模組:

ConfigurationManager

建立任務序列做為應用程式模型部署類型。

Syntax

Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -AddDetectionClause <DetectionClause[]>
   -DeploymentTypeName <String>
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-GroupDetectionClauses <String[]>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationId <Int32>
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   -DeploymentTypeName <String>
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-ScriptFile <String>]
   -ScriptLanguage <ScriptLanguage>
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMTaskSequenceDeploymentType
   [-DeploymentTypeName <String>]
   [-EstimatedRuntimeMins <Int32>]
   -InputObject <IResultObject>
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RequireUserInteraction]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

適用于版本2006和更新版本。 建立任務序列做為應用程式模型部署類型。 如需詳細資訊，請參閱 任務順序部署類型。

此 Cmdlet 的語法類似于 MSI 部署類型 Cmdlet 載入 CMMsiDeploymentType。 主要差異包括下列參數：

• -InstallTaskSequenceId <string> (必要) ：安裝應用程式之任務順序的識別碼

• -UninstallTaskSequenceId <string> (選用) ：要卸載應用程式之任務順序的識別碼

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

範例

範例1：新增任務序列部署類型

此範例會將任務序列識別碼 ABC001EB 新增至應用程式 CBI。 此外，它也會新增卸載任務序列識別碼 ABC00378。

Add-CMTaskSequenceDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -Comment "New Deployment Type" -InstallTaskSequenceId "ABC001EB" -UninstallTaskSequenceId "ABC00378" -ScriptLanguage "PowerShell" -ScriptText "dir"

參數

-AddDetectionClause

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

• 新 CMDetectionClauseDirectory
• 新 CMDetectionClauseFile
• 新 CMDetectionClauseRegistryKey
• 新 CMDetectionClauseRegistryKeyValue
• 新 CMDetectionClauseWindowsInstaller

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

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

Type:	DetectionClause[]
Aliases:	AddDetectionClauses
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguage

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

如需詳細資訊以及語言標記的清單，請參閱Windows 語言代碼識別碼 (LCID) 參照。

Type:	String[]
Aliases:	AddLanguages, Languages, Language
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRequirement

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

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

從2111版開始，您可以使用 CMDeploymentTypeRequirement Cmdlet 從其他部署類型複製規則。

Type:	Rule[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

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

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Comment

為部署類型指定選用的描述。

Type:	String
Aliases:	AdministratorComment
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentTypeName

指定此部署類型的顯示名稱。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DetectionClauseConnector

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

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

Type:	Hashtable[]
Aliases:	DetectionClauseConnectors
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EstimatedRuntimeMins

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

Type:	Int32
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

強制執行命令，而不要求使用者確認。

Type:	SwitchParameter
Aliases:	ForceForUnknownPublisher
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceScriptDetection32Bit

如果您使用自訂腳本偵測此部署類型的存在，請將此參數設定為 $true 執行腳本為64位用戶端上的32位處理常式。

Type:	SwitchParameter
Aliases:	Force32BitDetectionScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-GroupDetectionClauses

當您設定規則以偵測此部署類型的目前狀態時，請使用此參數來群組子句。 若要建立偵測子句，請使用下列 Cmdlet 之一：

• 新 CMDetectionClauseDirectory
• 新 CMDetectionClauseFile
• 新 CMDetectionClauseRegistryKey
• 新 CMDetectionClauseRegistryKeyValue
• 新 CMDetectionClauseWindowsInstaller

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

提示

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

Type:	String[]
Aliases:	GroupDetectionClausesByLogicalName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

指定要設定的應用程式物件。 若要取得此物件，請使用 CMApplication Cmdlet。

Type:	IResultObject
Aliases:	Application
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallationBehaviorType

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

• InstallForUser：用戶端只會為您部署應用程式的使用者安裝應用程式。
• InstallForSystem：用戶端只會安裝一次應用程式。 所有使用者皆可使用此功能。
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser：若您將應用程式部署到裝置，用戶端會為所有使用者安裝應用程式。 若您將應用程式部署至使用者，用戶端只會為該使用者安裝該應用程式。

Type:	InstallationBehaviorType
Accepted values:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallTaskSequenceId

要安裝應用程式之任務順序的識別碼。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LogonRequirementType

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

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

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

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

  注意

  值 WhereOrNotUserLoggedOn 已被取代。 其取代者 WhetherOrNotUserLoggedOn 。

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

Type:	LogonRequirementType
Accepted values:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumRuntimeMins

指定此應用程式的部署程式允許的最大執行時間。 設定整數值，以分鐘為單位。

Type:	Int32
Aliases:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProductCode

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RebootBehavior

指定安裝後的行為：

• BasedOnExitCode：根據傳回碼決定行為。

• NoAction：沒有特定動作。

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

• ForceReboot： Configuration Manager 用戶端將強制重新開機強制裝置。

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

Type:	PostExecutionBehavior
Accepted values:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguage

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

Type:	String[]
Aliases:	RemoveLanguages
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRequirement

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

Type:	Rule[]
Aliases:	RemoveRequirements
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RequireUserInteraction

將此參數設定為 $true 以允許使用者查看部署類型安裝並與其互動。

Type:	SwitchParameter
Aliases:	RequiresUserInteraction
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptFile

指定腳本檔案，以用於偵測此部署類型。 此外，您也可以使用 ScriptLanguage 參數。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptLanguage

如果您使用 ScriptFile 或 ScriptText 參數，請使用此參數指定指令碼語言。

Type:	ScriptLanguage
Aliases:	ScriptType
Accepted values:	PowerShell, VBScript, JavaScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptText

指定腳本的文字，以偵測此部署類型。 此外，您也可以使用 ScriptLanguage 參數。

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

Type:	String
Aliases:	ScriptContent
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SlowNetworkDeploymentMode

當用戶端使用鄰居邊界群組或預設網站邊界群組中的發行點時，請指定部署選項：

• DoNothing：請勿下載內容
• Download：從發佈點下載內容，並在本機執行

Type:	ContentHandlingMode
Accepted values:	DoNothing, Download
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UninstallTaskSequenceId

要卸載應用程式之任務順序的識別碼。

Type:	String
Aliases:	UninstallId, UninstallTaskSequencePackageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserInteractionMode

指定安裝程式可見度：

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

Type:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

ConfigurationManagement IResultObject

輸出

系統.物件

相關連結

• CMTaskSequenceDeploymentType
• CMDeploymentType
• Remove-CMDeploymentType
• CMApplication
• 任務順序部署類型