Sdílet prostřednictvím

Get-AipServiceUserLog

  • Reference
Modul:
AIPService

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

Syntax

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

Description

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

K získání těchto protokolů uživatelů 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/2/2016 15:00:00'), převede se toto datum a čas na UTC. Příkaz Get-AipServiceUserLog pak získá protokoly pro dané časové období UTC. Protokoly využití jsou k dispozici, pouze pokud název pole "date" obsahuje hodnotu předchozího data (v čase UTC). Protokoly využití od aktuálního data nejsou k dispozici.

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

Další informace o protokolování využití ochrany a podrobný příklad 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í protokolů uživatelů 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 15. 12. 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í protokolů uživatele pro datum

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

Tento příkaz stáhne uživatelské protokoly z 5. 12. 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 UTC a posunu

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

Tento příkaz ukazuje, jak můžete před stažením uživatelských protokolů do složky C:\Logs vzít v úvahu převod času UTC a času posunu od 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 z 2. 2. 2016 pro místní čas místo času UTC. Pokud jste s datem nezadali čas 12:00:00, vaše protokoly by obsahovaly data pouze za 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 dat s ohledem na převod času posunu 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 posunu UTC z místního času před stažením protokolů uživatele do složky C:\Logs.

Jste v Houstonu v 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 pro váš místní čas místo UTC.

Pokud jste nezadali předchozí datum a čas 18:00:00, v protokolech by chyběla 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 dat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForDate

Určuje datum (a volitelně i čas) pro soubor 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 .

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 spuštění příkazu.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ToDate

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

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

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False