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 de klassiska och enhetliga etiketteringsklienterna i Azure Information Protection, 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

Dricks

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 enhetlig etiketteringsklient) Hämta skyddsinformation om alla spårade dokument med ett specifikt filnamn, som har skyddats 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 enhetlig etiketteringsklient) 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-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.

Dricks

Om du använder den här parametern rekommenderar vi att du även 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.

Om du vill ha mer information skriver du 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.

Om du vill ha mer information skriver du 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örs. Cmdleten körs inte.

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