Megosztás a következőn keresztül:


New-CMDetectionClauseRegistryKeyValue

SYNOPSIS

Hozzon létre egy észlelési metódus záradékot egy beállításkulcs-értékhez.

SYNTAX

Érték

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

Létezését

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

DESCRIPTION

Ezzel a parancsmagkal záradékot hozhat létre egy alkalmazás észlelési metódusában. Ez a záradék egy beállításkulcs-érték szabálya, amely egy alkalmazás jelenlétét jelzi.

Egy érték helyett egy beállításkulcs meglétének észleléséhez használja a New-CMDetectionClauseRegistryKey parancsmagot.

A parancsmag használata után használja az egyik Add- vagy Set- parancsmagot a központi telepítési típusokhoz. Adja át ezt az észlelési záradékobjektumot az AddDetectionClause vagy a RemoveDetectionClause paramétereknek.

A csoportészlelési záradékok csoportosítására használja a GroupDetectionCelésses paramétert az üzembe helyezési típus parancsmagja esetén.

Megjegyzés

Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.

EXAMPLES

1. példa: Beállításazonosító meglétének észlelése

Ez a példa létrehoz egy záradékot, amely észleli a Git meglétét Windows aktuális verzióértékhez.

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

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

2. példa: Verzióérték összehasonlítása a beállításjegyzékben

Ebben a példában létrehozunk egy záradékot, amely összehasonlítja a regisztrációs Microsoft 365 egy verziójának verzióját, hogy az nagyobb vagy egyenlő legyen a 16.0.10730.20304 beállításjegyzékben.

$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

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Existence (Meglét)

A paraméter hozzáadásakor a beállításkulcs értékének léteznie kell a célrendszeren az alkalmazás jelenlétének jelzéséhez.

Ahelyett, hogy csak a meglétet használjuk, a beállításkulcs-érték adataira vonatkozó szabályok kiértékeléséhez használja a Value paramétert.

Type: SwitchParameter
Parameter Sets: Existence
Aliases:

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

-ExpectedValue (Várt érték)

A Value paraméter hozzáadásakor használja a ExpectedValue értéket a PropertyType és az ExpressionOperator paraméterrel. Ha ezeket a paramétereket használja, a beállításkulcs értékének meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ez a ExpectedValue paraméter határozza meg a beállításkulcs értékével összehasonlítható értéket.

Az összehasonlítható érték a megadott Tulajdonságtípustól függ.

Type: String[]
Parameter Sets: Value
Aliases:

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

-ExpressionOperator

A Value paraméter hozzáadásakor használja az ExpressionOperatort a PropertyType és a ExpectedValue paraméterrel. Ha ezeket a paramétereket használja, a beállításkulcs értékének meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ez az ExpressionOperator paraméter határozza meg az operátort, amely összehasonlítja a beállításkulcs értékét a várt értékkel.

A 2010-es verziótól kezdődően a paraméter típusa RuleExpressionOperator értékről RegistryValueRuleExpressionOperator típusra változott.

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

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling kártyával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Hive

Adja meg azt a beállításjegyzék-struktúrát, amelyben a kulcs található. A kulcsnév megadásához használja a KeyName paramétert. A ValueName paraméterrel adhatja meg a beállításkulcs értékét.

A következő PowerShell-parancs például a következő paraméterértékeket fordítja le:

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

Paraméter Érték
Hive LocalMachine
Kulcsnév 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
ValueName (Érték neve) 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

Adja hozzá ezt a paramétert, amely jelzi, hogy ez a beállításkulcs egy 32 bites alkalmazáshoz van társítva 64 bites rendszereken.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-KeyName

Adja meg annak a beállításkulcsnak a nevét, amely az alkalmazás jelenlétét jelzi. A Hive paraméterrel adhatja meg azt a beállításjegyzék-struktúrát, ahol a kulcsnak léteznie kell. A ValueName paraméterrel adhatja meg a beállításkulcs értékét.

A következő PowerShell-parancs például a következő paraméterértékeket fordítja le:

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

Paraméter Érték
Hive LocalMachine
Kulcsnév 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
ValueName (Érték neve) CurrentVersion
Type: String
Parameter Sets: (All)
Aliases: RegistryKey

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

-PropertyType (Tulajdonságtípus)

A Value paraméter hozzáadásakor használja a PropertyType paramétert az ExpressionOperator és az ExpectedValue paraméterrel. Ha ezeket a paramétereket használja, a beállításkulcs értékének meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ez a PropertyType paraméter határozza meg a beállításkulcs-érték adattípusát.

Ezt a paramétert például a következőre kell beállítania: Version , az ExpressionOperator értéke IsEquals , a ExpectedValue értéke pedig 1.48.1.0 . A szabály ezután ellenőrzi, hogy a megadott beállításkulcs-értéknek ugyanaz a verziója-e.

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 (Érték)

Az Érték paraméter hozzáadásakor a beállításkulcs értékének meg kell felelnie a szabálynak, amely jelzi az alkalmazás jelenlétét. Ezt a paramétert a következő paraméterekkel használhatja: ExpectedValue, ExpressionOperator és PropertyType.

Egy szabály kiértékelés helyett a Meglét paraméter használatával ellenőrizheti, hogy a beállításkulcs értéke létezik-e.

Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule

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

-ValueName

Adja meg az alkalmazás jelenlétét jelző beállításkulcs-értéket. A Hive paraméterrel adhatja meg a beállításjegyzék-struktúra értékét, a KeyName paraméterrel pedig a beállításkulcsot.

A következő PowerShell-parancs például a következő paraméterértékeket fordítja le:

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

Paraméter Érték
Hive LocalMachine
Kulcsnév 'SOFTWARE\Microsoft\Windows NT\CurrentVersion'
ValueName (Érték neve) CurrentVersion
Type: String
Parameter Sets: (All)
Aliases: RegistryValueName

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

MEGJEGYZÉSEK

New-CMDetectionClauseDirectory

New-CMDetectionClauseFile

New-CMDetectionClauseRegistryKey

New-CMDetectionClauseWindowsInstaller