New-AIPCustomPermissions

Referens

Modul:: AzureInformationProtection

Relevant för: Endast AIP-klient för enhetlig etikettering

Skapar en ad hoc-skyddsprincip för anpassade behörigheter.

Syntax

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

Description

Cmdleten New-AIPCustomPermissions skapar ett ad hoc-skyddsprincipobjekt för anpassade behörigheter som du lagrar som en variabel och sedan använder för att skydda en fil eller filer när du kör cmdleten labeling, Set-AIPFileLabel.

Om etiketten som används har konfigurerats för skyddsinställningar ersätter de anpassade behörigheterna från ad hoc-skyddsprincipen skyddsinställningarna från etiketten.

Exempel

Exempel 1 – Skapa ett ad hoc-skyddsprincipobjekt för en enskild användare

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

Det här kommandot skapar ett ad hoc-skyddsprincipobjekt som beviljar user1 från contoso.com användningsrättigheter från granskarbehörigheterna och lagrar den här principen i en variabel med namnet permissions. Den här ad hoc-skyddsprincipen kan sedan användas för att tillämpa skydd på en fil eller filer.

Inga utdata visas för det här kommandot.

Exempel 2 – Skapa ett ad hoc-skyddsprincipobjekt för flera användare och som har ett förfallodatum

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

Det här kommandot skapar ett ad hoc-skyddsprincipobjekt som ger användare från olika organisationer användningsrättigheter från granskarbehörigheterna och som även tillämpar ett förfallodatum. Ad hoc-skyddsprincipobjektet lagras i en variabel med namnet permissions , som sedan kan användas för att tillämpa det här skyddet på en fil eller filer.

Inga utdata visas för det här kommandot.

Parametrar

-ExpirationDate

Anger ett förfallodatum för ad hoc-skyddsprincipen.

Efter det här förfallodatumet kommer de angivna användarna inte längre att kunna komma åt filen eller filerna. Ägaren och superanvändaren kan dock alltid komma åt filen, även efter att förfalloperioden har nåtts.

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

-Permissions

Anger en behörighetsnivå som grupperar användningsrättigheter som vanligtvis används tillsammans. Använd den här parametern och parametern Användare för att bevilja användningsrättigheter till angivna användare.

Information om vilka enskilda användningsrättigheter som ingår i varje behörighetsnivå finns i Rättigheter som ingår i behörighetsnivåer.

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

-Users

Anger användare som ska ha behörighet att använda filen eller filerna. Använd den här parametern och behörighetsparametern för att bevilja rättigheter till angivna användare eller grupper.

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

Indata

None

Utdata

System.Object

Set-AIPFileLabel