Sdílet prostřednictvím


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

New-CMDetectionClauseDirectory

New-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseWindowsInstaller