Share via

New-CMRequirementRuleRegistryKeyPermissionValue

  • Artikel

SYNOPSIS

Maak een vereisteregel om de machtigingen voor registersleutels te verifiëren.

SYNTAX

New-CMRequirementRuleRegistryKeyPermissionValue -ControlEntry <RegistryAccessControlEntry[]>
 [-Exclusive <Boolean>] [-InputObject] <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Gebruik deze cmdlet om een vereisteregel te maken voor een toepassingsimplementatietype dat registersleutelmachtigingen verifieert. Hiervoor is een aangepaste globale voorwaarde van het gegevenstype Registersleutel vereist.

Tip

Ter vergelijking: als u deze vereisteregel handmatig in de Configuration Manager maakt, selecteert u de volgende opties:

  • Categorie: Aangepast
  • Voorwaarde: Selecteer een aangepaste globale voorwaarde van het gegevenstype Registersleutel
  • Regeltype: Waarde
  • Eigenschap: Machtigingen

Nadat u deze cmdlet hebt gebruikt, gebruikt u een van de cmdlets Add- of Set- voor implementatietypen. Geef dit vereisteregelobject door aan de parameters AddRequirement of RemoveRequirement.

Zie Vereisten voor implementatietype en Globale voorwaarden maken voor meer informatie.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een vereisteregel voor registersleutelmachtigingen toevoegen

In dit voorbeeld wordt eerst de cmdlet Get-CMGlobalCondition gebruikt om een aangepaste globale voorwaarde op te halen. Vervolgens wordt de cmdlet New-CMRegistryAccessControlEntry gebruikt om twee vermeldingen voor toegangsbeheer te maken voor specifieke gebruikers. Vervolgens wordt het vereisteregelobject gemaakt om te controleren of de registersleutel de machtigingen heeft die zijn opgegeven in de vermeldingen voor toegangsbeheer. Ten slotte wordt dat regelobject aan de cmdlet Set-CMScriptDeploymentType door geven om de vereiste toe te voegen.

$myGC = Get-CMGlobalCondition -Name "LOB app registry key"

$userName = "contoso\jqpublic"
$ce = New-CMRegistryAccessControlEntry -GroupOrUserName $userName -AccessOption Allow -Permission Read,Write

$userName2 = "contoso\jdoe"
$ce2 = New-CMRegistryAccessControlEntry -GroupOrUserName $userName2 -AccessOption Allow -Permission Read

$myRule = $myGC | New-CMRequirementRuleRegistryKeyPermissionValue -Exclusive $false -ControlEntry $ce,$ce2

Set-CMScriptDeploymentType -ApplicationName "Central app" -DeploymentTypeName "Install" -AddRequirement $myRule

PARAMETERS

-ControlEntry

Geef een matrix met toegangsbeheerobjecten op. Een vermelding voor toegangsbeheer definieert specifieke machtigingen voor een specifieke gebruiker of groep. Gebruik de cmdlet New-CMRegistryAccessControlEntry om dit object op te halen.

Type: RegistryAccessControlEntry[]
Parameter Sets: (All)
Aliases: ControlEntries, RegistryAccessControlEntry, RegistryAccessControlEntries

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

-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

-Exclusief

Als deze parameter is, moet de regel exact overeenkomen met de opgegeven ACE om aan de regels $true te voldoen. Andere machtigingen voor de registersleutel zorgen ervoor dat de regel mislukt.

Als deze is ingesteld op , moet de opgegeven ACE bestaan en kunnen er ook andere $false machtigingen bestaan.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
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

-InputObject

Geef een aangepast globaal voorwaardeobject op dat moet worden gebruikt als basis voor deze vereisteregel. Gebruik de cmdlet Get-CMGlobalCondition om dit object op te halen.

Gebruik de volgende PowerShell-opdracht om de lijst met beschikbare algemene voorwaarden voor registersleutels op de site te bekijken:

Get-CMGlobalCondition | Where-Object DataType -eq "RegistryKey" | Select-Object LocalizedDisplayName

Type: IResultObject
Parameter Sets: (All)
Aliases: GlobalCondition

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

New-CMRegistryAccessControlEntry

New-CMRequirementRuleActiveDirectorySiteValue New-CMRequirementRuleBooleanValue New-CMRequirementRuleCMSiteValue New-CMRequirementRuleCommonValue New-CMRequirementRuleDeviceOwnershipValue New-CMRequirementRuleExistential New-CMRequirementRuleExpression New-CMRequirementRuleFileAttributeValue New-CMRequirementRuleFilePermissionValue New-CMRequirementRuleFreeDiskSpaceValue New-CMRequirementRuleInputTypeValue New-CMRequirementRuleOperatingSystemLanguageValue New-CMRequirementRuleOperatingSystemValue New-CMRequirementRuleOUValue New-CMRequirementRuleScreenResolutionValue Get-CMGlobalCondition Vereisten voor implementatietype Globale voorwaarden maken