New-CMDetectionClauseRegistryKeyValue
SYNOPSIS
Vytvořte klauzuli metody detekce pro hodnotu klíče registru.
SYNTAX
Hodnota
New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
-ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existence
New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
-PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Tuto rutinu použijte k vytvoření klauzule v metodě detekce v aplikaci. Tato klauzule je pravidlem pro hodnotu klíče registru, které indikuje přítomnost aplikace.
Pokud chcete zjistit existenci klíče registru místo hodnoty, použijte rutinu New-CMDetectionClauseRegistryKey.
Po použití této rutiny použijte jednu z rutin Add- nebo Set- pro typy nasazení. Předejte tento objekt detection clause parametrům AddDetectionClause nebo RemoveDetectionClause.
Pokud chcete seskupit klauzule detekce, použijte v rutinách typu nasazení parametr GroupDetectionClauses.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Zjištění existence hodnoty registru
Tento příklad vytvoří klauzuli pro zjištění existence Gitu pro Windows aktuální verze.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause
Příklad 2: Porovnání hodnoty verze v registru
Tento příklad vytvoří klauzuli pro porovnání verze Microsoft 365 v registru tak, aby byla větší než nebo rovna 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
Tento parametr považuje zástupné znaky za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Existence
Když přidáte tento parametr, musí v cílovém systému existovat hodnota klíče registru, aby bylo vidět přítomnost této aplikace.
Místo toho, abyste vyhodnotíme pravidlo pro data této hodnoty klíče registru, použijte parametr Hodnota.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpectedValue
Když přidáte parametr Value, použijte ExpectedValue s PropertyType a ExpressionOperator. Pokud použijete tyto parametry, hodnota klíče registru musí splňovat pravidlo, které indikuje přítomnost této aplikace. Tento parametr ExpectedValue určuje hodnotu, která se má porovnat s hodnotou klíče registru.
Hodnota, která se má porovnat, závisí na zadaném typu vlastnosti.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Když přidáte parametr Value, použijte ExpressionOperator s PropertyType a ExpectedValue. Pokud použijete tyto parametry, hodnota klíče registru musí splňovat pravidlo, které indikuje přítomnost této aplikace. Tento parametr ExpressionOperator určuje operátor, který porovná hodnotu klíče registru s očekávanou hodnotou.
Od verze 2010 se typ parametru změnil 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
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hive
Zadejte podregistr registru, ve kterém klíč existuje. K zadání názvu klíče použijte parametr KeyName. K určení hodnoty klíče registru použijte parametr ValueName.
Například následující příkaz PowerShellu se přeloží na následující hodnoty parametrů:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parametr | Hodnota |
|---|---|
| Hive | LocalMachine |
| Název_klíče | '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
Přidejte tento parametr, který označuje, že tento klíč registru je přidružený k 32bitové aplikaci v 64bitových systémech.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyName
Zadejte název klíče registru, který musí existovat, aby bylo možné označit přítomnost této aplikace. Pomocí parametru Hive určete podregistr registru, ve kterém má tento klíč existovat. K určení hodnoty klíče registru použijte parametr ValueName.
Například následující příkaz PowerShellu se přeloží na následující hodnoty parametrů:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\systém Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parametr | Hodnota |
|---|---|
| Hive | LocalMachine |
| Název_klíče | '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
Když přidáte parametr Value, použijte PropertyType s ExpressionOperator a ExpectedValue. Pokud použijete tyto parametry, hodnota klíče registru musí splňovat pravidlo, které indikuje přítomnost této aplikace. Tento parametr PropertyType určuje datový typ hodnoty klíče registru.
Například tento parametr nastavíte na Version , nastavte ExpressionOperator na IsEquals a ExpectedValue na 1.48.1.0 . Pravidlo pak zkontroluje, že zadaná hodnota klíče registru bude mít stejnou verzi.
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
Když přidáte parametr Hodnota, hodnota klíče registru musí splňovat pravidlo, které indikuje přítomnost této aplikace. Použijte tento parametr s následujícími parametry: ExpectedValue, ExpressionOperator a PropertyType.
Místo vyhodnocení pravidla použijte parametr Existence a zkontrolujte, že hodnota klíče registru existuje.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Zadejte hodnotu klíče registru, která označuje přítomnost aplikace. Pomocí parametru Hive zadejte podregistr registru a KeyName k zadání klíče registru.
Například následující příkaz PowerShellu se přeloží na následující hodnoty parametrů:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\systém Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parametr | Hodnota |
|---|---|
| Hive | LocalMachine |
| Název_klíče | '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
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.
INPUTS
Žádná
OUTPUTS
System.Object
POZNÁMKY
RELATED LINKS
New-CMDetectionClauseDirectory