New-CustomPermissions
Erstellt eine Ad-hoc-Schutzrichtlinie für benutzerdefinierte Berechtigungen.
Syntax
Default (Standard)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
Beschreibung
Das Cmdlet New-CustomPermissions erstellt ein Ad-hoc-Schutzrichtlinienobjekt für benutzerdefinierte Berechtigungen, das Sie als Variable speichern und dann zum Schützen einer oder mehrerer Dateien verwenden, 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 Verwendungsrechten aus den Prüferberechtigungen erteilt und diese Richtlinie in einer Variablen mit dem Namen permissions speichert. Diese Ad-hoc-Schutzrichtlinie kann dann verwendet werden, um Schutz auf eine oder mehrere 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 aus den Prüferberechtigungen gewährt und ein Ablaufdatum anwendet. Das Ad-hoc-Schutzrichtlinienobjekt wird in einer Variablen mit dem Namen permissions gespeichert, die dann verwendet werden kann, um diesen Schutz auf eine oder mehrere 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(en) zugreifen. Der Eigentümer und ein Superuser können jedoch immer auf die Datei zugreifen, auch wenn die Ablauffrist erreicht ist.
Parametereigenschaften
| Typ: | DateTime |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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 Verwendungsrechte zu gewähren.
Informationen zu den einzelnen Nutzungsrechten, die in den einzelnen Berechtigungsstufen enthalten sind, finden Sie unter In Berechtigungsstufen enthaltene Rechte.
Parametereigenschaften
| Typ: | Permissions |
| Standardwert: | None |
| Zulässige Werte: | Viewer, Reviewer, CoAuthor, CoOwner |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Users
Gibt Benutzer an, die über Rechte zur Verwendung der Datei(en) verfügen. Verwenden Sie diesen Parameter und den Permission-Parameter , um bestimmten Benutzern oder Gruppen Rechte zu erteilen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |