New-CMTSStepDownloadPackageContent

  • リファレンス
モジュール:
ConfigurationManager

タスク シーケンスに追加できるパッケージ コンテンツのダウンロード ステップを作成します。

構文

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:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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 コマンドレットを使用します。

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

-Condition

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

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

-ContinueDownload

パッケージのダウンロードが失敗した場合に、リスト内の他のパッケージのダウンロードを続行するには、このパラメーターを に true 設定します。

Type:Boolean
Aliases:ContinueDownloadOnError
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

-DestinationVariable

パッケージのパスをカスタム タスク シーケンス変数に保存するには、このパラメーターを使用します。

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

-LocationOption

タスク シーケンスによってパッケージが保存される場所に対して、次のいずれかの値を指定します。

  • TaskSequenceWorkingFolder: タスク シーケンスの作業ディレクトリ (タスク シーケンス キャッシュとも呼ばれます) を使用します。

  • ClientCache: Configuration Manager クライアント キャッシュを使用します。 既定では、このパスは です %WinDir%\ccmcache。

  • CustomPath: タスク シーケンス エンジンは、最初にパッケージをタスク シーケンス作業ディレクトリにダウンロードします。 次に、指定したパスにコンテンツを移動します。 タスク シーケンス エンジンは、パッケージ ID を使用してパスを追加します。 このオプションを使用する場合は、 Path パラメーターを使用してパスを設定します。

Type:LocationType
Accepted values:TaskSequenceWorkingFolder, ClientCache, CustomPath
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

-Path

を指定 -LocationOption CustomPathする場合は、このパラメーターを使用して、パッケージの内容を保存するローカル パスを指定します。 タスク シーケンス エンジンは、パッケージ ID を使用してパスを追加します。

Type:String
Aliases:DestinationCustomPath
Position:Named
Default value:None
Required:False
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_DownloadPackageContentAction」を参照してください。