New-CMTSRule

  • Référence
Module:
ConfigurationManager

Créez une règle à ajouter à une étape de séquence de tâches Définir des variables dynamiques .

Syntaxe

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

Utilisez cette applet de commande pour créer un objet de règle que vous ajoutez à une étape de séquence de tâches Définir des variables dynamiques . Pour ajouter des règles, utilisez les applets de commande New-CMTSStepSetDynamicVariable ou Set-CMTSStepSetDynamicVariable . Lorsque la séquence de tâches exécute cette étape, elle évalue les règles et variables dynamiques dans l’ordre. Lorsqu’il évalue les règles sur l’appareil spécifique, il peut ensuite définir des variables de séquence de tâches en fonction de ces règles.

Il existe quatre types de règles :

  • Ordinateur : évaluez les valeurs de la balise de ressource matérielle, de l’UUID, du numéro de série ou de l’adresse MAC.
  • Emplacement : évaluez les valeurs de la passerelle réseau par défaut.
  • Make et Model : évaluez les valeurs de la fabrique et du modèle d’un ordinateur.
  • Variable de séquence de tâches : ajoutez une variable de séquence de tâches, une condition et une valeur à évaluer.

Pour plus d’informations, consultez Règles et variables dynamiques.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Définir la destination de téléchargement si dans Windows PE

Cet exemple crée la règle suivante :

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

Il ajoute ensuite cette règle à une instance existante de cette étape dans une séquence de tâches.

$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

Paramètres

-AssetTag

Spécifiez une balise Asset pour le type de règle Ordinateur . La valeur maximale est de 255 caractères.

Par exemple, si vous définissez cette valeur sur 123456, la règle suivante est ajoutée : IF Asset tag equals "123456" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultGateway

Spécifiez la passerelle par défaut pour le type de règle d’emplacement .

Par exemple, si vous définissez cette valeur sur 192.168.10.1, la règle suivante est ajoutée : IF Default gateway equals "192.168.10.1" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MacAddress

Spécifiez l’adresse MAC pour le type de règle Ordinateur .

Par exemple, si vous définissez cette valeur sur 00:11:22:33:44:55, la règle suivante est ajoutée : IF MAC address equals "00:11:22:33:44:55" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Make

Spécifiez le type de règle Make for the Make and Model (Make and Model ). Pour définir l’autre valeur, utilisez le paramètre Model . La règle prend la valeur true lorsque les deux valeurs sont true.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique

Par exemple, si vous définissez cette valeur sur Surface et le modèle sur *, la règle suivante est ajoutée : IF Make equals "Surface" AND Model equals "*" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Model

Spécifiez le modèle pour le type de règle Make et Model . Pour définir l’autre valeur, utilisez le paramètre Make . La règle prend la valeur true lorsque les deux valeurs sont true.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique

Par exemple, si vous définissez cette valeur sur * et l’élément Make sur Surface, la règle suivante est ajoutée : IF Make equals "Surface" AND Model equals "*" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReferencedVariableName

Spécifiez la variable pour le type de règle Variable de séquence de tâches. Vous devez également définir les paramètres ReferencedVariableOperator et ReferencedVariableValue .

Ce nom de variable peut être une variable de séquence de tâches intégrée ou une variable personnalisée que vous avez créée. Pour plus d’informations, consultez Guide pratique pour utiliser des variables de séquence de tâches dans Configuration Manager.

Par exemple, si vous définissez les valeurs suivantes :

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

Ensuite, il ajoute la règle suivante : IF OSDRegisteredOrgName equals "Contoso" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReferencedVariableOperator

Spécifiez la Condition pour le type de règle Variable de séquence de tâches. Vous devez également définir les paramètres ReferencedVariableName et ReferencedVariableValue . Pour connaître les opérateurs disponibles, consultez la liste des valeurs acceptées pour ce paramètre.

Par exemple, si vous définissez les valeurs suivantes :

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

Ensuite, il ajoute la règle suivante : IF OSDRegisteredOrgName equals "Contoso" THEN

Type:VariableOperatorType
Valeurs acceptées:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ReferencedVariableValue

Spécifiez la valeur pour le type de règle de variable de séquence de tâches. Vous devez également définir les paramètres ReferencedVariableName et ReferencedVariableOperator .

Par exemple, si vous définissez les valeurs suivantes :

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

Ensuite, il ajoute la règle suivante : IF OSDRegisteredOrgName equals "Contoso" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SerialNumber

Spécifiez un numéro de série pour le type de règle Ordinateur .

Par exemple, si vous définissez cette valeur sur 123456, la règle suivante est ajoutée : IF Asset tag equals "123456" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Uuid

Spécifiez un UUID pour le type de règle Ordinateur .

Par exemple, si vous définissez cette valeur sur de5ba380-f692-45e0-bbd3-0e40543b549e, la règle suivante est ajoutée : IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Variable

Spécifiez les variables de séquence de tâches existantes ou personnalisées et les valeurs associées que l’étape doit définir lorsque la règle prend la valeur true.

Par exemple, si vous définissez cette valeur sur @{'OSDDownloadDestinationLocationType' = 'TSCache'}, il ajoute la variable suivante après le THEN de la règle : SET OSDDownloadDestinationLocationType = "TSCache"

Pour spécifier plusieurs variables dans la même table de hachage, utilisez un délimiteur de point-virgule (;). Par exemple : @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type:Hashtable
Alias:Variables
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject