Dela via

Get-AipServiceDocumentLog

  • Referens
Modul:
AIPService

Hämtar skyddsinformation om dokument som spåras av Azure Information Protection.

Den här cmdleten stöds av både Azure-Information Protection klassiska och enhetliga etiketteringsklienter, med olika användning, enligt beskrivningen nedan.

Syntax

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

Description

Cmdleten Get-AIPServiceDocumentLog kör en fråga för att returnera skyddsinformation om spårade dokument.

Information som returneras omfattar:

  • Dokumentinnehålls-ID:t med dokumentnamnet om det är tillgängligt.
  • Rights Management-ägaren och Rights Management-utfärdaren.
  • De användare och grupper som har beviljats åtkomst.
  • Skyddsmallens ID eller specifika användningsrättigheter som skyddar dokumentet.
  • Alla inställningar för förfallodatum, offlineåtkomst eller återkallning.

Du kan ange starttid och stopptid för poster som ska inkluderas. Utdata returneras som en lista över PowerShell-objekt i PowerShell-konsolen.

Mer information finns i Rights Management-ägare och IRights Management-utfärdare.

När den används med klienten för enhetlig etikettering baseras frågan på dokumentnamnet, ägarens e-post eller båda.

Du måste ange minst en av följande parametrar:

  • ContentName
  • Ägare

Tips

Om du använder parametern ContentName rekommenderar vi att du även använder parametrarna FromTime och ToTime för att filtrera innehållet till en viss tidsperiod.

Exempel

Exempel 1: (endast klient för enhetlig etikettering) Hämta skyddsinformation om alla spårade dokument med ett specifikt filnamn, som skyddades inom en viss tidsram

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

Det här kommandot kör en fråga och returnerar skyddsinformation om alla spårade dokument som lagras i klientorganisationen med filnamnet test.docx, som skyddades i december 2020.

Exempel 2: (endast klient för enhetlig etikettering) Hämta skyddsinformation om alla spårade dokument med ett specifikt filnamn och ägare, som har skyddats inom en viss tidsram

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

Det här kommandot kör en fråga och returnerar skyddsinformation om alla spårade dokument som lagras i din klientorganisation som matchar följande information:

  • Filnamnet är test.docx
  • Filen skyddades av en användare med e-postmeddelandet alice@contoso.com
  • Filen skyddades i december 2020.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-ContentName

Anger det spårade dokumentets fullständiga namn, inklusive filnamnstillägget.

Om du har klienten för enhetlig etikettering måste du inkludera antingen den här parametern eller parametern Ägare , eller så kan du inkludera båda.

Tips

Om du använder den här parametern rekommenderar vi att du också använder datumfiltren FromTime och ToTime för att filtrera de data som returneras.

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

-FromTime

Anger starttiden (inklusive) för loggfilen som ett DateTime-objekt . Om du vill hämta ett DateTime-objekt använder du cmdleten Get-Date . Ange datum och tid enligt inställningarna för systemets nationella inställningar.

För mer information ange Get-Help Get-Date.

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

-Owner

Anger e-postadressen till den användare som skyddade dokumentet (Rights Management-utfärdaren eller ägaren).

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

-ToTime

Anger stopptiden (inklusive) för loggfilen som ett DateTime-objekt . Om du vill hämta ett DateTime-objekt använder du cmdleten Get-Date . Ange datum och tid enligt inställningarna för systemets nationella inställningar.

För mer information ange Get-Help Get-Date.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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