New-CMDetectionClauseRegistryKeyValue
SYNOPSIS
Crie uma cláusula de método de deteção para um valor chave de registo.
SYNTAX
Valor
New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
-ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existência
New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
-PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Utilize este cmdlet para criar uma cláusula num método de deteção numa aplicação. Esta cláusula é uma regra para um valor chave de registo para indicar a presença de uma aplicação.
Para detetar a existência de uma chave de registo em vez de um valor, utilize o cmdlet New-CMDetectionClauseRegistryKey.
Depois de utilizar este cmdlet, utilize um dos cmdlets Add-or set para tipos de implantação. Passe este objeto de cláusula de deteção para os parâmetros AddDetectionClause ou RemoveDetectionClause.
Para agrupar cláusulas de deteção, utilize o parâmetro GroupDetectionClauses nos cmdlets do tipo de implantação.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Detetar a existência de um valor de registo
Este exemplo cria uma cláusula para detetar a existência do Git para Windows valor da versão atual.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause
Exemplo 2: Compare um valor de versão no registo
Este exemplo cria uma cláusula para comparar a versão de Microsoft 365 no registo ser maior ou igual a 16.0.10730.20304 .
$clause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName 'Software\Microsoft\Office\ClickToRun\Configuration' -PropertyType Version -ValueName 'VersionToReport' -Value -ExpectedValue '16.0.10730.20304' -ExpressionOperator GreaterEquals
Set-CMMsiDeploymentType -ApplicationName "Microsoft 365" -DeploymentTypeName "Install" -AddDetectionClause $clause
PARAMETERS
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Existência
Quando se adiciona este parâmetro, o valor da chave de registo deve existir no sistema-alvo para indicar a presença desta aplicação.
Em vez de apenas existir, para avaliar uma regra para os dados deste valor chave de registo, use o parâmetro Valor.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Valor Esperado
Quando adicionar o parâmetro Valor, utilize o Valor Esperado com o PropertyType e o ExpressionOperator. Quando utilizar estes parâmetros, o valor da chave de registo deve satisfazer a regra para indicar a presença desta aplicação. Este parâmetro ExpectValue especifica o valor a comparar com o valor da chave de registo.
O valor a comparar depende doTipo de Propriedade especificado.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Quando adicionar o parâmetro Valor, utilize o ExpressionOperator com o PropertyType e o ExpectValue. Quando utilizar estes parâmetros, o valor da chave de registo deve satisfazer a regra para indicar a presença desta aplicação. Este parâmetro ExpressionOperator especifica o operador para comparar o valor da chave de registo com o valor esperado.
A partir da versão 2010, o tipo de parâmetro mudou de RuleExpressionOperator para RegistryValueRuleExpressionOperator.
Type: RegistryValueRuleExpressionOperator
Parameter Sets: Value
Aliases:
Accepted values: IsEquals, NotEquals, GreaterThan, LessThan, Between, GreaterEquals, LessEquals, OneOf, NoneOf, BeginsWith, NotBeginsWith, EndsWith, NotEndsWith, Contains, NotContains
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Colmeia
Especifique a colmeia de registo onde a chave existe. Utilize o parâmetro KeyName para especificar o nome da chave. Utilize o parâmetro ValueName para especificar o valor da chave de registo.
Por exemplo, o seguinte comando PowerShell traduz-se para os seguintes valores de parâmetro:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parâmetro | Valor |
|---|---|
| Hive | LocalMachine |
| Nome-chave | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValorName | CurrentVersion |
Type: RegistryRootKey
Parameter Sets: (All)
Aliases: RegistryHive
Accepted values: ClassesRoot, CurrentConfig, CurrentUser, LocalMachine, Users
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Is64Bit
Adicione este parâmetro para indicar que esta chave de registo está associada a uma aplicação de 32 bits em sistemas de 64 bits.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome-chave
Especificar o nome da chave de registo que deve existir para indicar a presença deste pedido. Utilize o parâmetro Hive para especificar a colmeia de registo onde esta chave deve existir. Utilize o parâmetro ValueName para especificar o valor da chave de registo.
Por exemplo, o seguinte comando PowerShell traduz-se para os seguintes valores de parâmetro:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Microsoft\Windows NT\CurrentVersion' | Select-Object Actualversão
| Parâmetro | Valor |
|---|---|
| Hive | LocalMachine |
| Nome-chave | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValorName | CurrentVersion |
Type: String
Parameter Sets: (All)
Aliases: RegistryKey
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PropertyType
Quando adicionar o parâmetro Valor, utilize o PropertyType com ExpressionOperator e ExpectValue. Quando utilizar estes parâmetros, o valor da chave de registo deve satisfazer a regra para indicar a presença desta aplicação. Este parâmetro PropertyType especifica o tipo de dados do valor chave de registo.
Por exemplo, define este parâmetro para Version , definir ExpressionOperator para IsEquals , e ExpectValue para 1.48.1.0 . A regra verifica então o valor da chave de registo especificado para ter a mesma versão.
Type: SettingDataType
Parameter Sets: (All)
Aliases:
Accepted values: Version, Integer, String
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Valor
Ao adicionar o parâmetro Valor, o valor da chave de registo deve satisfazer a regra para indicar a presença desta aplicação. Utilize este parâmetro com os seguintes parâmetros: ExpectValue, ExpressionOperator e PropertyType.
Em vez de avaliar uma regra, apenas para verificar se o valor chave do registo existe, use o parâmetro Existência.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValorName
Especifique o valor da chave de registo que indica a presença da aplicação. Utilize o parâmetro Hive para especificar a colmeia de registo e o Nome-chave para especificar a chave de registo.
Por exemplo, o seguinte comando PowerShell traduz-se para os seguintes valores de parâmetro:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Microsoft\Windows NT\CurrentVersion' | Select-Object Actualversão
| Parâmetro | Valor |
|---|---|
| Hive | LocalMachine |
| Nome-chave | 'SOFTWARE\Microsoft\Windows NT\CurrentVersion' |
| ValorName | CurrentVersion |
Type: String
Parameter Sets: (All)
Aliases: RegistryValueName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Nenhuma
OUTPUTS
Sistema.Objeto
NOTAS
RELATED LINKS
Novo CMDetectionClauseDirectory