Dela via


New-CMRequirementRuleRegistryKeyPermissionValue

SYNOPSIS

Skapa en kravregel för att verifiera registernyckelbehörigheter.

SYNTAX

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

DESCRIPTION

Använd den här cmdleten för att skapa en kravregel för en programdistributionstyp som verifierar registernyckelbehörigheter. Det kräver ett anpassat globalt villkor av datatypen Registernyckel.

Tips

Om du skapar den här kravregeln manuellt i Konfigurationshanteraren konsolen väljer du följande alternativ:

  • Kategori: Anpassad
  • Villkor: Välj ett anpassat globalt villkor för datatypen Registernyckel
  • Regeltyp: Värde
  • Egenskap: Behörigheter

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 kravregelobjektet till parametrarna AddRequirement eller RemoveRequirement.

Mer information finns i Krav för distributionstyp och Skapa globala villkor.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägg till en kravregel för registernyckelbehörigheter

I det här exemplet används först cmdleten Get-CMGlobalCondition för att hämta ett anpassat globalt villkor. Sedan används cmdleten New-CMRegistryAccessControlEntry för att skapa två åtkomstkontrollposter för specifika användare. Därefter skapar den kravregelobjektet för att kontrollera att registernyckeln har de behörigheter som anges i åtkomstkontrollposterna. Slutligen skickar den regelobjektet till cmdleten Set-CMScriptDeploymentType för att lägga till kravet.

$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

Ange en matris med åtkomstkontrollpostobjekt. En åtkomstkontrollpost definierar specifika behörigheter för en viss användare eller grupp. Hämta det här objektet med cmdleten New-CMRegistryAccessControlEntry.

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

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

-Exclusive

Om den här parametern är måste den exakt matcha angiven ACE för att regeln ska vara $true kompatibel. Andra behörigheter för registernyckeln gör att regeln misslyckas.

Om det är inställt på måste den angivna ACE finnas för att regeln ska vara $false kompatibel, och även andra behörigheter kan finnas.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputObject

Ange ett anpassat globalt villkorsobjekt som ska användas som grund för den här kravregeln. Hämta det här objektet med hjälp av cmdleten Get-CMGlobalCondition.

Om du vill se en lista över tillgängliga globala villkor för registernyckeln på platsen använder du följande PowerShell-kommando:

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

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 Krav för distributionstyp Skapa globala villkor