New-CustomPermissions

Referenz

Modul:: PurviewInformationProtection

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

Syntax

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

Beschreibung

Das Cmdlet New-CustomPermissions 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 Bezeichnungs-Cmdlet Set-FileLabel ausführen.

Wenn die angewendete Bezeichnung für Schutzeinstellungen 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-CustomPermissions -Users user1@contoso.com -Permissions Viewer

Mit diesem Befehl wird ein Ad-hoc-Schutzrichtlinienobjekt erstellt, das user1 aus contoso.com Nutzungsrechte über die Prüferberechtigungen gewährt und diese Richtlinie in einer Variablen mit dem Namen Berechtigungen speichert. Diese Ad-hoc-Schutzrichtlinie kann dann verwendet werden, um den 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 mit einem Ablaufdatum

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

Mit diesem Befehl wird ein Ad-hoc-Schutzrichtlinienobjekt erstellt, das Benutzern aus verschiedenen Organisationen Nutzungsrechte über die Prüferberechtigungen gewährt und außerdem ein Ablaufdatum anwendet. Das Ad-hoc-Schutzrichtlinienobjekt wird in einer Variablen mit dem Namen Berechtigungen gespeichert, die dann verwendet werden kann, 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 die Dateien zugreifen. Der Besitzer und ein Superbenutzer können jedoch immer auf die Datei zugreifen, auch wenn der Ablaufzeitraum erreicht ist.

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

-Permissions

Gibt eine Berechtigungsstufe an, die Nutzungsrechte gruppiert, die normalerweise zusammen verwendet werden. Verwenden Sie diesen Parameter und den Parameter Users , um angegebenen Benutzern Nutzungsrechte zu erteilen.

Informationen dazu, 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 zur Verwendung der Datei oder der Dateien verfügen. Verwenden Sie diesen Parameter und den Berechtigungsparameter , um 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

Freigeben über