New-CMTSStepCaptureSystemImage

モジュール:

ConfigurationManager

タスク シーケンスに追加できる キャプチャ OS イメージ ステップを作成します。

構文

New-CMTSStepCaptureSystemImage
   [-ImageCreator <String>]
   [-ImageDescription <String>]
   [-ImageVersion <String>]
   [-Password <SecureString>]
   -Path <String>
   -UserName <String>
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは、新しい Capture OS Image ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: OS イメージをキャプチャする」を参照してください。

注:

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

例

例 1

この例では、最初に ConvertTo-SecureString 組み込みコマンドレットを使用して、ユーザー パスワードのセキュリティで保護された文字列を作成します。 このメソッドはここで簡単な例として使用されますが、プレーン テキスト パスワードがスクリプト内にあるため、最も安全ではありません。 このコマンドレットとその他のオプションの詳細については、「 ConvertTo-SecureString」を参照してください。

次の行では、セキュリティで保護された文字列パスワード変数を使用して、 キャプチャ OS イメージ ステップのオブジェクトを作成します。

次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しいステップを追加します。

$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force

$step = New-CMTSStepCaptureSystemImage -Name "Capture OS Image" -Path "\\server\share$\images\image.wim" -UserName "contoso\_osdcapture" -Password $Secure_String_Pwd -ImageCreator "Meaghan C" -ImageDescription "The Virginia moon image" -ImageVersion "1.3b"

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

パラメーター

-Condition

この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば、 Get-CMTSStepConditionVariable です。

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

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

-ContinueOnError

このパラメーターを追加して、ステップ オプション [ エラー時に続行] を有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。

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

-Description

このタスク シーケンス ステップの説明 (省略可能) を指定します。

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

-Disable

このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-ImageCreator

OS イメージを作成したユーザーの名前を指定します。 この文字列はイメージ ファイルに格納されます。

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

-ImageDescription

キャプチャした OS イメージの説明を指定します。 この文字列はイメージ ファイルに格納されます。

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

-ImageVersion

キャプチャした OS イメージに割り当てるバージョン番号を指定します。 この値は、文字と数字の任意の組み合わせにすることができます。 イメージ ファイルに格納されます。

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

-Name

この手順の名前を指定して、タスク シーケンスで識別します。

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

-Password

ネットワーク共有へのアクセス許可を持つ UserName のパスワードを指定します。

Type:	SecureString
Aliases:	CapturePassword
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

キャプチャした OS イメージを格納するときに使用Configuration Manager場所へのネットワーク パスを指定します。

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

-UserName

パスの場所に書き込むアクセス許可を持つアカウントのユーザー名を指定します。 Password パラメーターも使用します。

このアカウントの詳細については、「 キャプチャ OS イメージ アカウント」を参照してください。

Type:	String
Aliases:	CaptureUserName
Position:	Named
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

入力

None

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_CaptureSystemImageAction」を参照してください。

関連リンク

• Get-CMTSStepCaptureSystemImage
• Remove-CMTSStepCaptureSystemImage
• Set-CMTSStepCaptureSystemImage
• タスク シーケンスの手順について: OS イメージをキャプチャする