New-CMTSStepApplyDataImage
[データ イメージの適用] ステップ を作成し、タスク シーケンスに追加できます。
構文
New-CMTSStepApplyDataImage
[-Destination <DestinationType>]
[-DestinationDisk <Int32>]
[-DestinationDriveLetter <String>]
[-DestinationPartition <Int32>]
[-DestinationVariable <String>]
-ImagePackage <IResultObject>
-ImagePackageIndex <Int32>
[-WipePartition <Boolean>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットは、新しいデータ イメージの適用ステップ オブジェクトを 作成します。 次に 、Add-CMTaskSequenceStep コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順について:データ イメージの 適用」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1
この例では、 まず Get-CMOperatingSystemImage コマンドレットを使用して、データ イメージ パッケージのオブジェクトを取得します。 このオブジェクトは、変数 $pkgDataImgします。 次の手順では、イメージ パッケージとして****$pkgDataImgを使用して、[データ イメージの適用] ステップのオブジェクトを作成します。
次に、タスク シーケンス オブジェクトを取得し、インデックス 11 のタスク シーケンスにこの新しい手順を追加します。
$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1
$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast
$ts | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11パラメーター
この手順で使用する条件オブジェクトを指定します。 このオブジェクトを取得するには、タスク シーケンス条件コマンドレットのいずれかを使用します。 たとえば 、Get-CMTSStepConditionVariable です。
| Type: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターを追加して、エラー時にステップ オプション [続行] を有効にします。 このオプションを有効にすると、手順が失敗した場合、タスク シーケンスは続行されます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このタスク シーケンス ステップのオプションの説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このデータ イメージを適用する場所を指定します。 このパラメーターを指定しない場合、既定値は NextAvailableFormattedPartition .
NextAvailableFormattedPartition: このタスク シーケンスで、[オペレーティング システム**** の適用]**** または [データ イメージの適用] ステップによって対象とされていない次のシーケンシャル パーティションを使用します。SpecificDiskAndPartition: DestinationDisk パラメーターを使用してディスク番号を 指定し、DestinationPartition パラメーターを使用して パーティション番号を指定 します。SpecificLogicalDriverLetter: DestinationDriveLetter パラメーターを使用して、PE によってパーティションに割り当てられた論理ドライブ文字Windowsします。 このドライブ文字は、新しく展開された OS によって割り当てられたドライブ文字とは異なる場合があります。LogicalDriverLetterInVariable: DestinationVariable パラメーターを使用して、PE によってパーティションに割り当てられたドライブ文字を含むタスク シーケンス変数Windowsします。 この変数は、通常、Set-CMTSStepPartitionDiskコマンドレットまたはNew-CMTSStepPartitionDiskコマンドレットのDiskNumberVariableパラメーターを使用して、Format および Partition Diskタスク シーケンス ステップで設定されます。
| Type: | DestinationType |
| Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
使用する場合は -Destination SpecificDiskAndPartition 、このパラメーターを使用してディスク番号を指定します。 ~ の整数を指定 0 します 99 。 DestinationPartition パラメーターも使用します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
使用する場合 -Destination SpecificLogicalDriverLetter は、このパラメーターを使用して論理ドライブ文字を指定します。 からドライブ文字を指定 C します Z 。
| Type: | String |
| Aliases: | DestinationLogicalDrive |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
使用する場合は -Destination SpecificDiskAndPartition 、このパラメーターを使用してパーティション番号を指定します。 ~ の整数を指定 1 します 99 。 DestinationDisk パラメーター も使用 します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
使用する場合 -Destination LogicalDriverLetterInVariable は、このパラメーターを使用して、論理ドライブ文字でタスク シーケンス変数を指定します。 変数名は、スペースを使用せず、256 文字未満の英数字にする必要があります。
| Type: | String |
| Aliases: | DestinationVariableName |
| 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 |
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
データ イメージ パッケージ オブジェクトを指定します。 この手順では、この画像のデータを適用します。 ImagePackageIndex パラメーターを使用して、イメージ インデックスを設定します。
このオブジェクトを取得するには 、Get-CMOperatingSystemImage コマンドレットを使用 します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
イメージ インデックスの整数値を指定します。 ImagePackage パラメーターと一緒 にこのパラメーターを使用 します。
| Type: | Int32 |
| 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 |
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
この設定は既定で有効になっています。これは、イメージを適用する前にパーティション上のすべてのコンテンツを削除します。
パーティションの以前の $false 内容を削除しない場合は、このパラメーターを設定します。 このアクションを使用して、以前に対象にしたパーティションにさらに多くのコンテンツを適用できます。
| Type: | Boolean |
| Aliases: | WipePartitionBeforeApplyImage |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
なし
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_ApplyDataImageAction WMI クラス」を参照してください。