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