Partager via

New-CMTSStepConditionRegistry

  • Référence
Module:
ConfigurationManager

Créez une condition de paramètre de Registre pour une étape de séquence de tâches.

Syntaxe

New-CMTSStepConditionRegistry
   -RegistryKey <String>
   -RegistryOperator <VariableOperatorType>
   [-RegistryValueData <String>]
   [-RegistryValueName <String>]
   -RootKey <RegistryRootKeyType>
   [-ValueType <RegistryValueType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un objet de condition de paramètre de Registre pour une étape de séquence de tâches. Utilisez ensuite l’une des applets de commande New-CMTSStep* ou Set-CMTSStep* avec les paramètres Condition ou AddCondition . Par exemple, Set-CMTSStepApplyDataImage.

Pour plus d’informations, consultez Utiliser l’éditeur de séquence de tâches : conditions.

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

Cet exemple crée d’abord l’objet de condition pour le paramètre de Registre qui vérifie le niveau de journalisation du client Configuration Manager.

Il utilise ensuite l’applet de commande Set-CMTSStepSetDynamicVariable pour ajouter cet objet de condition à l’étape Définir des variables dynamiques de la séquence de tâches de déploiement du système d’exploitation par défaut .

$root = "HKeyLocalMachine"
$key = "SOFTWARE\Microsoft\CCM\Logging\@Global"
$name = "LogLevel"
$type = "RegistryDWord"
$value = 1

$condition = New-CMTSStepConditionRegistry -RootKey $root -RegistryKey $key -RegistryOperator Equals -RegistryValueName $name -ValueType $type -RegistryValueData $value

$tsNameOsd = "Default OS deployment"
$tsStepNameDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameDynVar -AddCondition $condition

Cet exemple de script crée la condition suivante à l’étape :

Registry "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global\LogLevel" (REG_DWORD) equals "1"

Paramètres

-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

-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

-RegistryKey

Spécifiez le chemin de la clé de Registre à vérifier. Par exemple, avec RootKeyHKeyLocalMachine, vous pouvez spécifier la clé SOFTWARE\Microsoft\CCMde Registre .

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

-RegistryOperator

Utilisez ce paramètre pour spécifier l’opérateur de la séquence de tâches afin d’évaluer la valeur de Registre. Si vous utilisez les Exists valeurs ou NotExists , vous n’avez pas besoin d’utiliser le paramètre RegistryValueData .

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

-RegistryValueData

Si vous utilisez un RegistryOperator comparatif comme Equals, utilisez ce paramètre pour spécifier les données de valeur à évaluer. Utilisez ValueType pour spécifier le type de Registre.

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

-RegistryValueName

Spécifiez le nom de la valeur de Registre à vérifier. Si vous ne spécifiez pas ce paramètre, la condition vérifie la valeur (par défaut) de la propriété RegistryKey spécifiée.

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

-RootKey

Spécifiez la clé racine de Registre à vérifier.

Type:RegistryRootKeyType
Valeurs acceptées:HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ValueType

Spécifiez le type de valeur de Registre à vérifier. Utilisez ce paramètre avec RegistryValueData pour spécifier les données de valeur.

Type:RegistryValueType
Valeurs acceptées:RegistrySZ, RegistryExpandSZ, RegistryDWord
Position:Named
Valeur par défaut:None
Obligatoire:False
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

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_RegistryConditionExpression classe WMI du serveur.