Get-AipServiceUserLog

  • Riferimento
Modulo:
AIPService

Scarica i log utente di protezione da Azure Information Protection all'archiviazione locale.

Sintassi

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

Descrizione

Il cmdlet Get-AipServiceUserLog scarica i log utente di protezione nell'archiviazione locale. È necessario specificare una data specifica o un intervallo di date per scaricare le voci di log.

È necessario usare PowerShell per ottenere questi log utente; non è possibile eseguire questa azione usando un portale di gestione.

Quando si esegue questo comando e si specifica una data solo per gli oggetti DateTime , si presuppone che l'ora sia 00:00:00 nell'ora locale e quindi convertita in utc.

Quando si specifica un'ora con una data (ad esempio , -ForDate '2/1/2016 15:00:00'), tale data e ora viene convertita in formato UTC. Il comando Get-AipServiceUserLog ottiene quindi i log per il periodo di tempo UTC. I log di utilizzo sono disponibili solo quando il nome del campo "date" contiene un valore di una data precedente (in ora UTC). I log di utilizzo dalla data corrente non sono disponibili.

Vedere gli esempi per informazioni su come potrebbe essere necessario modificare i valori DateTime per soddisfare la conversione necessaria per l'ora locale.

Per altre informazioni sulla registrazione dell'utilizzo della protezione e un esempio dettagliato, vedere Registrazione e analisi dell'utilizzo della protezione da Azure In formation Protection.

Esempio

Esempio 1: Ottenere i log utente per un intervallo di date

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

Questo comando scarica i log utente creati tra il 12/12/2015 e il 15/12/2015 (in ora UTC) nella cartella C:\Logs.

Il comando usa 10 thread per scaricare i log.

Esempio 2: Ottenere i log utente per una data

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

Questo comando scarica i log utente per il 5/12/2015 (ora UTC) nella cartella C:\Logs.

Esempio 3: Ottenere i log utente per una data, tenendo conto di una conversione UTC +offset time

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

Questo comando mostra come potrebbe essere necessario prendere in considerazione una conversione UTC +offset dell'ora dall'ora locale, prima di scaricare i log utente nella cartella C:\Logs.

Si è in Nuova Zelanda, il che significa che l'ora locale del computer è UTC +12 e si desidera scaricare i log per il 2/2/2016 per l'ora locale anziché utc. Se non è stata specificata l'ora 12:00:00 con la data, i log contengono dati solo per le prime 12 ore del 2/2/2016 (e le ultime 12 ore del giorno precedente).

Esempio 4: Ottenere i log utente per un intervallo di date, tenendo conto di una conversione utc -offset time

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

Questo comando mostra come potrebbe essere necessario prendere in considerazione una conversione dell'ora UTC -offset dall'ora locale prima di scaricare i log utente nella cartella C:\Logs.

Ci si trova a Houston, USA, il che significa che l'ora locale del computer è UTC-6 e si desidera scaricare i log dal 2/2/2016 al 2/02/2016 per l'ora locale anziché utc.

Se non è stata specificata la data e l'ora precedenti delle 18.00.00, i log mancano i dati per le prime 6 ore del 2/2/2016 dell'ora locale (e altre 6 ore per la data di fine).

Parametri

-Force

Indica che questo cmdlet sovrascrive, senza richiedere conferma, un file di log esistente per la stessa data o intervallo di date.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForDate

Specifica una data (e, facoltativamente, un'ora) per il file di log come oggetto DateTime .

Usare questo parametro quando non si usa il parametro FromDate .

Per ottenere un oggetto DateTime , utilizzare il cmdlet Get-Date .

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FromDate

Specifica la data di inizio (e, facoltativamente, un'ora) per il file di log come oggetto DateTime .

Usare questo parametro quando non si usa il parametro ForDate .

Se si specifica questo parametro ma non toDate, la data di fine è il giorno in cui si esegue il comando.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NumberOfThreads

Specifica il numero di thread da usare per scaricare i log.

I valori accettabili per questo parametro sono: 1-32.

Il valore predefinito è 3.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica un percorso esistente della cartella in cui salvare i log.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ToDate

Specifica la data di arresto (e, facoltativamente, un'ora) per il file di log come oggetto DateTime .

Facoltativamente, specificare questo parametro quando si usa il parametro FromDate per specificare un intervallo di date specifico. Se non si specifica questo parametro quando si usa il parametro FromDate , la data di fine è il giorno in cui si esegue il comando.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False