Get-AipServiceUserLog
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 10Questo 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Specifica un percorso esistente della cartella in cui salvare i log.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |