New-CMTSRule

  • Referência
Módulo:
ConfigurationManager

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

Syntax

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

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

Há quatro tipos de regras:

  • Computador: Avalie valores para a marca de ativo de hardware, UUID, número de série ou endereço MAC.
  • Local: Avalie valores para o gateway de rede padrão.
  • Make and Model: Avalie valores para a make e o modelo de um computador.
  • Variável de sequência detarefas : Adicione uma variável, condição e valor de sequência de tarefas a ser avaliada.

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

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: definir o destino de download se Windows PE

Este exemplo cria a seguinte regra:

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

Em seguida, adiciona essa regra a uma instância existente dessa etapa em uma 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 marca Asset para o tipo de regra computador. O valor máximo é 255 caracteres.

Por exemplo, se você definir esse valor como 123456 , ele adiciona a seguinte regra: IF Asset tag equals "123456" THEN

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

-Confirm

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

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

-DefaultGateway

Especifique o gateway padrão para o tipo de regra Local.

Por exemplo, se você definir esse valor como 192.168.10.1 , ele adiciona a seguinte regra: 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

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-MacAddress

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

Por exemplo, se você definir esse valor como 00:11:22:33:44:55 , ele adiciona a seguinte regra: 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

Especifique o tipo de regra Make and Model. Para definir o outro valor, use o parâmetro Model. A regra avalia true quando ambos os valores são verdadeiros.

Você pode usar caracteres curinga:

  • *: Vários caracteres
  • ?: Caractere único

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

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

-Model

Especifique o Modelo para o tipo de regra Make and Model. Para definir o outro valor, use o parâmetro Make. A regra avalia true quando ambos os valores são verdadeiros.

Você pode usar caracteres curinga:

  • *: Vários caracteres
  • ?: Caractere único

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

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

-ReferencedVariableName

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

Esse nome de variável pode ser uma variável de sequência de tarefas ou uma variável personalizada que você criou. Para obter mais informações, consulte Como usar variáveis de sequência detarefas no Configuration Manager .

Por exemplo, se você definir os seguintes valores:

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

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

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

-ReferencedVariableOperator

Especifique a Condição do tipo de regra Variável de Sequência de Tarefas. Ele exige que você também de definir os parâmetros ReferencedVariableName e ReferencedVariableValue. Para os operadores disponíveis, consulte a lista de valores aceitos para este parâmetro.

Por exemplo, se você definir os seguintes valores:

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

Em seguida, ele adiciona a seguinte regra: 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

Especifique o valor do tipo de regra Variável de Sequência de Tarefas. Ele exige que você também de definir os parâmetros ReferencedVariableName e ReferencedVariableOperator.

Por exemplo, se você definir os seguintes valores:

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

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

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

-SerialNumber

Especifique um número de série para o tipo de regra computador.

Por exemplo, se você definir esse valor como 123456 , ele adiciona a seguinte regra: IF Asset tag equals "123456" THEN

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

-Uuid

Especifique um UUID para o tipo de regra do computador.

Por exemplo, se você definir esse valor como de5ba380-f692-45e0-bbd3-0e40543b549e , ele adiciona a seguinte regra: 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

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

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

Para especificar mais de uma variável na mesma hashtable, use um e vírgula ( ; ) delimiter. Por exemplo: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

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

-WhatIf

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

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

Entradas

Nenhum

Saídas

IResultObject