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-адреса.
• Расположение. Оценка значений для сетевого шлюза по умолчанию.
• Make and Model: Оценка значений для модели и модели компьютера.
• Переменная последовательностизадач. Добавьте переменную последовательности задач, условие и значение для оценки.

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

Примечание

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

Примеры

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

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

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

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultGateway

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MacAddress

Укажите mac-адрес для типа правила Computer.

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Make

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

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

• *: Несколько символов
• ?: Одиночный символ

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Model

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

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

• *: Несколько символов
• ?: Одиночный символ

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferencedVariableName

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

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

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

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferencedVariableOperator

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

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

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

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

Type:	VariableOperatorType
Accepted values:	Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferencedVariableValue

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

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

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SerialNumber

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Uuid

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

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

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

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

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

Type:	Hashtable
Aliases:	Variables
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

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

Нет

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

IResultObject

Связанные ссылки

• Set-CMTSStepSetDynamicVariable
• New-CMTSStepSetDynamicVariable
• О действиях последовательности задач - Установите динамические переменные
• Использование переменных последовательности задач в диспетчере конфигурации