Get-AipServiceDocumentLog
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.
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 |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |