Get-AipServiceDocumentLog

Referensi

Modul:: AIPService

Mendapatkan informasi perlindungan tentang dokumen yang dilacak oleh Azure Information Protection.

Cmdlet ini didukung oleh Azure Information Protection klien pelabelan klasik dan terpadu, dengan penggunaan yang berbeda, seperti yang dijelaskan di bawah ini.

Sintaks

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AIPServiceDocumentLog menjalankan kueri untuk mengembalikan informasi perlindungan tentang dokumen yang dilacak.

Informasi yang dikembalikan meliputi:

ID konten dokumen, dengan nama dokumen jika tersedia.
Pemilik Rights Management dan penerbit Rights Management.
Pengguna dan grup yang diberikan akses.
ID templat perlindungan atau hak penggunaan tertentu yang melindungi dokumen.
Pengaturan kedaluwarsa, akses offline, atau pencabutan apa pun.

Anda dapat menentukan waktu mulai dan waktu berhenti entri untuk disertakan. Output dikembalikan sebagai daftar objek PowerShell di konsol PowerShell.

Untuk informasi selengkapnya, lihat Pemilik Manajemen Hak dan penerbit IRights Management.

Saat digunakan dengan klien pelabelan terpadu, kueri didasarkan pada nama dokumen, email pemilik, atau keduanya.

Anda harus menentukan setidaknya salah satu parameter berikut:

ContentName
Pemilik

Tip

Jika Anda menggunakan parameter ContentName , kami sarankan Anda juga menggunakan parameter FromTime dan ToTime untuk memfilter konten Anda ke periode waktu tertentu.

Contoh

Contoh 1: (Hanya klien pelabelan terpadu) Dapatkan informasi perlindungan tentang semua dokumen yang dilacak dengan nama file tertentu, yang dilindungi dalam jangka waktu tertentu

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Perintah ini menjalankan kueri dan mengembalikan informasi perlindungan tentang semua dokumen terlacak yang disimpan di penyewa Anda dengan nama file test.docx, yang dilindungi pada Desember 2020.

Contoh 2: (Hanya klien pelabelan terpadu) Dapatkan informasi perlindungan tentang semua dokumen yang dilacak dengan nama file dan pemilik tertentu, yang dilindungi dalam jangka waktu tertentu

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Perintah ini menjalankan kueri dan mengembalikan informasi perlindungan tentang semua dokumen terlacak yang disimpan di penyewa Anda yang cocok dengan detail berikut:

Nama file test.docx
File dilindungi oleh pengguna dengan email alice@contoso.com
File ini dilindungi pada Desember 2020.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentName

Menentukan nama lengkap dokumen yang dilacak, termasuk ekstensi file.

Jika Anda memiliki klien pelabelan terpadu, Anda harus menyertakan parameter ini, atau parameter Pemilik , atau Anda dapat menyertakan keduanya.

Tip

Jika Anda menggunakan parameter ini, kami sarankan Anda juga menggunakan filter tanggal FromTime dan ToTime untuk memfilter data yang dikembalikan.

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

-FromTime

Menentukan waktu mulai (inklusif) untuk file log sebagai objek DateTime . Untuk mendapatkan objek DateTime , gunakan cmdlet Get-Date . Tentukan tanggal dan waktu sesuai dengan pengaturan lokal sistem Anda.

Untuk informasi selengkapnya, ketik Get-Help Get-Date.

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

-Owner

Menentukan alamat email pengguna yang melindungi dokumen (penerbit atau pemilik Rights Management).

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

-ToTime

Menentukan waktu berhenti (inklusif) untuk file log sebagai objek DateTime . Untuk mendapatkan objek DateTime , gunakan cmdlet Get-Date . Tentukan tanggal dan waktu sesuai dengan pengaturan lokal sistem Anda.