New-CMTaskSequenceAutoPhasedDeployment
使用此 Cmdlet,透過產生具有相同設定的兩個階段,來建立任務順序的階段性部署。
Syntax
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequence] <IResultObject>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceId] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceName] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet,透過產生具有相同設定的兩個階段,來建立任務順序的階段性部署。 當您選取自動建立預設兩階段部署的選項時,此指令程式的行為與在任務順序建立階段性部署嚮導相同。
注意
在您建立分階段的部署之前,請確定將任務順序內容發佈到發佈點。
範例
範例1:依任務順序名稱建立部署
此範例會為任務序列myTaskSequenceName建立名為myDPName的新任務序列逐步部署。
New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
範例2:依輸入任務順序物件建立部署
在這個範例中,會為管道任務 sequence 物件的名為 myPDName 的新任務序列逐步部署建立。
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
參數
-AddPhases
這個 Cmdlet 會自動為指定的兩個集合建立兩個階段。 您也可以使用此參數來新增更多階段。 指定階段的陣列。 使用 CMTaskSequencePhase 來建立階段。
Type: | Phase[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BeginCondition
指定在第一個階段成功後開始第二階段部署的選項:
AfterPeriod
:此參數與下列設定相同:在主控台中建立分階段部署嚮導的 [設定] 頁面上,[**自動于此階段開始]。延遲期間 (天數) **。 如果您指定此值,請使用 DaysAfterPreviousPhaseSuccess 來設定時間週期。Manually
:此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:手動開始第二階段部署。
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
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 |
-CriteriaOption
指定選項,以選擇第一個階段成功的準則:
Compliance
:此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:部署成功百分比。 使用 CriteriaValue 參數指定百分比值。Number
:此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:已成功部署的裝置數目。 使用 CriteriaValue 參數指定裝置的數目。
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
這個整數值取決於您為 CriteriaOption指定的值:
Compliance
:指定百分比Number
:指定裝置數目
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
指定第一個階段成功之後第二個階段開始的天數的整數值。 此參數與下列設定相同:在主控台中建立分階段部署嚮導的 [設定] 頁面上,自動在延遲期間 (天數) 中開始此階段。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
指定期限期限的類型。 請將此參數與 DeadlineValue搭配使用。
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
只有在您 AfterPeriod
使用 InstallationChoice 參數指定時,才會使用此參數。
為期限指定時間週期的整數值。 使用 DeadlineUnit 參數可指定週期類型: Hours
,, Days
Weeks
, Months
。 此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:這段時間後需要安裝。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
指定任務序列階段性部署的描述。
Type: | String |
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 |
-FirstCollection
指定第一個階段的集合物件。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
指定第一個階段的集合識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
指定第一個階段的集合名稱。
Type: | String |
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 |
-InsertAtOrder
如果您使用 AddPhases 參數,請使用此參數來決定要插入其他階段的階段順序。 使用訂單編號指定整數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
指定當軟體可用時,其行為的選項:
AsSoonAsPossible
:此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:您必須儘快安裝。AfterPeriod
:此參數與下列設定相同:在主控台中建立分段部署嚮導的 [設定] 頁面上:這段時間後需要安裝。 如果您指定此值,請使用 DeadlineUnit 和 DeadlineValue 來設定時間週期。
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
指定第二個階段的集合物件。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
指定第二個階段的集合識別碼。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
指定第二個階段的集合名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequence
指定任務順序物件。
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TaskSequenceId
依識別碼指定任務順序。
Type: | String |
Aliases: | TaskSequencePackageId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceName
依名稱指定任務順序。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThrottlingDays
指定此軟體可供使用的天數的整數值。 這個參數與下列設定相同:在主控台中建立分階段部署嚮導的 [設定] 頁面上,逐步使此軟體可供在此期間內 () 天內。
Type: | Int32 |
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 |
-名稱
指定任務序列階段性部署的名稱。
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
IResultObject