Sdílet prostřednictvím

Get-AipServiceUserLog

  • Reference
Modul:
AIPService

Stáhne protokoly uživatelů ochrany ze služby Azure Information Protection do místního úložiště.

Syntaxe

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

Description

Rutina Get-AipServiceUserLog stáhne protokoly uživatelů ochrany do místního úložiště. Chcete-li stáhnout položky protokolu, musíte zadat konkrétní datum nebo rozsah kalendářních dat.

K získání těchto uživatelských protokolů musíte použít PowerShell; Tuto akci nelze provést pomocí portálu pro správu.

Když spustíte tento příkaz a zadáte datum pouze pro objekty DateTime, předpokládá se, že čas bude v místním čase 00:00:00 a pak se převede na UTC.

Když zadáte čas s datem (například -ForDate '1/1/2016 15:00:00'), toto datum a čas se převede na UTC. Příkaz Get-AipServiceUserLog pak získá protokoly pro dané časové období UTC. Protokoly použití jsou k dispozici pouze v případech, kdy název pole "date" obsahuje hodnotu předchozího data (v čase UTC). Protokoly využití z aktuálního data nejsou k dispozici.

Podívejte se na příklady, jak možná budete muset změnit hodnoty DateTime tak, aby vyhovovaly převodu potřebnému pro místní čas.

Další informace o protokolování využití ochrany a podrobném příkladu najdete v tématu Protokolování a analýza využití ochrany z Azure In formation Protection.

Příklady

Příklad 1: Získání uživatelských protokolů pro rozsah kalendářních dat

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

Tento příkaz stáhne uživatelské protokoly vytvořené mezi 12. 12. 2015 a 12. 15. 2015 (v čase UTC) do složky C:\Logs.

Příkaz ke stažení protokolů používá 10 vláken.

Příklad 2: Získání uživatelských protokolů pro datum

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

Tento příkaz stáhne uživatelské protokoly pro 12. 5. 2015 (v čase UTC) do složky C:\Logs.

Příklad 3: Získání uživatelských protokolů pro datum s ohledem na převod času posunu UTC

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

Tento příkaz ukazuje, jak je možné, že před stažením uživatelských protokolů do složky C:\Logs budete muset vzít v úvahu převod času posunu UTC +posun z místního času.

Nacházíte se na Novém Zélandu, což znamená, že místní čas vašeho počítače je UTC+12 a chcete stáhnout protokoly pro místní čas 2. 2. 2016 místo UTC. Pokud jste nezadali čas 12:00:00 s datem, budou protokoly obsahovat data pouze prvních 12 hodin 2. 2. 2016 (a posledních 12 hodin předchozího dne).

Příklad 4: Získání uživatelských protokolů pro rozsah kalendářních dat s ohledem na převod času -offset UTC

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

Tento příkaz ukazuje, jak možná budete muset vzít v úvahu převod času UTC -offset času z místního času před stažením uživatelských protokolů do složky C:\Logs.

Nacházíte se v Houstonu, USA, což znamená, že místní čas vašeho počítače je UTC-6 a chcete stáhnout protokoly od 2. 2. 2016 do 9. 2. 2016 místo UTC.

Pokud jste nezadali předchozí datum a čas 18:00:00, vaše protokoly by chyběly data za prvních 6 hodin 2. 2. 2016 místního času (a dalších 6 hodin pro koncové datum).

Parametry

-Force

Označuje, že tato rutina přepíše bez výzvy k potvrzení existující soubor protokolu pro stejné datum nebo rozsah kalendářních dat.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForDate

Určuje datum (a volitelně i čas) souboru protokolu jako objekt DateTime.

Tento parametr použijte, pokud nepoužíváte parametr FromDate.

K získání objektu DateTime použijte rutinu Get-Date.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-FromDate

Určuje počáteční datum (a volitelně i čas) souboru protokolu jako objekt DateTime.

Tento parametr použijte, pokud nepoužíváte parametr ForDate.

Pokud zadáte tento parametr, ale ne toDate, koncové datum je den, kdy příkaz spustíte.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NumberOfThreads

Určuje počet vláken, která se mají použít ke stažení protokolů.

Přijatelné hodnoty pro tento parametr jsou: 1-32.

Výchozí hodnota je 3.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Určuje existující cestu ke složce, do které se mají protokoly uložit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ToDate

Určuje datum zastavení (a volitelně čas) souboru protokolu jako objekt DateTime.

Volitelně můžete tento parametr zadat při použití parametru FromDate k určení konkrétního rozsahu kalendářních dat. Pokud tento parametr nezadáte při použití parametru FromDate, koncové datum je den, kdy příkaz spustíte.

Typ:DateTime
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False