Share via

New-AIPCustomPermissions

  • Referentie
Module:
AzureInformationProtection

Relevant voor: Alleen geïntegreerde AIP-labelclient

Hiermee maakt u een ad-hocbeveiligingsbeleid voor aangepaste machtigingen.

Syntax

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Description

De cmdlet New-AIPCustomPermissions maakt een ad-hoc beveiligingsbeleidsobject voor aangepaste machtigingen die u opslaat als variabele en gebruikt vervolgens om een bestand of bestanden te beveiligen wanneer u de labeling-cmdlet Set-AIPFileLabel uitvoert.

Als het toegepaste label is geconfigureerd voor beveiligingsinstellingen, vervangen de aangepaste machtigingen van het ad-hocbeveiligingsbeleid de beveiligingsinstellingen van het label.

Voorbeelden

Voorbeeld 1: een ad-hoc beveiligingsbeleidsobject maken voor één gebruiker

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Met deze opdracht maakt u een ad-hoc beveiligingsbeleidsobject dat gebruiker1 uit contoso.com gebruiksrechten van de revisormachtigingen verleent en dit beleid opslaat in een variabele met de naam machtigingen. Dit ad-hoc beveiligingsbeleid kan vervolgens worden gebruikt om beveiliging toe te passen op een bestand of bestanden.

Er wordt geen uitvoer weergegeven voor deze opdracht.

Voorbeeld 2: een ad-hoc beveiligingsbeleidsobject maken voor meerdere gebruikers en die een vervaldatum heeft

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

Met deze opdracht maakt u een ad-hoc beveiligingsbeleidsobject waarmee gebruikers van verschillende organisaties gebruiksrechten van de revisormachtigingen worden verleend en die ook een vervaldatum toepast. Het ad-hoc beveiligingsbeleidsobject wordt opgeslagen in een variabele met de naam machtigingen, die vervolgens kunnen worden gebruikt om deze beveiliging toe te passen op een bestand of bestanden.

Er wordt geen uitvoer weergegeven voor deze opdracht.

Parameters

-ExpirationDate

Hiermee geeft u een vervaldatum voor het ad-hocbeveiligingsbeleid.

Na deze vervaldatum hebben de opgegeven gebruikers geen toegang meer tot het bestand of de bestanden. De eigenaar en een supergebruiker hebben echter altijd toegang tot het bestand, zelfs nadat de vervaldatum is bereikt.

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

-Permissions

Hiermee geeft u een machtigingsniveau op dat gebruiksrechten groepeert die doorgaans samen worden gebruikt. Gebruik deze parameter en de parameter Users om gebruiksrechten te verlenen aan opgegeven gebruikers.

Als u wilt zien welke afzonderlijke gebruiksrechten zijn opgenomen in elk van de machtigingsniveaus, raadpleegt u Rechten die zijn opgenomen in machtigingsniveaus.

Type:Permissions
Accepted values:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Users

Hiermee geeft u gebruikers op die rechten hebben om het bestand of de bestanden te gebruiken. Gebruik deze parameter en de machtigingsparameter om rechten te verlenen aan opgegeven gebruikers of groepen.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

Uitvoerwaarden

System.Object