Get-CMTSStepCaptureUserState
特定のタスク シーケンスから [ユーザー状態のキャプチャ] ステップを取得します。
構文
Get-CMTSStepCaptureUserState
[-InputObject] <IResultObject>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureUserState
[-TaskSequenceId] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureUserState
[-TaskSequenceName] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、 ユーザー状態のキャプチャ ステップの 1 つ以上のインスタンスのタスク シーケンス ステップ オブジェクトを取得します。 このオブジェクトを使用すると、次のことができます。
- Remove-CMTSStepCaptureUserState を使用してタスク シーケンスからステップを削除する
- Add-CMTaskSequenceStep を使用してステップを別のタスク シーケンスにコピーする
この手順の詳細については、「 タスク シーケンスの手順について: ユーザーの状態をキャプチャする」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>
)。 詳細については、「作業の 開始」を参照してください。
例
例 1
この例では、最初に 、$tsOsd 変数内のタスク シーケンス オブジェクトを取得します。 次に、その変数を入力オブジェクトとして渡して、[ ユーザー状態のキャプチャ ] ステップを取得します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameCapState = "Capture User State"
$tsStepCapState = Get-CMTSStepCaptureUserState -InputObject $tsOsd -StepName $tsStepNameCapState
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
[ユーザー状態のキャプチャ] ステップを取得するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。
Type: | IResultObject |
Aliases: | TaskSequence |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StepName
タスク シーケンスから取得する [ユーザー状態のキャプチャ ] ステップの名前を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceId
[ユーザー状態のキャプチャ] ステップを取得するタスク シーケンスのパッケージ ID を指定します。 この値は、標準パッケージ ID です (例: XYZ00858
)。
Type: | String |
Aliases: | Id, TaskSequencePackageId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceName
[ユーザー状態のキャプチャ] ステップを取得するタスク シーケンスの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object
関連リンク
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示