Share via

New-CMTSRule

  • Artigo

SINOPSE

Crie uma regra para adicionar a um passo de sequência de tarefas de Variações Dinâmicas definidas.

SINTAXE

Variável Apenas (Padrão)

New-CMTSRule -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Condição Informática

New-CMTSRule [-AssetTag <String>] [-MacAddress <String>] [-SerialNumber <String>] [-Uuid <String>]
 -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

LocalizaçãoCondição

New-CMTSRule [-DefaultGateway <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

MakeModelCondição

New-CMTSRule [-Make <String>] [-Model <String>] -Variable <Hashtable> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

Condição variável

New-CMTSRule [-ReferencedVariableName <String>] [-ReferencedVariableOperator <VariableOperatorType>]
 [-ReferencedVariableValue <String>] -Variable <Hashtable> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIÇÃO

Utilize este cmdlet para criar uma regra que pode adicionar a um passo de sequência de sequência de variáveis dinâmicas definidas. Quando a sequência de tarefas executa este passo, avalia as regras dinâmicas e variáveis em ordem. Quando avalia as regras do dispositivo específico, pode então definir variáveis de sequência de tarefa com base nessas regras.

Existem quatro tipos de regras:

  • Computador: Avalie os valores para a etiqueta de ativos de hardware, UUID, número de série ou endereço MAC.
  • Localização: Avaliar os valores para o portal de rede padrão.
  • Fazer e Modelar: Avaliar valores para a 2.da e modelo de um computador.
  • Variável da sequência de tarefas : Adicione uma variável, condição e valor da sequência de tarefas para avaliar.

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

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXEMPLOS

Exemplo 1: Definir o destino de descarregamento se em 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 de ativo para o tipo de regra de computador. O valor máximo é de 255 caracteres.

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

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DefaultGateway

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

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

Type: String
Parameter Sets: LocationCondition
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-MacAddress

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

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

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Fazer

Especifique o tipo de regra Make for the Make and Model. Para definir o outro valor, utilize o parâmetro Modelo. A regra avalia a verdade quando ambos os valores são verdadeiros.

Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única

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

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-Modelo

Especificar o modelo para o tipo de regra de fazer e modelo. Para definir o outro valor, utilize o parâmetro Fazer. A regra avalia a verdade quando ambos os valores são verdadeiros.

Pode utilizar caracteres wildcard:

  • *: Vários caracteres
  • ?: Personagem única

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

Type: String
Parameter Sets: MakeModelCondition
Aliases:

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

-Nome Variavel de Referência

Especificar a Variável para o tipo de regra variável de sequência de tarefa. Requer que também desemboe os parâmetros ReferencedVariableOperator e ReferencedVariableValue.

Este nome variável pode ser uma variável de sequência de tarefa incorporada ou uma variável personalizada que criou. Para obter mais informações, consulte Como utilizar variáveis de sequência de tarefas no Gestor de Configuração.

Por exemplo, se definir os seguintes valores:

  • Nome de referência Variaable:OSDRegisteredOrgName
  • Operador Variavel de Referência:Equals
  • ReferênciaVariableValue: Contoso

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

Type: String
Parameter Sets: VariableCondition
Aliases:

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

-OperadorVariável referenciado

Especificar a condição para o tipo de regra variável de sequência de tarefa. Requer que também desista dos parâmetros ReferencedVariableName e ReferencedVariableValue. Para os operadores disponíveis, consulte a lista de valores aceites para este parâmetro.

Por exemplo, se definir os seguintes valores:

  • Nome de referência Variaable:OSDRegisteredOrgName
  • Operador Variavel de Referência:Equals
  • ReferênciaVariableValue: Contoso

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

Type: VariableOperatorType
Parameter Sets: VariableCondition
Aliases:
Accepted values: Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike

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

-ReferênciaVariableValue

Especifique o valor para o tipo de regra variável de sequência de tarefa. Requer que também desconte os parâmetros ReferencedVariableName e ReferencedVariableOperator.

Por exemplo, se definir os seguintes valores:

  • Nome de referência Variaable:OSDRegisteredOrgName
  • Operador Variavel de Referência:Equals
  • ReferênciaVariableValue: Contoso

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

Type: String
Parameter Sets: VariableCondition
Aliases:

Required: False
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 de computador.

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

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Uuid

Especifique um UUID para o tipo de regra de computador.

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

Type: String
Parameter Sets: ComputerCondition
Aliases:

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

-Variável

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

Por exemplo, se definir este valor @{'OSDDownloadDestinationLocationType' = 'TSCache'} para, adiciona a seguinte variável após THEN a 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'}

Type: Hashtable
Parameter Sets: (All)
Aliases: Variables

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

ENTRADAS

Nenhuma

SAÍDAS

IResultObject#SMS_TaskSequence_Rule

NOTAS

LIGAÇÕES RELACIONADAS

Set-CMTSStepSetDynamicVariable

Novo CMTSStepSetDynamicVariable

Sobre etapas de sequência de tarefas - Definir Variáveis Dinâmicas

Como utilizar variáveis de sequência de tarefas no Gestor de Configuração