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

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

Esistono quattro tipi di regole:

  • Computer: valutare i valori per tag dell'asset hardware, UUID, numero di serie o indirizzo MAC.
  • Percorso: valutare i valori per il gateway di rete predefinito.
  • Make and Model: valutare i valori per la crea 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 ulteriori 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 ulteriori 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"

Questa regola viene quindi aggiunta 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.

Se ad esempio si imposta questo valore su 123456 , verrà aggiunta la regola seguente: IF Asset tag equals "123456" THEN

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DefaultGateway

Specificare il gateway predefinito per il tipo di regola Percorso.

Se ad esempio si imposta questo valore su 192.168.10.1 , verrà aggiunta la regola seguente: 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

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

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

-ForceWildcardHandling

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

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

-MacAddress

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

Se ad esempio si imposta questo valore su 00:11:22:33:44:55 , verrà aggiunta la regola seguente: 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

Specificare la proprietà Crea per il tipo di regola Crea e modello. Per impostare l'altro valore, utilizzare il parametro Model. La regola valuta true quando entrambi i valori sono true.

È possibile utilizzare i caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo

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

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

-Model

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

È possibile utilizzare i caratteri jolly:

  • *: più caratteri
  • ?: carattere singolo

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

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

-ReferencedVariableName

Specificare variable per il tipo di regola Task Sequence Variable. Richiede inoltre di impostare i parametri ReferencedVariableOperator e ReferencedVariableValue.

Questo nome di variabile può essere una variabile predefinita della sequenza di attività o una variabile personalizzata creata. Per ulteriori 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

Viene quindi aggiunta la regola seguente: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

Specificare la condizione per il tipo di regola Variabile sequenza di attività. Richiede inoltre di impostare 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

Viene quindi aggiunta la regola seguente: 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

Specificare il valore per il tipo di regola Variabile sequenza di attività. Richiede inoltre di impostare i parametri ReferencedVariableName e ReferencedVariableOperator.

Ad esempio, se si impostano i valori seguenti:

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

Viene quindi aggiunta la regola seguente: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

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

Se ad esempio si imposta questo valore su 123456 , verrà aggiunta la regola seguente: IF Asset tag equals "123456" THEN

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

-Uuid

Specificare un UUID per il tipo di regola Computer.

Se ad esempio si imposta questo valore su de5ba380-f692-45e0-bbd3-0e40543b549e , verrà aggiunta la regola seguente: 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

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

Se ad esempio si imposta questo valore su @{'OSDDownloadDestinationLocationType' = 'TSCache'} , verrà aggiunta la variabile seguente dopo la THEN regola: SET OSDDownloadDestinationLocationType = "TSCache"

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

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

-WhatIf

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

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

Input

Nessuno

Output

IResultObject