Créez une clause de méthode de détection pour une valeur de clé de Registre.
\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue":{"href":"new-cmdetectionclauseregistrykeyvalue","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMDetectionClauseRegistryKeyValue","schemaType":"PowershellCmdlet","summary":"Créez une clause de méthode de détection pour une valeur de clé de Registre.
\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}},"description":"Utilisez cette applet de commande pour créer une clause dans une méthode de détection sur une application. Cette clause est une règle pour une valeur de clé de Registre pour indiquer la présence d’une application.
\nPour détecter l’existence d’une clé de Registre au lieu d’une valeur, utilisez l’applet de commande New-CMDetectionClauseRegistryKey .
\nAprès avoir utilisé cette applet de commande, utilisez l’une des applets de commande Add- ou Set- pour les types de déploiement. Transmettez cet objet de clause de détection aux paramètres AddDetectionClause ou RemoveDetectionClause .
\nPour regrouper les clauses de détection, utilisez le paramètre GroupDetectionClauses sur les applets de commande de type de déploiement.
\nRemarque
\nExé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.
Cet exemple crée une clause pour détecter l’existence de la valeur de version actuelle de Git pour Windows.
\n","title":"Exemple 1 : Détecter l’existence d’une valeur de Registre"},{"code":"$clause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName 'Software\\Microsoft\\Office\\ClickToRun\\Configuration' -PropertyType Version -ValueName 'VersionToReport' -Value -ExpectedValue '16.0.10730.20304' -ExpressionOperator GreaterEquals\n\nSet-CMMsiDeploymentType -ApplicationName \"Microsoft 365\" -DeploymentTypeName \"Install\" -AddDetectionClause $clause","description":"","summary":"Cet exemple crée une clause pour comparer la version de Microsoft 365 dans le Registre pour qu’elle soit supérieure ou égale à 16.0.10730.20304.
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.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Lorsque vous ajoutez ce paramètre, la valeur de clé de Registre doit exister sur le système cible pour indiquer la présence de cette application.
\nAu lieu de simplement exister, pour évaluer une règle pour les données de cette valeur de clé de Registre, utilisez le paramètre Value .
\n","isRequired":true,"name":"Existence","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Lorsque vous ajoutez le paramètre Value , utilisez ExpectedValue avec PropertyType et ExpressionOperator. Lorsque vous utilisez ces paramètres, la valeur de la clé de Registre doit satisfaire à la règle pour indiquer la présence de cette application. Ce paramètre ExpectedValue spécifie la valeur à comparer à la valeur de clé de Registre.
\nLa valeur à comparer dépend du PropertyType spécifié.
\n","isRequired":true,"name":"ExpectedValue","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"","defaultValue":"None","description":"Lorsque vous ajoutez le paramètre Value , utilisez ExpressionOperator avec PropertyType et ExpectedValue. Lorsque vous utilisez ces paramètres, la valeur de la clé de Registre doit satisfaire à la règle pour indiquer la présence de cette application. Ce paramètre ExpressionOperator spécifie l’opérateur pour comparer la valeur de clé de Registre à la valeur attendue.
\nÀ compter de la version 2010, le type de paramètre est passé de RuleExpressionOperator à RegistryValueRuleExpressionOperator.
\n","isRequired":true,"name":"ExpressionOperator","parameterValueGroup":"IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains","position":"Named","type":"RegistryValueRuleExpressionOperator\n"},{"aliases":"","defaultValue":"None","description":"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.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryHive","defaultValue":"None","description":"Spécifiez la ruche du Registre où se trouve la clé. Utilisez le paramètre KeyName pour spécifier le nom de la clé. Utilisez le paramètre ValueName pour spécifier la valeur de la clé de Registre.
\nPar exemple, la commande PowerShell suivante se traduit par les valeurs de paramètre suivantes :
\nGet-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
| Paramètre | \nValeur | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nom de clé | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Ajoutez ce paramètre pour indiquer que cette clé de Registre est associée à une application 32 bits sur des systèmes 64 bits.
\n","name":"Is64Bit","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryKey","defaultValue":"None","description":"Spécifiez le nom de la clé de Registre qui doit exister pour indiquer la présence de cette application. Utilisez le paramètre Hive pour spécifier la ruche du Registre où cette clé doit exister. Utilisez le paramètre ValueName pour spécifier la valeur de la clé de Registre.
\nPar exemple, la commande PowerShell suivante se traduit par les valeurs de paramètre suivantes :
\nGet-ItemProperty 'HKLM :\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
\n| Paramètre | \nValeur | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nom de clé | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Lorsque vous ajoutez le paramètre Value , utilisez PropertyType avec ExpressionOperator et ExpectedValue. Lorsque vous utilisez ces paramètres, la valeur de la clé de Registre doit satisfaire à la règle pour indiquer la présence de cette application. Ce paramètre PropertyType spécifie le type de données de la valeur de clé de Registre.
\nPar exemple, vous définissez ce paramètre sur Version, définissez ExpressionOperator sur IsEqualset ExpectedValue sur 1.48.1.0. La règle vérifie ensuite que la valeur de clé de Registre spécifiée a la même version.
Lorsque vous ajoutez le paramètre Value , la valeur de clé de Registre doit satisfaire à la règle pour indiquer la présence de cette application. Utilisez ce paramètre avec les paramètres suivants : ExpectedValue, ExpressionOperator et PropertyType.
\nAu lieu d’évaluer une règle, pour vérifier simplement que la valeur de clé de Registre existe, utilisez le paramètre Existence .
\n","isRequired":true,"name":"Value","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryValueName","defaultValue":"None","description":"Spécifiez la valeur de clé de Registre qui indique la présence de l’application. Utilisez le paramètre Hive pour spécifier la ruche du Registre et KeyName pour spécifier la clé de Registre.
\nPar exemple, la commande PowerShell suivante se traduit par les valeurs de paramètre suivantes :
\nGet-ItemProperty 'HKLM :\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
\n| Paramètre | \nValeur | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nom de clé | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Créez une clause de méthode de détection pour une valeur de clé de Registre.
\n","syntaxes":["New-CMDetectionClauseRegistryKeyValue -ExpressionOperatorCréez une clause de méthode de détection pour une valeur de clé de Registre.
\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}],"canonical_url":"https://learn.microsoft.com/fr-fr/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/fr-fr/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps"},"pageMetadata":"Utilisez cette applet de commande pour créer une clause dans une méthode de détection sur une application. Cette clause est une règle pour une valeur de clé de Registre pour indiquer la présence d’une application.\nPour détecter l’existence d’une clé de Registre au lieu d’une valeur, utilisez l’applet de commande New-CMDetectionClauseRegistryKey .
\nAprès avoir utilisé cette applet de commande, utilisez l’une des applets de commande Add- ou Set- pour les types de déploiement. Transmettez cet objet de clause de détection aux paramètres AddDetectionClause ou RemoveDetectionClause .
\nPour regrouper les clauses de détection, utilisez le paramètre GroupDetectionClauses sur les applets de commande de type de déploiement.
\nRemarque
\nExé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.