Get-CMTSStepCaptureSystemImage
特定のタスク シーケンスから [OS イメージのキャプチャ ] ステップを取得します。
構文
Get-CMTSStepCaptureSystemImage
[-InputObject] <IResultObject>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureSystemImage
[-TaskSequenceId] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Get-CMTSStepCaptureSystemImage
[-TaskSequenceName] <String>
[-StepName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、 キャプチャ OS イメージ ステップの 1 つ以上のインスタンスのタスク シーケンス ステップ オブジェクトを取得します。 このオブジェクトを使用すると、次のことができます。
- Remove-CMTSStepCaptureSystemImage を使用してタスク シーケンスからステップを削除する
- Add-CMTaskSequenceStep を使用してステップを別のタスク シーケンスにコピーする
この手順の詳細については、「 タスク シーケンスの手順について: OS イメージをキャプチャする」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1
この例では、最初に 、$tsOsd 変数内のタスク シーケンス オブジェクトを取得します。 次に、その変数を入力オブジェクトとして渡して、 キャプチャ OS イメージ ステップを取得します。
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsStepNameCapOSImg = "Capture OS Image"
$tsStepCapOSImg = Get-CMTSStepCaptureSystemImage -InputObject $tsOsd -StepName $tsStepNameCapOSImg
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
[OS イメージのキャプチャ] ステップを取得するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。
型: | IResultObject |
Aliases: | TaskSequence |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-StepName
タスク シーケンスから取得する [キャプチャ OS イメージ] ステップの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TaskSequenceId
[キャプチャ OS イメージ] ステップを取得するタスク シーケンスのパッケージ ID を指定します。 この値は、 XYZ00858
などの標準パッケージ ID です。
型: | String |
Aliases: | Id, TaskSequencePackageId |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-TaskSequenceName
[OS イメージのキャプチャ] ステップを取得するタスク シーケンスの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object