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.

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

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

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

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

Novo CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

Novo CMDetectionClauseWindowsInstaller