New-CMTSStepDownloadPackageContent
タスク シーケンスに追加できるパッケージ コンテンツのダウンロード ステップを作成します。
構文
New-CMTSStepDownloadPackageContent
-AddPackage <IResultObject[]>
[-ContinueDownload <Boolean>]
[-DestinationVariable <String>]
[-LocationOption <LocationType>]
[-Path <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットは、新しい パッケージ コンテンツのダウンロード ステップ オブジェクトを作成します。 次に、 Add-CMTaskSequenceStep コマンドレットを使用して、タスク シーケンスにステップを追加します。 この手順の詳細については、「 タスク シーケンスの手順: パッケージ コンテンツのダウンロード」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 条件を使用してタスク シーケンス ステップを作成し、グループに追加する
次の使用例は、最初に必要なパラメーターの変数を設定します。 次に、 New-CMTSStepDownloadPackageContent コマンドレットを使用してステップを作成し、それを変数として保存します。 次に、 Set-CMTaskSequenceGroup コマンドレットを使用して、特定のグループのタスク シーケンスにステップを追加します。
$TaskSequenceName = "Module - Download Driver Packages"
$Model = "Latitude E7470"
$GroupName = "Dell Drivers"
$ContentPackage = Get-CMPackage -Fast -Name "Driver Dell Latitude E7470"
$StepName = $ContentPackage.Name
$ConditionQuery = "Select * From Win32_ComputerSystem Where Model = `"$Model`""
$StepCondition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $ConditionQuery
$PackageStep = New-CMTSStepDownloadPackageContent -AddPackage $ContentPackage -Name $StepName -LocationOption TaskSequenceWorkingFolder -DestinationVariable "DRIVERS" -Condition $StepCondition
Set-CMTaskSequenceGroup -TaskSequenceName $TaskSequenceName -StepName $GroupName -AddStep $PackageStep -InsertStepStartIndex 1パラメーター
-AddPackage
ステップで使用する 1 つ以上のパッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMPackage コマンドレットを使用します。
| 型: | IResultObject[] |
| Aliases: | AddPackages |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Condition
この手順で使用する条件オブジェクトを指定します。 条件オブジェクトを取得するには、ステップ条件コマンドレットのいずれかを使用します。 たとえば、 New-CMTSStepConditionQueryWMI です。
| 型: | IResultObject[] |
| Aliases: | Conditions |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContinueDownload
パッケージのダウンロードが失敗した場合にリスト内の他のパッケージのダウンロードを続行するには、このパラメーターを true に設定します。
| 型: | Boolean |
| Aliases: | ContinueDownloadOnError |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContinueOnError
このパラメーターを追加して、ステップ オプション [ エラー時に続行] を有効にします。 このオプションを有効にすると、ステップが失敗した場合、タスク シーケンスは続行されます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
このタスク シーケンス ステップの説明 (省略可能) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DestinationVariable
パッケージのパスをカスタム タスク シーケンス変数に保存するには、このパラメーターを使用します。
| 型: | String |
| Aliases: | DestinationVariableName |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Disable
このタスク シーケンス ステップを無効にするには、このパラメーターを追加します。
| 型: | SwitchParameter |
| Aliases: | DisableThisStep |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LocationOption
タスク シーケンスによってパッケージが保存される場所に対して、次のいずれかの値を指定します。
TaskSequenceWorkingFolder: タスク シーケンスの作業ディレクトリ (タスク シーケンス キャッシュとも呼ばれます) を使用します。ClientCache: Configuration Manager クライアント キャッシュを使用します。 既定では、このパスは%WinDir%\ccmcacheです。CustomPath: タスク シーケンス エンジンは、最初にパッケージをタスク シーケンス作業ディレクトリにダウンロードします。 その後、指定したこのパスにコンテンツが移動されます。 タスク シーケンス エンジンは、パッケージ ID を使用してパスを追加します。 このオプションを使用する場合は、 Path パラメーターを使用してパスを設定します。
| 型: | LocationType |
| 指定可能な値: | TaskSequenceWorkingFolder, ClientCache, CustomPath |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
この手順の名前を指定して、タスク シーケンスで識別します。
| 型: | String |
| Aliases: | StepName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Path
-LocationOption CustomPathを指定する場合は、このパラメーターを使用して、パッケージの内容を保存するローカル パスを指定します。 タスク シーケンス エンジンは、パッケージ ID を使用してパスを追加します。
| 型: | String |
| Aliases: | DestinationCustomPath |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_TaskSequence_DownloadPackageContentAction」を参照してください。