Condividi tramite

New-CMTSRule

  • Riferimento
Modulo:
ConfigurationManager

Creare una regola da aggiungere a un passaggio della sequenza di attività Imposta variabili dinamiche .

Sintassi

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

Descrizione

Usare questo cmdlet per creare un oggetto regola aggiunto a un passaggio della sequenza di attività Imposta variabili dinamiche . Per aggiungere regole, usare i cmdlet New-CMTSStepSetDynamicVariable o Set-CMTSStepSetDynamicVariable . Quando la sequenza di attività esegue questo passaggio, valuta le regole dinamiche e le variabili in ordine. Quando valuta le regole nel dispositivo specifico, può quindi impostare le variabili della sequenza di attività in base a tali regole.

Esistono quattro tipi di regole:

  • Computer: valutare i valori per tag di asset hardware, UUID, numero di serie o indirizzo MAC.
  • Percorso: valutare i valori per il gateway di rete predefinito.
  • Marca e modello: valuta i valori per la marca e il modello di un computer.
  • Variabile della sequenza di attività: aggiungere una variabile, una condizione e un valore della sequenza di attività da valutare.

Per altre informazioni, vedere Regole e variabili dinamiche.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Impostare la destinazione di download se in Windows PE

In questo esempio viene creata la regola seguente:

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

Aggiunge quindi questa regola a un'istanza esistente di questo passaggio in una sequenza di attività.

$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

Parametri

-AssetTag

Specificare un tag Asset per il tipo di regola Computer . Il valore massimo è 255 caratteri.

Ad esempio, se si imposta questo valore su 123456, viene aggiunta la regola seguente: IF Asset tag equals "123456" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultGateway

Specificare il gateway predefinito per il tipo di regola Percorso .

Ad esempio, se si imposta questo valore su 192.168.10.1, viene aggiunta la regola seguente: IF Default gateway equals "192.168.10.1" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MacAddress

Specificare l'indirizzo MAC per il tipo di regola Computer .

Ad esempio, se si imposta questo valore su 00:11:22:33:44:55, viene aggiunta la regola seguente: IF MAC address equals "00:11:22:33:44:55" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Make

Specificare make per il tipo di regola Make e Model . Per impostare l'altro valore, usare il parametro Model . La regola restituisce true quando entrambi i valori sono true.

È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo

Ad esempio, se si imposta questo valore su Surfacee model su*, viene aggiunta la regola seguente: IF Make equals "Surface" AND Model equals "*" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Model

Specificare il modello per il tipo di regola Make e Model . Per impostare l'altro valore, usare il parametro Make . La regola restituisce true quando entrambi i valori sono true.

È possibile usare caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo

Ad esempio, se si imposta questo valore su * e make su Surface, viene aggiunta la regola seguente: IF Make equals "Surface" AND Model equals "*" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReferencedVariableName

Specificare la variabile per il tipo di regola Variabile sequenza attività . È necessario impostare anche i parametri ReferencedVariableOperator e ReferencedVariableValue .

Questo nome di variabile può essere una variabile della sequenza di attività predefinita o una variabile personalizzata creata. Per altre informazioni, vedere Come usare le variabili della sequenza di attività in Configuration Manager.

Ad esempio, se si impostano i valori seguenti:

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

Aggiunge quindi la regola seguente: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReferencedVariableOperator

Specificare la condizione per il tipo di regola Variabile sequenza attività . È necessario impostare anche i parametri ReferencedVariableName e ReferencedVariableValue . Per gli operatori disponibili, vedere l'elenco dei valori accettati per questo parametro.

Ad esempio, se si impostano i valori seguenti:

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

Aggiunge quindi la regola seguente: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:VariableOperatorType
Valori accettati:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReferencedVariableValue

Specificare il valore per il tipo di regola Variabile della sequenza di attività . È necessario impostare anche i parametri ReferencedVariableName e ReferencedVariableOperator .

Ad esempio, se si impostano i valori seguenti:

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

Aggiunge quindi la regola seguente: IF OSDRegisteredOrgName equals "Contoso" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SerialNumber

Specificare un numero di serie per il tipo di regola Computer .

Ad esempio, se si imposta questo valore su 123456, viene aggiunta la regola seguente: IF Asset tag equals "123456" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Uuid

Specificare un UUID per il tipo di regola Computer .

Ad esempio, se si imposta questo valore su de5ba380-f692-45e0-bbd3-0e40543b549e, viene aggiunta la regola seguente: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Variable

Specificare le variabili della sequenza di attività esistenti o personalizzate e i valori associati che il passaggio deve impostare quando la regola restituisce true.

Ad esempio, se si imposta questo valore @{'OSDDownloadDestinationLocationType' = 'TSCache'}su , viene aggiunta la variabile seguente dopo l'oggetto THEN della regola: SET OSDDownloadDestinationLocationType = "TSCache"

Per specificare più variabili nella stessa tabella hash, usare un delimitatore di punti e virgola (;). Ad esempio: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Tipo:Hashtable
Alias:Variables
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject