Set-CMTaskSequenceDeploymentType
在應用程式上設定任務順序部署類型。
Syntax
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 CMMsiDeploymentType。 主要差異包括下列參數:
-InstallTaskSequenceId <string>
(必要) :安裝應用程式之任務順序的識別碼-UninstallTaskSequenceId <string>
(選用) :要卸載應用程式之任務順序的識別碼
這兩個參數與「部署類型」任務順序選項有關。 它們取代 -InstallCommand
-UninstallCommand
MSI Cmdlet 上的和參數。
範例
範例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
如需具有需求規則和偵測方法的其他範例,請參閱 CMScriptDeploymentType 和 Add-CMMsiDeploymentType。
參數
-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 |
-Application
為此部署類型指定 application 物件。 若要取得此物件,請使用 CMApplication Cmdlet。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationId
指定此部署類型的應用程式識別碼。
Type: | Int32 |
Aliases: | CI_ID, CIId |
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: | Boolean |
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
指定要設定的部署類型物件。 若要取得此物件,請使用 CMDeploymentType Cmdlet。
Type: | IResultObject |
Aliases: | DeploymentType |
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 |
-NewName
指定新的名稱以重新命名此部署類型。
Type: | String |
Aliases: | NewDeploymentTypeName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設,此 Cmdlet 可能不會產生任何輸出。
Type: | SwitchParameter |
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 |
-RemoveDetectionClause
指定要移除的偵測方法子句陣列。
Type: | String[] |
Aliases: | RemoveDetectionClauses |
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: | Boolean |
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, Script |
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: | ContentLocation, UninstallId |
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
輸出
系統.物件