New-CMTSStepSetVariable
Создайте шаг Задать переменную последовательности задач , который можно добавить в последовательность задач.
Синтаксис
New-CMTSStepSetVariable
[-IsMasked <Boolean>]
-TaskSequenceVariable <String>
[-TaskSequenceVariableValue <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Этот командлет создает новый объект шага Set Task Sequence Variable . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: задание переменной последовательности задач.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1
В этом примере сначала создается объект для шага Задать переменную последовательности задач , чтобы задать для встроенной переменной OSDSetupAdditionalUpgradeOptions значение /ReflectDrivers.
Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.
$step = New-CMTSStepSetVariable -Name "Set Task Sequence Variable" -TaskSequenceVariable "OSDSetupAdditionalUpgradeOptions" -TaskSequenceVariableValue "/ReflectDrivers"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11Параметры
-Condition
Укажите объект условия для использования на этом шаге. Чтобы получить этот объект, используйте один из командлетов условия последовательности задач. Например, Get-CMTSStepConditionVariable.
| Тип: | IResultObject[] |
| Aliases: | Conditions |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Тип: | SwitchParameter |
| Aliases: | cf |
| 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 |
-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 |
-IsMasked
Задайте для этого параметра значение , $true чтобы маскировать конфиденциальные данные, хранящиеся в переменных последовательности задач. Например, при указании пароля.
| Тип: | Boolean |
| Aliases: | IsHidden, IsMask |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Укажите имя для этого шага, чтобы определить его в последовательности задач.
| Тип: | String |
| Aliases: | StepName |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TaskSequenceVariable
Укажите имя встроенной последовательности задач или переменной действия или укажите собственное имя определяемой пользователем переменной. Дополнительные сведения см . в статье Использование переменных последовательности задач в Configuration Manager и справочник по переменным последовательности задач.
Используйте параметр TaskSequenceVariableValue , чтобы задать значение.
| Тип: | String |
| Aliases: | VariableName |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TaskSequenceVariableValue
Последовательность задач задает это значение в поле TaskSequenceVariable . Задайте для этой переменной последовательности задач значение другой переменной последовательности задач с синтаксисом %varname%.
| Тип: | String |
| Aliases: | VariableValue |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе класс WMI сервера SMS_TaskSequence_SetVariableAction.