Get-AipServiceDocumentLog
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 |