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 類別