Dela via

Get-AipServiceUserLog

  • Referens
Modul:
AIPService

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 specifikt 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 gö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- objekt 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 datum och tid till UTC. Kommandot Get-AipServiceUserLog hämtar sedan loggarna för den UTC-tidsperioden. Användningsloggar är endast tillgängliga när fältnamnet "datum" 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 på hur du kan behöva ändra dina DateTime- värden för att anpassa 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 10

Det här kommandot laddar ned användarloggar som skapats mellan 12/12/2015 och 12/15/2015 (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-05-12 (i UTC-tid) till mappen C:\Logs.

Exempel 3: Hämta användarloggar för ett datum, med hänsyn till en UTC +offset-tidskonvertering

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 +offset-tidskonvertering från din lokala tid innan du laddar ned användarloggar till mappen C:\Logs.

Du är i Nya Zeeland, vilket innebär att datorns lokala tid är UTC+12 och du vill ladda ned loggar för 2/2/2016 för din lokala tid i stället för UTC. Om du inte angav tidpunkten för 12:00:00 med datumet skulle loggarna endast innehålla data för de första 12 timmarna 2016-02-02 (och de sista 12 timmarna föregående dag).

Exempel 4: Hämta användarloggar för ett datumintervall med hänsyn till en UTC--offset tidskonvertering

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--offset tidskonvertering från din lokala tid innan du laddar ned användarloggar till mappen C:\Logs.

Du är i Houston, USA, vilket innebär att datorns lokala tid är UTC-6 och du vill ladda ned loggar från 2/2/2016 till 2/9/2016 för din lokala tid snarare än UTC.

Om du inte angav föregående datum och tid 18:00:00 skulle dina loggar sakna data under de första 6 timmarna av den 2/2/2016 din lokala tid (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.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NumberOfThreads

Anger antalet trådar som ska användas för att ladda ned loggar.

De godtagbara värdena för den här parametern är: 1–32.

Standardvärdet är 3.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en befintlig sökväg för mappen där loggarna ska sparas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False