New-CMDetectionClauseRegistryKeyValue
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
RELATED LINKS
New-CMDetectionClauseDirectory