Get-CMTSStepCaptureSystemImage

  • リファレンス
モジュール:
ConfigurationManager

特定のタスク シーケンスから [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 つ以上のインスタンスのタスク シーケンス ステップ オブジェクトを取得します。 このオブジェクトを使用すると、次のことができます。

この手順の詳細については、「 タスク シーケンスの手順について: OS イメージをキャプチャする」を参照してください。

注:

Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

[OS イメージのキャプチャ] ステップを取得するタスク シーケンス オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを使用します。

Type:IResultObject
Aliases:TaskSequence
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StepName

タスク シーケンスから取得する [キャプチャ OS イメージ] ステップの名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceId

[キャプチャ OS イメージ] ステップを取得するタスク シーケンスのパッケージ ID を指定します。 この値は、標準パッケージ ID です (例: XYZ00858)。

Type:String
Aliases:Id, TaskSequencePackageId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TaskSequenceName

[OS イメージのキャプチャ] ステップを取得するタスク シーケンスの名前を指定します。

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