Delen via

New-CMRequirementRuleFilePermissionValue

  • Artikel

SYNOPSIS

Maak een vereisteregel om bestandsmachtigingen te controleren.

SYNTAX

New-CMRequirementRuleFilePermissionValue -ControlEntry <FileSystemAccessControlEntry[]> [-Exclusive <Boolean>]
 [-InputObject] <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

Gebruik deze cmdlet om een vereisteregel te maken voor een toepassingsimplementatietype dat bestandsmachtigingen verifieert. Hiervoor is een aangepaste globale voorwaarde van het gegevenstype Bestand 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 Bestand
  • 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 bestandsmachtigingen toevoegen

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

$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

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

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

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. Eventuele andere machtigingen voor het bestand 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 bestandsvoorwaarden op de site te bekijken:

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

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-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 Vereisten voor implementatietype Globale voorwaarden maken