New-CMDetectionClauseRegistryKeyValue
SYNOPSIS
Skapa en identifieringsmetodsats för ett registernyckelvärde.
SYNTAX
Värde
New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
-ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Existens
New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
-PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Använd den här cmdleten för att skapa en -sats i en identifieringsmetod i ett program. Den här satsen är en regel för ett registernyckelvärde som anger förekomsten av ett program.
Om du vill identifiera förekomsten av en registernyckel i stället för ett värde använder du cmdleten New-CMDetectionClauseRegistryKey.
När du har använder den här cmdleten använder du en av cmdletarna Add- eller Set- för distributionstyper. Skicka det här identifieringssatsobjektet till parametrarna AddDetectionClause eller RemoveDetectionClause.
Om du vill gruppera identifieringssatser använder du parametern GroupDetectionClauses på cmdletarna för distributionstyp.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Identifiera förekomsten av ett registervärde
I det här exemplet skapas en -sats för att identifiera förekomsten av Git Windows värdet för den aktuella versionen.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause
Exempel 2: Jämför ett versionsvärde i registret
I det här exemplet skapas en -sats för att jämföra Microsoft 365 i registret som större än eller lika med 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
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Existence
När du lägger till den här parametern måste registernyckelvärdet finnas i målsystemet för att indikera förekomsten av det här programmet.
Använd parametern Value i stället för att bara existera för att utvärdera en regel för data för det här registernyckelvärdet.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpectedValue
När du lägger till parametern Value använder du ExpectedValue med PropertyType och ExpressionOperator. När du använder dessa parametrar måste registernyckelvärdet uppfylla regeln för att indikera förekomsten av det här programmet. Den här parametern ExpectedValue anger det värde som ska jämföras med registernyckelvärdet.
Värdet som ska jämföras beror på angiven PropertyType.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
När du lägger till parametern Value använder du ExpressionOperator med PropertyType och ExpectedValue. När du använder dessa parametrar måste registernyckelvärdet uppfylla regeln för att indikera förekomsten av det här programmet. Den här expressionOperator-parametern anger operatorn för att jämföra registernyckelvärdet med det förväntade värdet.
Från och med version 2010 har parametertypen ändrats från RuleExpressionOperator till 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
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hive
Ange registreringsdatafilen där nyckeln finns. Använd parametern KeyName för att ange nyckelnamnet. Använd parametern ValueName för att ange registernyckelvärdet.
Följande PowerShell-kommando översätts till exempel till följande parametervärden:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
Parameter | Värde |
---|---|
Hive | LocalMachine |
Nyckelnamn | '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
Lägg till den här parametern för att ange att registernyckeln är associerad med ett 32-bitarsprogram på 64-bitarssystem.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyName
Ange namnet på den registernyckel som måste finnas för att indikera förekomsten av det här programmet. Använd Hive-parametern för att ange registreringsdatafilen där den här nyckeln ska finnas. Använd parametern ValueName för att ange registernyckelvärdet.
Följande PowerShell-kommando översätts till exempel till följande parametervärden:
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" | Select-Object CurrentVersion
Parameter | Värde |
---|---|
Hive | LocalMachine |
Nyckelnamn | '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
När du lägger till parametern Value använder du PropertyType med ExpressionOperator och ExpectedValue. När du använder dessa parametrar måste registernyckelvärdet uppfylla regeln för att indikera förekomsten av det här programmet. Den här Parametern PropertyType anger datatypen för registernyckelvärdet.
Du kan till exempel ange den här parametern Version
till , ange ExpressionOperator IsEquals
till och ExpectedValue till 1.48.1.0
. Regeln kontrollerar sedan att det angivna registernyckelvärdet har samma version.
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
När du lägger till parametern Value måste registernyckelvärdet uppfylla regeln för att indikera förekomsten av det här programmet. Använd den här parametern med följande parametrar: ExpectedValue, ExpressionOperator och PropertyType.
I stället för att utvärdera en regel använder du parametern Existence för att bara kontrollera att registernyckelvärdet finns.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Ange registernyckelvärdet som anger förekomsten av programmet. Använd Hive-parametern för att ange registreringsdatafilen och KeyName för att ange registernyckeln.
Följande PowerShell-kommando översätts till exempel till följande parametervärden:
Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" | Select-Object CurrentVersion
Parameter | Värde |
---|---|
Hive | LocalMachine |
Nyckelnamn | '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
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Ingen
OUTPUTS
System.Object
ANTECKNINGAR
RELATED LINKS
New-CMDetectionClauseDirectory