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 сервера.