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 コマンドレットを使用して、手順をタスク シーケンスに追加します。 この手順の詳細については、「タスク シーケンスの手順: パッケージ コンテンツ のダウンロード」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 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パラメーター
手順で使用する 1 つ以上のパッケージ オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。
| Type: | IResultObject[] |
| Aliases: | AddPackages |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
この手順で使用する条件オブジェクトを指定します。 condition オブジェクトを取得するには、ステップ条件コマンドレットのいずれかを使用します。 たとえば 、New-CMTSStepConditionQueryWMI です。
| 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 |
パッケージのダウンロードに失敗した場合、リスト内の他のパッケージのダウンロードを続行するには、この true パラメーターを設定します。
| Type: | Boolean |
| Aliases: | ContinueDownloadOnError |
| 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 |
このパラメーターを使用して、パッケージのパスをカスタム タスク シーケンス変数に保存します。
| 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 |
タスク シーケンスがパッケージを保存する場所に対して、次のいずれかの値を指定します。
TaskSequenceWorkingFolder: タスク シーケンスの作業ディレクトリを使用します。これは、タスク シーケンス キャッシュとも呼ばれます。ClientCache: Configuration Manager クライアント キャッシュを使用します。 既定では、このパスは%WinDir%\ccmcache.CustomPath: タスク シーケンス エンジンは、最初にパッケージをタスク シーケンス作業ディレクトリにダウンロードします。 次に、指定したパスにコンテンツを移動します。 タスク シーケンス エンジンは、パッケージ ID を持つパスを追加します。 このオプションを使用する場合は、Path パラメーターを使用してパスを 設定 します。
| Type: | LocationType |
| Accepted values: | TaskSequenceWorkingFolder, ClientCache, CustomPath |
| 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 |
指定する場合 -LocationOption CustomPath は、このパラメーターを使用して、パッケージコンテンツを保存するローカル パスを指定します。 タスク シーケンス エンジンは、パッケージ ID を持つパスを追加します。
| Type: | String |
| Aliases: | DestinationCustomPath |
| 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 |
入力
なし
出力
IResultObject
メモ
この戻り値オブジェクトとそのプロパティの詳細については、「SMS_TaskSequence_DownloadPackageContentAction WMI クラス」を参照してください。