Get-AipServiceUserLog

Mengunduh log pengguna perlindungan dari Azure Information Protection ke penyimpanan lokal.

Sintaks

Get-AipServiceUserLog
   -Path <String>
   [-FromDate <DateTime>]
   [-ToDate <DateTime>]
   [-ForDate <DateTime>]
   [-Force]
   [-NumberOfThreads <Int32>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AipServiceUserLog mengunduh log pengguna perlindungan ke penyimpanan lokal. Anda harus menentukan tanggal atau rentang tanggal tertentu untuk mengunduh entri log.

Anda harus menggunakan PowerShell untuk mendapatkan log pengguna ini; Anda tidak dapat melakukan tindakan ini dengan menggunakan portal manajemen.

Saat Anda menjalankan perintah ini dan menentukan tanggal hanya untuk objek DateTime , waktu diasumsikan adalah 00:00:00 di waktu lokal Anda, lalu dikonversi ke UTC.

Saat Anda menentukan waktu dengan tanggal (misalnya, -ForDate '2/1/2016 15:00:00'), tanggal dan waktu tersebut dikonversi ke UTC. Perintah Get-AipServiceUserLog kemudian mendapatkan log untuk periode waktu UTC tersebut. Log penggunaan hanya tersedia ketika nama bidang "tanggal" berisi nilai tanggal sebelumnya (dalam waktu UTC). Log penggunaan dari tanggal saat ini tidak tersedia.

Lihat contoh bagaimana Anda mungkin perlu mengubah nilai DateTime , untuk mengakomodasi konversi yang diperlukan untuk waktu lokal Anda.

Untuk informasi selengkapnya tentang pengelogan penggunaan perlindungan dan contoh langkah demi langkah, lihat Mencatat dan menganalisis penggunaan perlindungan dari Azure In Formion Protection.

Contoh

Contoh 1: Mendapatkan log pengguna untuk rentang tanggal

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10

Perintah ini mengunduh log pengguna yang dibuat antara 12/12/2015 dan 15/12/2015 (dalam waktu UTC) ke folder C:\Logs.

Perintah menggunakan 10 utas untuk mengunduh log.

Contoh 2: Mendapatkan log pengguna untuk tanggal

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'

Perintah ini mengunduh log pengguna untuk 5/12/2015 (dalam waktu UTC) ke folder C:\Logs.

Contoh 3: Mendapatkan log pengguna untuk tanggal, dengan mempertimbangkan konversi waktu UTC +offset

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'

Perintah ini menunjukkan bagaimana Anda mungkin perlu mempertimbangkan konversi waktu UTC +offset dari waktu lokal Anda, sebelum mengunduh log pengguna ke folder C:\Logs.

Anda berada di Selandia Baru, yang berarti waktu lokal komputer Anda adalah UTC+12 dan Anda ingin mengunduh log untuk 2/2/2016 untuk waktu lokal Anda daripada UTC. Jika Anda tidak menentukan waktu 12:00:00 dengan tanggal, log Anda hanya akan berisi data selama 12 jam pertama 2/2/2016 (dan 12 jam terakhir dari hari sebelumnya).

Contoh 4: Mendapatkan log pengguna untuk rentang tanggal, dengan mempertimbangkan konversi waktu UTC -offset

PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'

Perintah ini menunjukkan bagaimana Anda mungkin perlu mempertimbangkan konversi waktu UTC -offset dari waktu lokal Anda sebelum mengunduh log pengguna ke folder C:\Logs.

Anda berada di Houston, AS, yang berarti waktu lokal komputer Anda adalah UTC-6 dan Anda ingin mengunduh log dari 2/2/2016 hingga 2/9/2016 untuk waktu lokal Anda daripada UTC.

Jika Anda tidak menentukan tanggal dan waktu 18:00:00 sebelumnya, log Anda akan kehilangan data selama 6 jam pertama 2/2/2016 waktu lokal Anda (dan 6 jam tambahan untuk tanggal berakhir).

Parameter

-Force

Menunjukkan bahwa cmdlet ini menimpa, tanpa meminta konfirmasi, file log yang ada untuk tanggal atau rentang tanggal yang sama.

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

-ForDate

Menentukan tanggal (dan secara opsional, waktu) untuk file log sebagai objek DateTime .

Gunakan parameter ini saat Anda tidak menggunakan parameter FromDate .

Untuk mendapatkan objek DateTime , gunakan cmdlet Get-Date .

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

-FromDate

Menentukan tanggal mulai (dan secara opsional, waktu) untuk file log sebagai objek DateTime .

Gunakan parameter ini saat Anda tidak menggunakan parameter ForDate .

Jika Anda menentukan parameter ini tetapi bukan ToDate, tanggal selesainya adalah hari Anda menjalankan perintah.

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

-NumberOfThreads

Menentukan jumlah utas yang akan digunakan untuk mengunduh log.

Nilai yang dapat diterima untuk parameter ini adalah: 1-32.

Nilai defaultnya adalah 3.

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

-Path

Menentukan jalur folder yang ada untuk menyimpan log.

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

-ToDate

Menentukan tanggal berhenti (dan secara opsional, waktu) untuk file log sebagai objek DateTime .

Secara opsional, tentukan parameter ini saat Anda menggunakan parameter FromDate , untuk menentukan rentang tanggal tertentu. Jika Anda tidak menentukan parameter ini saat menggunakan parameter FromDate , tanggal akhir adalah hari Anda menjalankan perintah.

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