New-CMRequirementRuleFilePermissionValue

  • Artykuł

SYNOPSIS

Utwórz regułę wymagania w celu zweryfikowania uprawnień do pliku.

SYNTAX

New-CMRequirementRuleFilePermissionValue -ControlEntry <FileSystemAccessControlEntry[]> [-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 do plików. Wymaga to niestandardowego warunku globalnego typu danych Plik.

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 Plik
  • 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ń do plików

W tym przykładzie najpierw użyto polecenia cmdlet Get-CMGlobalCondition w celu uzyskania niestandardowego warunku globalnego. Następnie używa polecenia cmdlet New-CMFileSystemAccessControlEntry 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 plik 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 data file"

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

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

$myRule = New-CMRequirementRuleFilePermissionValue -GlobalCondition $myGC -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-CMFileSystemAccessControlEntry.

Type: FileSystemAccessControlEntry[]
Parameter Sets: (All)
Aliases: ControlEntries, FileSystemAccessControlEntry, FileSystemAccessControlEntries

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 pliku 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ę dostępnych warunków globalnych pliku w lokacji, użyj następującego polecenia programu PowerShell:

Get-CMGlobalCondition | Where-Object DataType -eq "File" | 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-CMFileSystemAccessControlEntry New-CMRequirementRuleActiveDirectorySiteValue New-CMRequirementRuleBooleanValue New-CMRequirementRuleCMSiteValue New-CMRequirementRuleCommonValue New-CMRequirementRuleDeviceOwnershipValue New-CMRequirementRuleExistential New-CMRequirementRuleExpression New-CMRequirementRuleFileAttributeValue New-CMRequirementRuleFreeDiskSpaceValue New-CMRequirementRuleInputTypeValue New-CMRequirementRuleOperatingSystemLanguageValue New-CMRequirementRuleOperatingSystemValue New-CMRequirementRuleoUValue New-CMRequirementRuleRegistryKeyPermissionValue New-CMRequirementRuleScreenResolutionValue Get-CMGlobalCondition Wymagania dotyczące typu wdrożenia Tworzenie warunków globalnych