New-CustomPermissions

Moduł:

PurviewInformationProtection

Tworzy zasady ochrony ad hoc dla uprawnień niestandardowych.

Składnia

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

Opis

Polecenie cmdlet New-CustomPermissions tworzy obiekt zasad ochrony ad hoc dla uprawnień niestandardowych przechowywanych jako zmienna, a następnie służy do ochrony pliku lub plików podczas uruchamiania polecenia cmdlet etykietowania Set-FileLabel.

Jeśli etykieta, która jest stosowana, jest skonfigurowana do ustawień ochrony, uprawnienia niestandardowe z zasad ochrony ad hoc zastępują ustawienia ochrony z etykiety.

Przykłady

Przykład 1 — tworzenie obiektu zasad ochrony ad hoc dla pojedynczego użytkownika

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

To polecenie tworzy obiekt zasad ochrony ad hoc, który przyznaje użytkownikowi user1 z contoso.com prawa użytkowania z uprawnień recenzenta i przechowuje te zasady w zmiennej o nazwie uprawnienia. Te zasady ochrony ad hoc mogą następnie służyć do stosowania ochrony do pliku lub plików.

Dla tego polecenia nie są wyświetlane żadne dane wyjściowe.

Przykład 2 — tworzenie obiektu zasad ochrony ad hoc dla wielu użytkowników i data wygaśnięcia

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

To polecenie tworzy obiekt zasad ochrony ad hoc, który przyznaje użytkownikom z różnych organizacji prawa użytkowania z uprawnień recenzenta, a także stosuje datę wygaśnięcia. Obiekt zasad ochrony ad hoc jest przechowywany w zmiennej o nazwie permissions, która następnie może służyć do zastosowania tej ochrony do pliku lub plików.

Dla tego polecenia nie są wyświetlane żadne dane wyjściowe.

Parametry

-ExpirationDate

Określa datę wygaśnięcia zasad ochrony ad hoc.

Po upływie tej daty wygaśnięcia określeni użytkownicy nie będą już mogli uzyskać dostępu do pliku lub plików. Jednak właściciel i administrator zawsze mogą uzyskać dostęp do pliku, nawet po osiągnięciu okresu wygaśnięcia.

Typ:	DateTime
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Permissions

Określa poziom uprawnień, który grupuje prawa użytkowania, które są zwykle używane razem. Użyj tego parametru i parametru Users , aby udzielić praw użytkowania określonym użytkownikom.

Aby sprawdzić, które indywidualne prawa użytkowania są uwzględniane w poszczególnych poziomach uprawnień, zobacz Prawa uwzględnione w poziomach uprawnień.

Typ:	Permissions
Dopuszczalne wartości:	Viewer, Reviewer, CoAuthor, CoOwner
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Users

Określa użytkowników, którzy będą mieć uprawnienia do korzystania z pliku lub plików. Użyj tego parametru i parametru Uprawnienia , aby udzielić praw określonym użytkownikom lub grupom.

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

None

Dane wyjściowe

System.Object