Sdílet prostřednictvím

Get-AipServiceDocumentLog

  • Reference
Modul:
AIPService

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.

Syntaxe

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í.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

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

-Owner

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

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

-WhatIf

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

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