New-CMDetectionClauseRegistryKeyValue

  • Makale

SYNOPSIS

Kayıt defteri anahtar değeri için algılama yöntemi yan tümcesi oluşturun.

SYNTAX

Değer

New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
 -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
 -ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

Varlığı

New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
 -PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Bu cmdlet'i kullanarak bir uygulamanın algılama yönteminde yan tümcesi oluşturun. Bu yan tümce, bir uygulamanın varlığını göstermek için bir kayıt defteri anahtarı değerine ilişkin bir kuraldır.

Bir değer yerine kayıt defteri anahtarının varlığını algılamak için New-CMDetectionClauseRegistryKey cmdlet'ini kullanın.

Bu cmdlet'i kullandıktan sonra dağıtım türleri için Add- veya Set- cmdlet'lerinden birini kullanın. Bu algılama yan tümcesi nesnesini AddDetectionClause veya RemoveDetectionClause parametrelerine iletir.

Algılama yan tümcelerini gruplamak için dağıtım türü cmdlet'lerinde GroupDetectionClauses parametresini kullanın.

Not

Yapılandırma Yöneticisi site sürücüsünden cmdlet'Yapılandırma Yöneticisi çalıştırın, örneğin PS XYZ:\> . Daha fazla bilgi için başlarken bölümüne bakın.

EXAMPLES

Örnek 1: Kayıt defteri değerinin var olduğunu algılama

Bu örnek, geçerli sürüm değeri için Git'in varlığını algılamak Windows yan tümcesi oluşturur.

$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence

Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause

Örnek 2: Kayıt defterindeki bir sürüm değerini karşılaştırma

Bu örnek, kayıt defterindeki bir Microsoft 365 veya değerine eşit olacak şekilde karşılaştırmak için bir yan tümcesi 16.0.10730.20304 oluşturur.

$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

Bu parametre joker karakterleri değişmez karakter değerleri olarak kabul eder. ForceWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Varlık

Bu parametreyi eklerken, bu uygulamanın mevcut olduğunu belirtmek için hedef sistemde kayıt defteri anahtarı değeri mevcut olmalıdır.

Bu kayıt defteri anahtarı değerinin verilerine ilişkin bir kuralı değerlendirmek için yalnızca varlık yerine Value parametresini kullanın.

Type: SwitchParameter
Parameter Sets: Existence
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ExpectedValue

Value parametresini eklerken, PropertyType ve ExpressionOperator ile ExpectedValue kullanın. Bu parametreleri kullanırken, kayıt defteri anahtarı değeri bu uygulamanın varlığını belirtmek için kuralı karşılamalı. Bu ExpectedValue parametresi, kayıt defteri anahtarı değeriyle karşılaştır eklenecek değeri belirtir.

Karşılaştır için değer belirtilen PropertyType değerine bağlıdır.

Type: String[]
Parameter Sets: Value
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ExpressionOperator

Value parametresini eklerken PropertyType ve ExpectedValue ile ExpressionOperator kullanın. Bu parametreleri kullanırken, kayıt defteri anahtarı değeri bu uygulamanın varlığını belirtmek için kuralı karşılamalı. Bu ExpressionOperator parametresi, kayıt defteri anahtarı değerini beklenen değerle karşılaştırmak için işleci belirtir.

Sürüm 2010'dan başlayarak, parametre türü RuleExpressionOperator'dan RegistryValueRuleExpressionOperator olarak değiştirildi.

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

Bu parametre joker karakterleri işler ve beklenmeyen davranışlara neden olabilir (önerilmez). DisableWildcardHandling ile birleştiresiniz.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Hive

Anahtarın bulunduğu kayıt defteri kovanını belirtin. Anahtar adını belirtmek için KeyName parametresini kullanın. Kayıt defteri anahtarı değerini belirtmek için ValueName parametresini kullanın.

Örneğin, aşağıdaki PowerShell komutu aşağıdaki parametre değerlerine çevrilir:

Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion

Parametre Değer
Hive LocalMachine
Keyname 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
Valuename 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

Bu kayıt defteri anahtarının 64 bit sistemlerde 32 bitlik bir uygulamayla ilişkili olduğunu belirtmek için bu parametreyi ekleyin.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-KeyName

Bu uygulamanın varlığını belirtmek için mevcut olması gereken kayıt defteri anahtarının adını belirtin. Bu anahtarın bulunduğu kayıt defteri kovanını belirtmek için Hive parametresini kullanın. Kayıt defteri anahtarı değerini belirtmek için ValueName parametresini kullanın.

Örneğin, aşağıdaki PowerShell komutu aşağıdaki parametre değerlerine çevrilir:

Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion

Parametre Değer
Hive LocalMachine
Keyname 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
Valuename CurrentVersion 
Type: String
Parameter Sets: (All)
Aliases: RegistryKey

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PropertyType

Value parametresini eklerken ExpressionOperator ve ExpectedValue ile PropertyType kullanın. Bu parametreleri kullanırken, kayıt defteri anahtarı değeri bu uygulamanın varlığını belirtmek için kuralı karşılamalı. Bu PropertyType parametresi, kayıt defteri anahtarı değerinin veri türünü belirtir.

Örneğin, bu parametreyi olarak Version ayarlayın, ExpressionOperator değerini IsEquals olarak ve ExpectedValue değerini olarak 1.48.1.0 ayarlayın. Kural daha sonra aynı sürüme sahip olmak için belirtilen kayıt defteri anahtarı değerini denetler.

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

-Value

Value parametresini eklerken kayıt defteri anahtarı değerinin bu uygulamanın varlığını belirtmek için kuralı karşılaması gerekir. Şu parametrelerle bu parametreyi kullanın: ExpectedValue, ExpressionOperator ve PropertyType.

Bir kuralı değerlendirmek yerine, kayıt defteri anahtarı değerinin mevcut olup olduğunu kontrol etmek için Varlığı parametresini kullanın.

Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ValueName

Uygulamanın varlığını gösteren kayıt defteri anahtarı değerini belirtin. Kayıt defteri kovanını belirtmek için Hive parametresini ve kayıt defteri anahtarını belirtmek için KeyName kullanın.

Örneğin, aşağıdaki PowerShell komutu aşağıdaki parametre değerlerine çevrilir:

Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion

Parametre Değer
Hive LocalMachine
Keyname 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
Valuename CurrentVersion 
Type: String
Parameter Sets: (All)
Aliases: RegistryValueName

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Bu cmdlet şu genel parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

INPUTS

Hiçbiri

OUTPUTS

System.Object

NOTLAR

New-CMDetectionClauseDirectory

New-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseWindowsInstaller