Partager via


New-CMTSRule

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

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

Utilisez cette cmdlet 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 cmdlets 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 : évaluer les valeurs de la balise de ressources matérielles, de l’UUID, du numéro de série ou de l’adresse MAC.
  • Emplacement : évaluer les valeurs de la passerelle réseau par défaut.
  • Make and Model: évaluer les valeurs de la make et du modèle d’un ordinateur.
  • Variable de séquence de tâches: ajoutez une variable, une condition et une valeur de séquence de tâches à évaluer.

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

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : définir la destination de téléchargement si 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

- Confirmer

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

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

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

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

-AssetTag

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

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 , il ajoute la règle suivante : 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

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 , il ajoute la règle suivante : 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

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

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 Surface le **** * modèle, il ajoute la règle suivante :IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

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

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 la valeur De * la **** Surface rendre, il ajoute la règle suivante :IF Make equals "Surface" AND Model equals "*" THEN

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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, voir Comment 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

Il ajoute ensuite la règle suivante : IF OSDRegisteredOrgName equals "Contoso" THEN

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 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

Il ajoute ensuite la règle suivante : 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

Spécifiez la valeur pour le type de règle 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

Il ajoute ensuite la règle suivante : IF OSDRegisteredOrgName equals "Contoso" THEN

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 , il ajoute la règle suivante : IF Asset tag equals "123456" THEN

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 , il ajoute la règle suivante : 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

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 est évaluée à true.

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

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

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

Entrées

Néant

Sorties

IResultObject