Get-AipServiceDocumentLog

Získá informace o ochraně dokumentů sledovaných službou Azure Information Protection.

Tato rutina je podporována klienty Azure Information Protection classic i sjednoceného popisování s jiným využitím, jak je popsáno níže.

Syntax

Get-AipServiceDocumentLog
   -ContentName <String>
   -Owner <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Get-AIPServiceDocumentLog spustí dotaz, který vrátí informace o ochraně sledovaných dokumentů.

Vrácené informace zahrnují:

  • ID obsahu dokumentu s názvem dokumentu, pokud je k dispozici.
  • Vlastník služby Rights Management a vystavitel Rights Management.
  • Uživatelé a skupiny, kterým byl udělen přístup.
  • ID šablony ochrany nebo specifická práva k používání, která chrání dokument.
  • Jakékoli nastavení vypršení platnosti, offline přístupu nebo odvolání.

Můžete zadat počáteční čas a čas zastavení položek, které se mají zahrnout. Výstup se vrátí jako seznam objektů PowerShellu v konzole PowerShellu.

Další informace najdete v tématu Vlastníci služby Rights Management a vystavitely IRights Management.

Při použití s jednotným klientem popisování je dotaz založený na názvu dokumentu, e-mailu vlastníka nebo na obou.

Musíte zadat alespoň jeden z následujících parametrů:

  • ContentName
  • Vlastník

Tip

Pokud používáte parametr ContentName , doporučujeme použít také parametry FromTime a ToTime k filtrování obsahu do určitého časového období.

Příklady

Příklad 1: (pouze klient sjednoceného popisování) Získejte informace o ochraně všech sledovaných dokumentů s určitým názvem souboru, který byl chráněn v určitém časovém rámci.

Get-AipServiceDocumentLog -ContentName "test.docx" -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Tento příkaz spustí dotaz a vrátí informace o ochraně všech sledovaných dokumentů uložených ve vašem tenantovi s názvem souborutest.docx, které byly chráněny v prosinci 2020.

Příklad 2: (pouze klient sjednoceného popisování) Získejte informace o ochraně všech sledovaných dokumentů s konkrétním názvem souboru a vlastníkem, které byly chráněny v určitém časovém rámci.

Get-AipServiceDocumentLog -ContentName "test.docx" -Owner “alice@microsoft.com” -FromTime "12/01/2020 00:00:00" -ToTime "12/31/2020 23:59:59"

Tento příkaz spustí dotaz a vrátí informace o ochraně všech sledovaných dokumentů uložených ve vašem tenantovi, které odpovídají následujícím podrobnostem:

  • Název souboru je test.docx
  • Soubor byl chráněn uživatelem pomocí e-mailu. alice@contoso.com
  • Soubor byl chráněn v prosinci 2020.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-ContentName

Určuje úplný název sledovaného dokumentu, včetně přípony souboru.

Pokud máte klienta sjednoceného popisování, musíte zahrnout buď tento parametr, nebo parametr Vlastník , nebo můžete zahrnout obojí.

Tip

Pokud použijete tento parametr, doporučujeme použít také filtry data FromTime a ToTime k filtrování vrácených dat.

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

-FromTime

Určuje počáteční čas (včetně) souboru protokolu jako objekt DateTime . K získání objektu DateTime použijte rutinu Get-Date . Zadejte datum a čas podle nastavení národního prostředí systému.

Další informace zobrazíte zadáním Get-Help Get-Date.

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

-Owner

Určuje e-mailovou adresu uživatele, který dokument chránil (vystavitel nebo vlastník služby Rights Management).

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

-ToTime

Určuje čas zastavení (včetně) souboru protokolu jako objekt DateTime . K získání objektu DateTime použijte rutinu Get-Date . Zadejte datum a čas podle nastavení národního prostředí systému.

Další informace zobrazíte zadáním Get-Help Get-Date.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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