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