Crie uma cláusula de método de detecção para um valor de chave do Registro.
\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":"Crie uma cláusula de método de detecção para um valor de chave do Registro.
\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}},"description":"Use este cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Essa cláusula é uma regra para um valor de chave do Registro para indicar a presença de um aplicativo.
\nPara detectar a existência de uma chave do Registro em vez de um valor, use o cmdlet New-CMDetectionClauseRegistryKey .
\nDepois de usar esse cmdlet, use um dos cmdlets Add ou Set para os tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause .
\nPara agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets do tipo de implantação.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Este exemplo cria uma cláusula para detectar a existência do valor da versão atual do Git para Windows.
\n","title":"Exemplo 1: Detectar a existência de um valor do Registro"},{"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":"Este exemplo cria uma cláusula para comparar a versão do Microsoft 365 no registro para ser maior ou igual a 16.0.10730.20304.
Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Quando você adiciona esse parâmetro, o valor da chave do Registro deve existir no sistema de destino para indicar a presença desse aplicativo.
\nEm vez de apenas existência, para avaliar uma regra para os dados desse valor de chave do Registro, use o parâmetro Value .
\n","isRequired":true,"name":"Existence","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Ao adicionar o parâmetro Value , use ExpectedValue com PropertyType e ExpressionOperator. Quando você usa esses parâmetros, o valor da chave do Registro deve satisfazer a regra para indicar a presença desse aplicativo. Esse parâmetro ExpectedValue especifica o valor a ser comparado com o valor da chave do Registro.
\nO valor a ser comparado depende do PropertyType especificado.
\n","isRequired":true,"name":"ExpectedValue","parameterValueGroup":"","position":"Named","type":"String[]
\n"},{"aliases":"","defaultValue":"None","description":"Ao adicionar o parâmetro Value , use ExpressionOperator com PropertyType e ExpectedValue. Quando você usa esses parâmetros, o valor da chave do Registro deve satisfazer a regra para indicar a presença desse aplicativo. Esse parâmetro ExpressionOperator especifica o operador para comparar o valor da chave do Registro com o valor esperado.
\nA partir da versão 2010, o tipo de parâmetro mudou de RuleExpressionOperator para 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":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryHive","defaultValue":"None","description":"Especifique o hive do Registro em que a chave existe. Use o parâmetro KeyName para especificar o nome da chave. Use o parâmetro ValueName para especificar o valor da chave do Registro.
\nPor exemplo, o seguinte comando do PowerShell se traduz nos seguintes valores de parâmetro:
\nGet-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
| Parâmetro | \nValor | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nome da chave | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Adicione esse parâmetro para indicar que essa chave do Registro está associada a um aplicativo de 32 bits em sistemas de 64 bits.
\n","name":"Is64Bit","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryKey","defaultValue":"None","description":"Especifique o nome da chave do Registro que deve existir para indicar a presença desse aplicativo. Use o parâmetro Hive para especificar o hive do Registro onde essa chave deve existir. Use o parâmetro ValueName para especificar o valor da chave do Registro.
\nPor exemplo, o seguinte comando do PowerShell se traduz nos seguintes valores de parâmetro:
\nGet-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
\n| Parâmetro | \nValor | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nome da chave | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Ao adicionar o parâmetro Value , use PropertyType com ExpressionOperator e ExpectedValue. Quando você usa esses parâmetros, o valor da chave do Registro deve satisfazer a regra para indicar a presença desse aplicativo. Esse parâmetro PropertyType especifica o tipo de dados do valor da chave do Registro.
\nPor exemplo, você define esse parâmetro como Version, define ExpressionOperator como IsEqualse ExpectedValue como 1.48.1.0. Em seguida, a regra verifica se o valor da chave do Registro especificado tem a mesma versão.
Ao adicionar o parâmetro Value , o valor da chave do Registro deve atender à regra para indicar a presença desse aplicativo. Use esse parâmetro com os seguintes parâmetros: ExpectedValue, ExpressionOperator e PropertyType.
\nEm vez de avaliar uma regra, para apenas marcar se o valor da chave do Registro existe, use o parâmetro Existence.
\n","isRequired":true,"name":"Value","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"RegistryValueName","defaultValue":"None","description":"Especifique o valor da chave do Registro que indica a presença do aplicativo. Use o parâmetro Hive para especificar o hive do Registro e KeyName para especificar a chave do Registro.
\nPor exemplo, o seguinte comando do PowerShell se traduz nos seguintes valores de parâmetro:
\nGet-ItemProperty 'HKLM:\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | Select-Object CurrentVersion
\n| Parâmetro | \nValor | \n
|---|---|
| \n Hive | \nLocalMachine | \n
| \n Nome da chave | \n'SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion' | \n
| \n ValueName | \nCurrentVersion | \n
Crie uma cláusula de método de detecção para um valor de chave do Registro.
\n","syntaxes":["New-CMDetectionClauseRegistryKeyValue -ExpressionOperatorCrie uma cláusula de método de detecção para um valor de chave do Registro.
\n","uid":"ConfigurationManager.New-CMDetectionClauseRegistryKeyValue"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmdetectionclauseregistrykeyvalue?view=sccm-ps"},"pageMetadata":"Use este cmdlet para criar uma cláusula em um método de detecção em um aplicativo. Essa cláusula é uma regra para um valor de chave do Registro para indicar a presença de um aplicativo.\nPara detectar a existência de uma chave do Registro em vez de um valor, use o cmdlet New-CMDetectionClauseRegistryKey .
\nDepois de usar esse cmdlet, use um dos cmdlets Add ou Set para os tipos de implantação. Passe esse objeto de cláusula de detecção para os parâmetros AddDetectionClause ou RemoveDetectionClause .
\nPara agrupar cláusulas de detecção, use o parâmetro GroupDetectionClauses nos cmdlets do tipo de implantação.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.