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