Condividi tramite

Get-AipServiceUserLog

  • Riferimento
Modulo:
AIPService

Scarica i log utente di protezione da Azure Information Protection nell'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 nella risorsa di 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 formato 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 quindi ottiene i log per tale 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 di come potrebbe essere necessario modificare i valori di DateTime per adattare 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 (in formato 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 delle 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 ora

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 utc -offset ora dall'ora locale prima di scaricare i log utente nella cartella C:\Logs.

Si è a Houston, Stati Uniti, che significa che l'ora locale del computer è UTC-6 e si desidera scaricare i log dal 2/2/2016 al 2/9/2016 per l'ora locale anziché utc.

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

Parametri

-Force

Indica che questo cmdlet viene sovrascritto, senza richiedere conferma, un file di log esistente per lo stesso intervallo di date o data.

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 di .

Se si specifica questo parametro ma non il 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 interruzione (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