New-CMDetectionClauseRegistryKeyValue
SYNOPSIS
Utwórz klauzulę metody wykrywania dla wartości klucza rejestru.
SYNTAX
Wartość
New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
-ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Istnienia
New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
-PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
To polecenie cmdlet umożliwia utworzenie klauzuli w metodzie wykrywania w aplikacji. Ta klauzula jest regułą dla wartości klucza rejestru, która wskazuje obecność aplikacji.
Aby wykryć istnienie klucza rejestru zamiast wartości, użyj polecenia cmdlet New-CMDetectionClauseRegistryKey.
Po użyciu tego polecenia cmdlet użyj jednego z add- lub set- polecenia cmdlet dla typów wdrożeń. Przekaż ten obiekt klauzuli wykrywania do parametrów AddDetectionClause lub RemoveDetectionClause.
Aby zgrupować klauzule wykrywania, użyj parametru GroupDetectionClauses w poleceniach cmdlet typu wdrożenia.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: wykrywanie istnienia wartości rejestru
Ten przykład tworzy klauzulę w celu wykrycia istnienia usługi Git dla Windows bieżącej wersji.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause
Przykład 2: Porównanie wartości wersji w rejestrze
Ten przykład tworzy klauzulę w celu porównania wersji Microsoft 365 w rejestrze, aby była większa niż lub równa 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
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Istnienie
Po dodaniu tego parametru wartość klucza rejestru musi istnieć w systemie docelowym, aby wskazać obecność tej aplikacji.
Zamiast tylko istnienia, aby ocenić regułę dla danych tej wartości klucza rejestru, użyj parametru Value.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpectedValue
Podczas dodawania parametru Value użyj wartości ExpectedValue z właściwościami PropertyType i ExpressionOperator. Jeśli używasz tych parametrów, wartość klucza rejestru musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr ExpectedValue określa wartość do porównania z wartością klucza rejestru.
Wartość do porównania zależy od określonego typu właściwości.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Podczas dodawania parametru Value użyj właściwości ExpressionOperator z właściwościami PropertyType i ExpectedValue. Jeśli używasz tych parametrów, wartość klucza rejestru musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr ExpressionOperator określa operator, który ma porównać wartość klucza rejestru z oczekiwaną wartością.
Począwszy od wersji 2010, typ parametru został zmieniony z RuleExpressionOperator na 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
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hive
Określ gałąź rejestru, w której istnieje klucz. Użyj parametru KeyName, aby określić nazwę klucza. Użyj parametru ValueName, aby określić wartość klucza rejestru.
Na przykład następujące polecenie programu PowerShell przekłada się na następujące wartości parametrów:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parametr | Wartość |
|---|---|
| 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
Dodaj ten parametr, aby wskazać, że ten klucz rejestru jest skojarzony z aplikacją 32-bitową w systemach 64-bitowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyName
Określ nazwę klucza rejestru, który musi istnieć, aby wskazać obecność tej aplikacji. Użyj parametru Hive, aby określić gałąź rejestru, w której powinien istnieć ten klucz. Użyj parametru ValueName, aby określić wartość klucza rejestru.
Na przykład następujące polecenie programu PowerShell przekłada się na następujące wartości parametrów:
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" | Select-Object CurrentVersion
| Parametr | Wartość |
|---|---|
| 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
Po dodaniu parametru Value użyj właściwości PropertyType z parametrami ExpressionOperator i ExpectedValue. Jeśli używasz tych parametrów, wartość klucza rejestru musi spełniać regułę, aby wskazać obecność tej aplikacji. Ten parametr PropertyType określa typ danych wartości klucza rejestru.
Na przykład ten parametr należy ustawić na Version , ustawić parametr ExpressionOperator na IsEquals wartość , a parametr ExpectedValue na 1.48.1.0 wartość . Następnie reguła sprawdza, czy określona wartość klucza rejestru ma tę samą wersję.
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 (Wartość)
Po dodaniu parametru Value wartość klucza rejestru musi spełniać regułę wskazującą obecność tej aplikacji. Użyj tego parametru z następującymi parametrami: ExpectedValue, ExpressionOperator i PropertyType.
Zamiast oceniać regułę, aby tylko sprawdzić, czy wartość klucza rejestru istnieje, użyj parametru Obecność.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Określ wartość klucza rejestru, która wskazuje obecność aplikacji. Użyj parametru Hive, aby określić gałąź rejestru, a parametr KeyName w celu określenia klucza rejestru.
Na przykład następujące polecenie programu PowerShell przekłada się na następujące wartości parametrów:
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" | Select-Object CurrentVersion
| Parametr | Wartość |
|---|---|
| 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
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
INPUTS
Brak
OUTPUTS
System.Object
UWAGI
RELATED LINKS
New-CMDetectionClauseDirectory