New-CMTSRule
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