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:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 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

Укажите один или несколько объектов пакета для использования с шагом. Чтобы получить этот объект, используйте командлет Get-CMPackage .

Тип:IResultObject[]
Aliases:AddPackages
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Condition

Укажите объект условия для использования на этом шаге. Чтобы получить объект условия, используйте один из командлетов условия шага. Например, New-CMTSStepConditionQueryWMI.

Тип:IResultObject[]
Aliases:Conditions
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContinueDownload

Присвойте этому параметру значение , true чтобы продолжить загрузку других пакетов в списке в случае сбоя загрузки пакета.

Тип:Boolean
Aliases:ContinueDownloadOnError
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContinueOnError

Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите необязательное описание для этого шага последовательности задач.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DestinationVariable

Используйте этот параметр, чтобы сохранить путь к пакету в настраиваемую переменную последовательности задач.

Тип:String
Aliases:DestinationVariableName
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Disable

Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.

Тип:SwitchParameter
Aliases:DisableThisStep
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LocationOption

Укажите одно из следующих значений, где последовательность задач сохраняет пакет:

  • TaskSequenceWorkingFolder: используйте рабочий каталог последовательности задач, который также называется кэшем последовательности задач.

  • ClientCache: используйте кэш клиента Configuration Manager. По умолчанию этот путь — %WinDir%\ccmcache.

  • CustomPath: подсистема последовательности задач сначала загружает пакет в рабочий каталог последовательности задач. Затем содержимое перемещается по заданному пути. Подсистема последовательности задач добавляет путь к идентификатору пакета. При использовании этого параметра задайте путь с помощью параметра Path .

Тип:LocationType
Допустимые значения:TaskSequenceWorkingFolder, ClientCache, CustomPath
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя для этого шага, чтобы определить его в последовательности задач.

Тип:String
Aliases:StepName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

При указании -LocationOption CustomPathиспользуйте этот параметр, чтобы указать локальный путь для сохранения содержимого пакета. Подсистема последовательности задач добавляет путь к идентификатору пакета.

Тип:String
Aliases:DestinationCustomPath
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в разделе SMS_TaskSequence_DownloadPackageContentAction класс WMI сервера.