New-AIPCustomPermissions

Relevan untuk: Hanya klien pelabelan terpadu AIP

Membuat kebijakan perlindungan ad-hoc untuk izin kustom.

Sintaks

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

Deskripsi

Cmdlet New-AIPCustomPermissions membuat objek kebijakan perlindungan ad-hoc untuk izin kustom yang Anda simpan sebagai variabel lalu gunakan untuk melindungi file atau file saat Anda menjalankan cmdlet pelabelan, Set-AIPFileLabel.

Jika label yang diterapkan dikonfigurasi untuk pengaturan perlindungan, izin kustom dari kebijakan perlindungan ad-hoc menggantikan pengaturan perlindungan dari label.

Contoh

Contoh 1 - Membuat objek kebijakan perlindungan ad-hoc untuk satu pengguna

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

Perintah ini membuat objek kebijakan perlindungan ad-hoc yang memberikan pengguna1dari contoso.com hak penggunaan dari izin Peninjau dan menyimpan kebijakan ini dalam variabel bernama izin. Kebijakan perlindungan ad-hoc ini kemudian dapat digunakan untuk menerapkan perlindungan ke file atau file.

Tidak ada output yang ditampilkan untuk perintah ini.

Contoh 2 - Membuat objek kebijakan perlindungan ad-hoc untuk beberapa pengguna dan yang memiliki tanggal kedaluwarsa

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

Perintah ini membuat objek kebijakan perlindungan ad-hoc yang memberi pengguna hak penggunaan organisasi yang berbeda dari izin Peninjau, dan juga menerapkan tanggal kedaluwarsa. Objek kebijakan perlindungan ad-hoc disimpan dalam variabel bernama izin, yang kemudian dapat digunakan untuk menerapkan perlindungan ini ke file atau file.

Tidak ada output yang ditampilkan untuk perintah ini.

Parameter

-ExpirationDate

Menentukan tanggal kedaluwarsa untuk kebijakan perlindungan ad-hoc.

Setelah tanggal kedaluwarsa ini, pengguna yang ditentukan tidak akan lagi dapat mengakses file atau file. Namun, pemilik dan pengguna super selalu dapat mengakses file, bahkan setelah periode kedaluwarsa tercapai.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Permissions

Menentukan tingkat izin yang mengelompokkan hak penggunaan yang biasanya digunakan bersama-sama. Gunakan parameter ini dan parameter Pengguna untuk memberikan hak penggunaan kepada pengguna tertentu.

Untuk melihat hak penggunaan individual mana yang disertakan dalam setiap tingkat izin, lihat Hak yang disertakan dalam tingkat izin.

Type:Permissions
Accepted values:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Users

Menentukan pengguna yang akan memiliki hak untuk menggunakan file atau file. Gunakan parameter ini dan parameter Izin untuk memberikan hak kepada pengguna atau grup tertentu.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

System.Object