New-CMTSStepRequestStateStore
建立 [ 要求狀態儲存 ] 步驟,您可以將它新增至任務順序。
Syntax
New-CMTSStepRequestStateStore
[-FallbackToAccount <Boolean>]
[-RequestOption <RequestType>]
[-RetryCount <Int32>]
[-RetryTime <Int32>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
此 Cmdlet 會建立新的 要求狀態存放區 step 物件。 然後使用 CMTaskSequenceStep Cmdlet,將步驟新增至任務順序。 如需此步驟的詳細資訊,請參閱 關於任務順序的步驟:要求狀態儲存區。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例 1
這個範例會為 要求狀態儲存 步驟建立一個物件,以取得使用者狀態並指定一般設定。
然後,它會取得任務順序物件,並將此新步驟加入至索引11的任務順序。
$step = New-CMTSStepRequestStateStore -Name "Request State Store" -RequestOption Capture -FallbackToAccount $false -RetryCount 3 -RetryTime 60
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
參數
-Confirm
執行 Cmdlet 之前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
新增此參數以啟用 [步驟] 選項 [ 在錯誤時繼續] 選項。 當您啟用此選項時,任務順序會繼續執行。
Type: | SwitchParameter |
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 |
-FallbackToAccount
當您將此值設定為時 $true
,如果任務序列無法存取使用電腦帳戶的狀態遷移點,它會使用網路存取帳號憑證進行連線。 此選項的安全性較低,因為其他電腦可能會使用網路存取帳戶來存取儲存的狀態。 若目的地電腦未加入網域,則可能需要此選項。
如需詳細資訊,請參閱 網路存取帳戶。
Type: | Boolean |
Aliases: | FallbackToNaa |
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 |
-RequestOption
指定要求存取狀態遷移點的原因:
Capture
:從電腦捕獲狀態。 如果 Configuration Manager 網站有多個作用中狀態遷移點,此步驟會找到具有可用磁碟空間的狀態遷移點。 工作順序會向管理點查詢狀態遷移點的清單,然後評估每個點,直到找到符合最低需求的專案為止。Restore
:從另一部電腦還原狀態。 如果有多個狀態遷移點,此步驟會找到具有目的地電腦狀態的狀態遷移點。
Type: | RequestType |
Accepted values: | Capture, Restore |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetryCount
指定此步驟嘗試尋找適當狀態遷移點失敗之前的次數。
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RetryTime
指定任務順序步驟在重試嘗試之間等候的時間(秒)。
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: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-名稱
指定此步驟的名稱,以在任務順序中識別。
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-條件
指定要與此步驟搭配使用的 condition 物件。 若要取得此物件,請使用其中一個工作順序條件 Cmdlet。 例如, CMTSStepConditionVariable。
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
無
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊,請參閱 SMS_TaskSequence_RequestStateStoreAction SERVER WMI 類別。