Get-AipServiceUserLog
Laddar ned användarloggar för skydd från Azure Information Protection till lokal lagring.
Syntax
Get-AipServiceUserLog
-Path <String>
[-FromDate <DateTime>]
[-ToDate <DateTime>]
[-ForDate <DateTime>]
[-Force]
[-NumberOfThreads <Int32>]
[<CommonParameters>] Description
Cmdleten Get-AipServiceUserLog laddar ned användarloggar för skydd till lokal lagring. Du måste ange antingen ett visst datum eller ett datumintervall för att ladda ned loggposterna.
Du måste använda PowerShell för att hämta dessa användarloggar. du kan inte utföra den här åtgärden med hjälp av en hanteringsportal.
När du kör det här kommandot och endast anger ett datum för DateTime-objekten antas tiden vara 00:00:00 i din lokala tid och sedan konverteras till UTC.
När du anger en tid med ett datum (till exempel -ForDate '2/1/2016 15:00:00'), konverteras datumet och tiden till UTC. Kommandot Get-AipServiceUserLog hämtar sedan loggarna för den UTC-tidsperioden. Användningsloggar är endast tillgängliga när "datum"-fältnamnet innehåller ett värde för ett tidigare datum (i UTC-tid). Användningsloggar från det aktuella datumet är inte tillgängliga.
Se exemplen för hur du kan behöva ändra dina DateTime-värden för att hantera den konvertering som behövs för din lokala tid.
Mer information om användningsloggning för skydd och ett steg-för-steg-exempel finns i Loggning och analys av skyddsanvändning från Azure In formation Protection.
Exempel
Exempel 1: Hämta användarloggar för ett datumintervall
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '12/12/2015' -ToDate '12/15/2015' -NumberOfThreads 10Det här kommandot laddar ned användarloggar som skapats mellan 2015-12-12 och 2015-12-15 (i UTC-tid) till mappen C:\Logs.
Kommandot använder 10 trådar för att ladda ned loggarna.
Exempel 2: Hämta användarloggar för ett datum
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '12/5/2015'Det här kommandot laddar ned användarloggarna för 2015-12-05 (i UTC-tid) till mappen C:\Logs.
Exempel 3: Hämta användarloggar för ett datum, med hänsyn till en UTC +förskjutningstidskonvertering
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -ForDate '2/2/2016 12:00:00'Det här kommandot visar hur du kan behöva ta hänsyn till en UTC +förskjutningstidskonvertering från din lokala tid innan du laddar ned användarloggar till mappen C:\Logs.
Du befinner dig i Nya Zeeland, vilket innebär att datorns lokala tid är UTC+12 och du vill ladda ned loggar för 2016-02-02 för din lokala tid i stället för UTC. Om du inte angav tiden 12:00:00 med datumet innehåller loggarna endast data för de första 12 timmarna 2016-02-02 (och de senaste 12 timmarna föregående dag).
Exempel 4: Hämta användarloggar för ett datumintervall med hänsyn till en UTC-förskjutningstidskonvertering
PS C:\>Get-AipServiceUserLog -Path 'C:\Logs' -FromDate '2/1/2016 18:00:00' -ToDate '2/9/15/2016 18:00:00'Det här kommandot visar hur du kan behöva ta hänsyn till en UTC-förskjutningstidskonvertering från din lokala tid innan du laddar ned användarloggar till mappen C:\Logs.
Du befinner dig i Houston, USA, vilket innebär att datorns lokala tid är UTC-6 och du vill ladda ned loggar från 2016-02-02 till 2016-02-09 för din lokala tid i stället för UTC.
Om du inte angav föregående datum och tid på 18:00:00 skulle dina loggar sakna data under de första 6 timmarna 2016-02-02 (och ytterligare 6 timmar för slutdatumet).
Parametrar
-Force
Anger att denna cmdlet skriver över, utan att fråga efter bekräftelse, en befintlig loggfil för samma datum- eller datumintervall.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForDate
Anger ett datum (och eventuellt en tid) för loggfilen som ett DateTime-objekt .
Använd den här parametern när du inte använder parametern FromDate .
Om du vill hämta ett DateTime-objekt använder du cmdleten Get-Date .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FromDate
Anger startdatum (och eventuellt en tid) för loggfilen som ett DateTime-objekt .
Använd den här parametern när du inte använder parametern ForDate .
Om du anger den här parametern men inte ToDate är slutdatumet den dag då du kör kommandot.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NumberOfThreads
Anger antalet trådar som ska användas för att ladda ned loggar.
Godkända värden för den här parametern är: 1–32.
Standardvärdet är 3.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Anger en befintlig sökväg till mappen där loggarna ska sparas.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ToDate
Anger stoppdatum (och eventuellt en tid) för loggfilen som ett DateTime-objekt .
Du kan också ange den här parametern när du använder parametern FromDate för att ange ett specifikt datumintervall. Om du inte anger den här parametern när du använder parametern FromDate är slutdatumet den dag då du kör kommandot.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |