Freigeben über

New-AIPCustomPermissions

  • Referenz
Modul:
AzureInformationProtection

Relevant für: Nur AIP-einheitlichen Bezeichnungsclient

Erstellt eine Ad-hoc-Schutzrichtlinie für benutzerdefinierte Berechtigungen.

Syntax

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

Beschreibung

Das Cmdlet New-AIPCustomPermissions erstellt ein Ad-hoc-Schutzrichtlinienobjekt für benutzerdefinierte Berechtigungen, die Sie als Variable speichern und dann verwenden, um eine Datei oder Dateien zu schützen, wenn Sie das Cmdlet "Bezeichnung" ausführen, "Set-AIPFileLabel".

Wenn die Bezeichnung, die für Schutzeinstellungen angewendet wird, konfiguriert ist, ersetzen die benutzerdefinierten Berechtigungen aus der Ad-hoc-Schutzrichtlinie die Schutzeinstellungen aus der Bezeichnung.

Beispiele

Beispiel 1 : Erstellen eines Ad-hoc-Schutzrichtlinienobjekts für einen einzelnen Benutzer

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

Dieser Befehl erstellt ein Ad-hoc-Schutzrichtlinienobjekt, das Benutzer1 aus contoso.com Nutzungsrechten aus den Berechtigungen des Prüfers gewährt und diese Richtlinie in einer Variablen namens Berechtigungen speichert. Diese Ad-hoc-Schutzrichtlinie kann dann verwendet werden, um Schutz auf eine Datei oder Dateien anzuwenden.

Für diesen Befehl wird keine Ausgabe angezeigt.

Beispiel 2 : Erstellen eines Ad-hoc-Schutzrichtlinienobjekts für mehrere Benutzer und mit Ablaufdatum

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

Dieser Befehl erstellt ein Ad-hoc-Schutzobjekt, das Benutzern von verschiedenen Organisationen Nutzungsrechte aus den Berechtigungen des Prüfers gewährt, und wendet auch ein Ablaufdatum an. Das Ad-hoc-Schutzrichtlinienobjekt wird in einer Variablen namens Berechtigungen gespeichert, die dann verwendet werden können, um diesen Schutz auf eine Datei oder Dateien anzuwenden.

Für diesen Befehl wird keine Ausgabe angezeigt.

Parameter

-ExpirationDate

Gibt ein Ablaufdatum für die Ad-hoc-Schutzrichtlinie an.

Nach diesem Ablaufdatum können die angegebenen Benutzer nicht mehr auf die Datei oder Dateien zugreifen. Der Besitzer und ein Superbenutzer können jedoch immer auf die Datei zugreifen, auch nachdem der Ablaufzeitraum erreicht wurde.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Permissions

Gibt eine Berechtigungsstufe an, auf der Nutzungsrechte gruppiert werden, die normalerweise zusammen verwendet werden. Verwenden Sie diesen Parameter und den Parameter "Benutzer ", um den angegebenen Benutzern Nutzungsrechte zu gewähren.

Um zu sehen, welche einzelnen Nutzungsrechte in den einzelnen Berechtigungsstufen enthalten sind, finden Sie unter "Rechte", die in Berechtigungsstufen enthalten sind.

Typ:Permissions
Zulässige Werte:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Users

Gibt Benutzer an, die über Rechte zum Verwenden der Datei oder Dateien verfügen. Verwenden Sie diesen Parameter und den Berechtigungsparameter , um den angegebenen Benutzern oder Gruppen Rechte zu gewähren.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object