New-CustomPermissions

Referens

Modul:: PurviewInformationProtection

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

Syntax

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

Description

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

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-CustomPermissions -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-CustomPermissions -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.

Typ:	DateTime
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	Permissions
Godkända värden:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

System.Object

Dela via