New-CMDetectionClauseRegistryKeyValue
SYNOPSIS
Maak een detectiemethodeclausule voor een registersleutelwaarde.
SYNTAX
Waarde
New-CMDetectionClauseRegistryKeyValue -ExpressionOperator <RegistryValueRuleExpressionOperator>
-Hive <RegistryRootKey> [-Is64Bit] -KeyName <String> -PropertyType <SettingDataType> -ValueName <String>
-ExpectedValue <String[]> [-Value] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]
Bestaan
New-CMDetectionClauseRegistryKeyValue -Hive <RegistryRootKey> [-Is64Bit] -KeyName <String>
-PropertyType <SettingDataType> -ValueName <String> [-Existence] [-DisableWildcardHandling]
[-ForceWildcardHandling] [<CommonParameters>]
DESCRIPTION
Gebruik deze cmdlet om een -component te maken in een detectiemethode in een toepassing. Deze component is een regel voor een registersleutelwaarde om de aanwezigheid van een toepassing aan te geven.
Als u het bestaan van een registersleutel in plaats van een waarde wilt detecteren, gebruikt u de cmdlet New-CMDetectionRegistryKey.
Nadat u deze cmdlet hebt gebruikt, gebruikt u een van de cmdlets Add- of Set- voor implementatietypen. Geef dit object van de detectieclausule door aan de parameters AddDetectionParause of RemoveDetectionParause.
Als u detectieclausules wilt groepeert, gebruikt u de parameter GroupDetectionParauses op de cmdlets van het implementatietype.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Het bestaan van een registerwaarde detecteren
In dit voorbeeld wordt een -component gemaakt om het bestaan van de Git voor Windows huidige versiewaarde te detecteren.
$regClause = New-CMDetectionClauseRegistryKeyValue -Hive LocalMachine -KeyName "SOFTWARE\GitForWindows" -PropertyType String -ValueName "CurrentVersion" -Existence
Set-CMMsiDeploymentType -ApplicationName "Git for Windows" -DeploymentTypeName "Install" -AddDetectionClause $regClause
Voorbeeld 2: Een versiewaarde in het register vergelijken
In dit voorbeeld wordt een -component gemaakt om de versie van Microsoft 365 in het register te vergelijken met een waarde die groter is dan of gelijk is aan 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
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Bestaan
Wanneer u deze parameter toevoegt, moet de registersleutelwaarde bestaan in het doelsysteem om aan te geven dat deze toepassing aanwezig is.
Als u een regel wilt evalueren voor de gegevens van deze registersleutelwaarde, gebruikt u in plaats van alleen bestaan de parameter Value.
Type: SwitchParameter
Parameter Sets: Existence
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpectedValue
Wanneer u de parameter Value toevoegt, gebruikt u ExpectedValue met PropertyType en ExpressionOperator. Wanneer u deze parameters gebruikt, moet de registersleutelwaarde voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Deze ExpectedValue parameter geeft u de waarde die moet worden vergeleken met de registersleutelwaarde.
De te vergelijken waarde is afhankelijk van het opgegeven PropertyType.
Type: String[]
Parameter Sets: Value
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ExpressionOperator
Wanneer u de parameter Value toevoegt, gebruikt u ExpressionOperator met PropertyType en ExpectedValue. Wanneer u deze parameters gebruikt, moet de registersleutelwaarde voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Met deze parameter ExpressionOperator geeft u de operator op om de registersleutelwaarde te vergelijken met de verwachte waarde.
Vanaf versie 2010 is het parametertype gewijzigd van RuleExpressionOperator in 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
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hive
Geef de register-hive op waar de sleutel zich bevindt. Gebruik de parameter KeyName om de sleutelnaam op te geven. Gebruik de parameter ValueName om de waarde van de registersleutel op te geven.
De volgende PowerShell-opdracht wordt bijvoorbeeld omgezet in de volgende parameterwaarden:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parameter | Waarde |
|---|---|
| Hive | LocalMachine |
| KeyName | '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
Voeg deze parameter toe om aan te geven dat deze registersleutel is gekoppeld aan een 32-bits toepassing op 64-bits systemen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyName
Geef de naam op van de registersleutel die moet bestaan om de aanwezigheid van deze toepassing aan te geven. Gebruik de Hive-parameter om de register-hive op te geven waar deze sleutel moet bestaan. Gebruik de parameter ValueName om de waarde van de registersleutel op te geven.
De volgende PowerShell-opdracht wordt bijvoorbeeld omgezet in de volgende parameterwaarden:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parameter | Waarde |
|---|---|
| Hive | LocalMachine |
| KeyName | '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
Wanneer u de parameter Value toevoegt, gebruikt u PropertyType met ExpressionOperator en ExpectedValue. Wanneer u deze parameters gebruikt, moet de registersleutelwaarde voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Met deze parameter PropertyType geeft u het gegevenstype van de registersleutelwaarde op.
Stel deze parameter bijvoorbeeld in op Version , stel ExpressionOperator in op en IsEquals ExpectedValue op 1.48.1.0 . De regel controleert vervolgens of de opgegeven registersleutelwaarde dezelfde versie heeft.
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
-Waarde
Wanneer u de parameter Waarde toevoegt, moet de registersleutelwaarde voldoen aan de regel om de aanwezigheid van deze toepassing aan te geven. Gebruik deze parameter met de volgende parameters: ExpectedValue, ExpressionOperator en PropertyType.
In plaats van een regel te evalueren, gebruikt u de parameter Existence om te controleren of de registersleutelwaarde bestaat.
Type: SwitchParameter
Parameter Sets: Value
Aliases: ValueRule
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValueName
Geef de waarde van de registersleutel op die de aanwezigheid van de toepassing aangeeft. Gebruik de Hive-parameter om de register-hive op te geven en KeyName om de registersleutel op te geven.
De volgende PowerShell-opdracht wordt bijvoorbeeld omgezet in de volgende parameterwaarden:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' | Select-Object CurrentVersion
| Parameter | Waarde |
|---|---|
| Hive | LocalMachine |
| KeyName | '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
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.