Compartilhar via

New-CMTSRule

  • Referência
Módulo:
ConfigurationManager

Crie uma regra para adicionar a um passo de sequência de tarefas Definir Variáveis Dinâmicas .

Sintaxe

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>]

Description

Utilize este cmdlet para criar um objeto de regra que adiciona a um passo de sequência de tarefas Definir Variáveis Dinâmicas . Para adicionar regras, utilize os cmdlets New-CMTSStepSetDynamicVariable ou Set-CMTSStepSetDynamicVariable . Quando a sequência de tarefas executa este passo, avalia as regras e variáveis dinâmicas por ordem. Quando avalia as regras no dispositivo específico, pode definir variáveis de sequência de tarefas com base nessas regras.

Existem quatro tipos de regras:

  • Computador: avalie os valores da etiqueta de recurso de hardware, UUID, número de série ou endereço MAC.
  • Localização: avalie os valores do gateway de rede predefinido.
  • Criar e Modelar: avalie os valores para a criação e o modelo de um computador.
  • Variável de sequência de tarefas: adicione uma variável de sequência de tarefas, condição e valor para avaliar.

Para obter mais informações, veja Regras e variáveis dinâmicas.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Definir o destino da transferência se estiver no Windows PE

Este exemplo cria a seguinte regra:

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

Em seguida, adiciona esta regra a uma instância existente deste passo numa sequência de tarefas.

$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

Parâmetros

-AssetTag

Especifique uma etiqueta Asset para o Tipo de regra de computador . O valor máximo é de 255 carateres.

Por exemplo, se definir este valor como 123456, adiciona a seguinte regra: IF Asset tag equals "123456" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultGateway

Especifique o Gateway predefinido para o tipo de regra localização .

Por exemplo, se definir este valor como 192.168.10.1, adiciona a seguinte regra: IF Default gateway equals "192.168.10.1" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MacAddress

Especifique o endereço MAC para o Tipo de regra de computador .

Por exemplo, se definir este valor como 00:11:22:33:44:55, adiciona a seguinte regra: IF MAC address equals "00:11:22:33:44:55" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Make

Especifique o tipo de regra Criar e Modelo. Para definir o outro valor, utilize o parâmetro Modelo . A regra avalia verdadeiro quando ambos os valores são verdadeiros.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único

Por exemplo, se definir este valor como Surface e o Modelo como *, adiciona a seguinte regra: IF Make equals "Surface" AND Model equals "*" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Model

Especifique o Modelo para o tipo de regra Criar e Modelo . Para definir o outro valor, utilize o parâmetro Make . A regra avalia verdadeiro quando ambos os valores são verdadeiros.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único

Por exemplo, se definir este valor como * e Make como Surface, adiciona a seguinte regra: IF Make equals "Surface" AND Model equals "*" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReferencedVariableName

Especifique a Variável para o tipo de regra Variável de Sequência de Tarefas . Requer que também defina os parâmetros ReferencedVariableOperator e ReferencedVariableValue .

Este nome de variável pode ser uma variável de sequência de tarefas incorporada ou personalizada que criou. Para obter mais informações, veja Como utilizar variáveis de sequência de tarefas no Configuration Manager.

Por exemplo, se definir os seguintes valores:

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

Em seguida, adiciona a seguinte regra: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReferencedVariableOperator

Especifique a Condição para o tipo de regra Variável de Sequência de Tarefas . Requer que também defina os parâmetros ReferencedVariableName e ReferencedVariableValue . Para os operadores disponíveis, veja a lista de valores aceites para este parâmetro.

Por exemplo, se definir os seguintes valores:

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

Em seguida, adiciona a seguinte regra: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:VariableOperatorType
Valores aceitos:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReferencedVariableValue

Especifique o Valor para o tipo de regra Variável de Sequência de Tarefas . Requer que também defina os parâmetros ReferencedVariableName e ReferencedVariableOperator .

Por exemplo, se definir os seguintes valores:

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

Em seguida, adiciona a seguinte regra: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SerialNumber

Especifique um Número de série para o tipo de regra Computador .

Por exemplo, se definir este valor como 123456, adiciona a seguinte regra: IF Asset tag equals "123456" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Uuid

Especifique um UUID para o tipo de regra Computador .

Por exemplo, se definir este valor como de5ba380-f692-45e0-bbd3-0e40543b549e, adiciona a seguinte regra: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Variable

Especifique as variáveis de sequência de tarefas existentes ou personalizadas e os valores associados que o passo deve definir quando a regra for avaliada como verdadeira.

Por exemplo, se definir este valor como @{'OSDDownloadDestinationLocationType' = 'TSCache'}, adiciona a seguinte variável após a THEN da regra: SET OSDDownloadDestinationLocationType = "TSCache"

Para especificar mais do que uma variável na mesma tabela hash, utilize um delimitador de ponto e vírgula (;). Por exemplo: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Tipo:Hashtable
Aliases:Variables
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject