New-CMTSRule

  • Ссылка
Модуль:
ConfigurationManager

Создайте правило для добавления на шаг последовательности задач Set Dynamic Variables .

Синтаксис

New-CMTSRule
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-AssetTag <String>]
   [-MacAddress <String>]
   [-SerialNumber <String>]
   [-Uuid <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-DefaultGateway <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-Make <String>]
   [-Model <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-ReferencedVariableName <String>]
   [-ReferencedVariableOperator <VariableOperatorType>]
   [-ReferencedVariableValue <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет, чтобы создать объект правила, добавляемый на шаг последовательности задач Set Dynamic Variables . Чтобы добавить правила, используйте командлеты New-CMTSStepSetDynamicVariable или Set-CMTSStepSetDynamicVariable . Когда последовательность задач выполняет этот шаг, она оценивает динамические правила и переменные по порядку. При оценке правил на конкретном устройстве он может задать переменные последовательности задач на основе этих правил.

Существует четыре типа правил:

  • Компьютер: оцените значения тега аппаратного ресурса, UUID, серийного номера или MAC-адреса.
  • Расположение: оцените значения для сетевого шлюза по умолчанию.
  • Сделать и модель. Оцените значения для модели и модели компьютера.
  • Переменная последовательности задач. Добавьте переменную последовательности задач, условие и значение для оценки.

Дополнительные сведения см. в разделе Динамические правила и переменные.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Установка назначения для скачивания в Среде предустановки Windows

В этом примере создается следующее правило:

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

Затем это правило добавляется к существующему экземпляру этого шага в последовательности задач.

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

Параметры

-AssetTag

Укажите тег Ресурса для типа правила компьютера . Максимальное значение — 255 символов.

Например, если присвоить этому значению 123456значение , будет добавлено следующее правило: IF Asset tag equals "123456" THEN

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

-Confirm

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

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

-DefaultGateway

Укажите шлюз по умолчанию для типа правила расположения .

Например, если присвоить этому значению 192.168.10.1значение , будет добавлено следующее правило: IF Default gateway equals "192.168.10.1" THEN

Тип:String
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

-MacAddress

Укажите MAC-адрес для типа правила компьютера .

Например, если присвоить этому значению 00:11:22:33:44:55значение , будет добавлено следующее правило: IF MAC address equals "00:11:22:33:44:55" THEN

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

-Make

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

Можно использовать подстановочные знаки:

  • *: несколько символов
  • ?: один символ

Например, если для этого значения задано значение Surface , а для параметра Model — *значение , будет добавлено следующее правило: IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

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

Можно использовать подстановочные знаки:

  • *: несколько символов
  • ?: один символ

Например, если для этого значения задано значение * , а для параметра MakeSurface— значение , будет добавлено следующее правило: IF Make equals "Surface" AND Model equals "*" THEN

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

-ReferencedVariableName

Укажите переменную для типа правила переменной последовательности задач . Необходимо также задать параметры ReferencedVariableOperator и ReferencedVariableValue .

Это может быть встроенная переменная последовательности задач или созданная вами пользовательская переменная. Дополнительные сведения см . в разделе Использование переменных последовательности задач в Configuration Manager.

Например, если заданы следующие значения:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Затем добавляется следующее правило: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

Укажите условие для типа правила переменной последовательности задач . Необходимо также задать параметры ReferencedVariableName и ReferencedVariableValue . Доступные операторы см. в списке допустимых значений для этого параметра.

Например, если заданы следующие значения:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Затем добавляется следующее правило: IF OSDRegisteredOrgName equals "Contoso" THEN

Тип:VariableOperatorType
Допустимые значения:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReferencedVariableValue

Укажите значение для типа правила переменной последовательности задач . Необходимо также задать параметры ReferencedVariableName и ReferencedVariableOperator .

Например, если заданы следующие значения:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

Затем добавляется следующее правило: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

Укажите серийный номер для типа правила компьютера .

Например, если присвоить этому значению 123456значение , будет добавлено следующее правило: IF Asset tag equals "123456" THEN

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

-Uuid

Укажите UUID для типа правила компьютера .

Например, если присвоить этому значению de5ba380-f692-45e0-bbd3-0e40543b549eзначение , будет добавлено следующее правило: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

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

-Variable

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

Например, если присвоить этому значению @{'OSDDownloadDestinationLocationType' = 'TSCache'}значение , после правила будет добавлена THEN следующая переменная: SET OSDDownloadDestinationLocationType = "TSCache"

Чтобы указать несколько переменных в одной хэш-таблицы, используйте разделитель с запятой (;). Пример: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

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

-WhatIf

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

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

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

None

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

IResultObject