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>] 说明
此 cmdlet 将创建新的 下载包内容 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤的详细信息，请参阅 任务序列步骤：下载包内容。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。
示例
示例 1：创建具有条件的任务序列步骤并添加到组
此示例首先设置所需参数的变量。 然后，它使用 New-CMTSStepDownloadPackageContent cmdlet 创建步骤，并将其保存为变量。 然后，它使用 Set-CMTaskSequenceGroup cmdlet 将步骤添加到特定组中的任务序列。
$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
指定要与步骤一起使用的一个或多个包对象。 若要获取此对象，请使用 Get-CMPackage cmdlet。
| 类型: | IResultObject[] |
| 别名: | AddPackages |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Condition
指定要用于此步骤的条件对象。 若要获取条件对象，请使用步骤条件 cmdlet 之一。 例如 ，New-CMTSStepConditionQueryWMI。
| 类型: | IResultObject[] |
| 别名: | Conditions |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ContinueDownload
将此参数设置为 true ，以在包下载失败时继续下载列表中的其他包。
| 类型: | Boolean |
| 别名: | ContinueDownloadOnError |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ContinueOnError
添加此参数以启用步骤选项“ 出错时继续”。 启用此选项时，如果步骤失败，任务序列将继续。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Description
为此任务序列步骤指定可选说明。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DestinationVariable
使用此参数将包的路径保存到自定义任务序列变量中。
| 类型: | String |
| 别名: | DestinationVariableName |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Disable
添加此参数以禁用此任务序列步骤。
| 类型: | SwitchParameter |
| 别名: | DisableThisStep |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-LocationOption
为任务序列保存包的位置指定以下值之一：
TaskSequenceWorkingFolder：使用任务序列工作目录，也称为任务序列缓存。ClientCache：使用 Configuration Manager 客户端缓存。 默认情况下，此路径为%WinDir%\ccmcache。CustomPath：任务序列引擎首先将包下载到任务序列工作目录。 然后，它将内容移动到指定的此路径。 任务序列引擎使用包 ID 追加路径。 使用此选项时，请使用 Path 参数设置 路径 。
| 类型: | LocationType |
| 接受的值: | TaskSequenceWorkingFolder, ClientCache, CustomPath |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定此步骤的名称，以便在任务序列中标识它。
| 类型: | String |
| 别名: | StepName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Path
指定 -LocationOption CustomPath时，使用此参数指定保存包内容的本地路径。 任务序列引擎使用包 ID 追加路径。
| 类型: | String |
| 别名: | DestinationCustomPath |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
IResultObject
备注
有关此返回对象及其属性的详细信息，请参阅 SMS_TaskSequence_DownloadPackageContentAction服务器 WMI 类。