New-CMRequirementRuleRegistryKeyPermissionValue

Artykuł
08/12/2021

SYNOPSIS

Utwórz regułę wymagania w celu zweryfikowania uprawnień klucza rejestru.

SYNTAX

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

DESCRIPTION

To polecenie cmdlet umożliwia utworzenie reguły wymagania dla typu wdrożenia aplikacji, która weryfikuje uprawnienia klucza rejestru. Wymaga ona niestandardowego warunku globalnego typu danych Klucz rejestru.

Porada

Dla porównania, jeśli ręcznie utworzysz tę regułę wymagania w Menedżer konfiguracji, wybierz następujące opcje:

Kategoria: Niestandardowe
Warunek: wybierz niestandardowy warunek globalny typu danych Klucz rejestru
Typ reguły: Wartość
Właściwość: Uprawnienia

Po użyciu tego polecenia cmdlet użyj jednego z add- lub set- polecenia cmdlet dla typów wdrożeń. Przekaż ten obiekt reguły wymagania do parametrów AddRequirement lub RemoveRequirement.

Aby uzyskać więcej informacji, zobacz Wymagania dotyczące typu wdrożenia i Tworzenie warunków globalnych.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Dodawanie reguły wymagania dla uprawnień klucza rejestru

W tym przykładzie najpierw użyto polecenia cmdlet Get-CMGlobalCondition w celu uzyskania niestandardowego warunku globalnego. Następnie używa polecenia cmdlet New-CMRegistryAccessControlEntry do utworzenia dwóch wpisów kontroli dostępu dla określonych użytkowników. Następnie tworzy obiekt reguły wymagania w celu sprawdzenia, czy klucz rejestru ma uprawnienia określone we wpisach kontroli dostępu. Na koniec przekazuje ten obiekt reguły do polecenia cmdlet Set-CMScriptDeploymentType, aby dodać wymaganie.

$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

Określ tablicę obiektów wpisów kontroli dostępu. Wpis kontroli dostępu definiuje określone uprawnienia dla określonego użytkownika lub grupy. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Exclusive

Jeśli ten parametr ma wartość , aby reguła była zgodna, musi dokładnie odpowiadać $true podanej wartości ACE. Wszelkie inne uprawnienia do klucza rejestru powodują niepowodzenie reguły.

Jeśli ustawiono wartość , aby reguła jest zgodna, określony ace musi istnieć i mogą istnieć $false również inne uprawnienia.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Określ niestandardowy obiekt warunku globalnego, który ma być podstawą dla tej reguły wymagania. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMGlobalCondition.

Aby wyświetlić listę warunków globalnych klucza rejestru dostępnych w lokacji, użyj następującego polecenia programu PowerShell:

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

UWAGI

New-CMRegistryAccessControlEntry