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>] 説明
このコマンドレットは、新しい Apply Data Image ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順について: データ イメージを適用する」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 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パラメーター
-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 |
-Destination
このデータ イメージを適用する場所を指定します。 このパラメーターを指定しない場合、既定値は です NextAvailableFormattedPartition。
NextAvailableFormattedPartition: このタスク シーケンスの [オペレーティング システムの適用] または [データ イメージの適用] ステップで、まだ対象とされていない次のシーケンシャル パーティションを使用します。SpecificDiskAndPartition: DestinationDisk パラメーターを使用してディスク番号を指定し、 DestinationPartition パラメーターを使用してパーティション番号を指定します。SpecificLogicalDriverLetter: DestinationDriveLetter パラメーターを使用して、Windows PE によってパーティションに割り当てられた論理ドライブ文字を指定します。 このドライブ文字は、新しくデプロイされた OS によって割り当てられたドライブ文字とは異なる場合があります。LogicalDriverLetterInVariable: DestinationVariable パラメーターを使用して、Windows PE によってパーティションに割り当てられたドライブ文字を含むタスク シーケンス変数を指定します。 この変数は、通常、Set-CMTSStepPartitionDisk または New-CMTSStepPartitionDisk コマンドレットの DiskNumberVariable パラメーターを使用して、フォーマットおよびパーティション ディスクタスク シーケンス ステップに設定されます。
| Type: | DestinationType |
| Accepted values: | NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationDisk
を使用 -Destination SpecificDiskAndPartitionする場合は、このパラメーターを使用してディスク番号を指定します。 から 0 への整数を指定します 99。 DestinationPartition パラメーターも使用します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationDriveLetter
を使用 -Destination SpecificLogicalDriverLetterする場合は、このパラメーターを使用して論理ドライブ文字を指定します。 から C へのドライブ文字を指定します Z。
| Type: | String |
| Aliases: | DestinationLogicalDrive |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationPartition
を使用 -Destination SpecificDiskAndPartitionする場合は、このパラメーターを使用してパーティション番号を指定します。 から 1 への整数を指定します 99。 DestinationDisk パラメーターも使用します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DestinationVariable
を使用 -Destination LogicalDriverLetterInVariableする場合は、このパラメーターを使用して、論理ドライブ文字を使用してタスク シーケンス変数を指定します。 変数名は、スペースを含まず、256 文字未満の英数字にする必要があります。
| Type: | String |
| Aliases: | DestinationVariableName |
| 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 |
-ImagePackage
データ イメージ パッケージ オブジェクトを指定します。 この手順では、このイメージのデータを適用します。 ImagePackageIndex パラメーターを使用して、イメージ インデックスを設定します。
このオブジェクトを取得するには、 Get-CMOperatingSystemImage コマンドレットを 使用します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ImagePackageIndex
イメージ インデックスの整数値を指定します。 ImagePackage パラメーターでこのパラメーターを使用します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WipePartition
この設定は既定で有効になっています。これにより、イメージを適用する前にパーティション上のすべてのコンテンツが削除されます。
パーティションの以前の内容を削除しないようにするには、このパラメーター $false を に設定します。 このアクションを使用すると、以前にターゲットを設定したパーティションにさらに多くのコンテンツを適用できます。
| Type: | Boolean |
| Aliases: | WipePartitionBeforeApplyImage |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_ApplyDataImageAction」を参照してください。
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示