Delen via

Get-AipServiceDocumentLog

  • Referentie
Module:
AIPService

Hiermee haalt u beveiligingsinformatie op over documenten die worden bijgehouden door Azure Information Protection.

Deze cmdlet wordt ondersteund door zowel de klassieke azure Information Protection- als geïntegreerde labelclients, met verschillende gebruiksgegevens, zoals hieronder wordt beschreven.

Syntaxis

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

Description

De cmdlet Get-AIPServiceDocumentLog voert een query uit om beveiligingsinformatie over bijgehouden documenten te retourneren.

De geretourneerde informatie omvat:

  • De inhouds-id van het document, met de naam van het document, indien beschikbaar.
  • De Rights Management-eigenaar en Rights Management-uitgever.
  • De gebruikers en groepen waaraan toegang is verleend.
  • De id van de beveiligingssjabloon of specifieke gebruiksrechten die het document beveiligen.
  • Een instelling voor verlopen, offlinetoegang of intrekking.

U kunt een begin- en eindtijd opgeven voor vermeldingen die moeten worden opgenomen. De uitvoer wordt geretourneerd als een lijst met PowerShell-objecten in de PowerShell-console.

Zie Rights Management-eigenaren en IRights Management-verlenersvoor meer informatie.

Wanneer deze wordt gebruikt met de geïntegreerde labelclient, is de query gebaseerd op de documentnaam, het e-mailadres van de eigenaar of beide.

U moet ten minste een van de volgende parameters opgeven:

  • ContentName-
  • eigenaar

Fooi

Als u de parameter ContentName gebruikt, wordt u aangeraden ook de parameters FromTime en ToTime te gebruiken om uw inhoud te filteren op een bepaalde periode.

Voorbeelden

Voorbeeld 1: (alleen geïntegreerde labelclient) Beveiligingsinformatie ophalen over alle bijgehouden documenten met een specifieke bestandsnaam, die in een specifieke periode zijn beveiligd

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

Met deze opdracht wordt een query uitgevoerd en wordt beveiligingsinformatie geretourneerd over alle bijgehouden documenten die zijn opgeslagen in uw tenant met de bestandsnaam test.docx, die in december 2020 zijn beveiligd.

Voorbeeld 2: (alleen client voor geïntegreerde labels) Beveiligingsinformatie ophalen over alle bijgehouden documenten met een specifieke bestandsnaam en eigenaar, die in een specifieke periode zijn beveiligd

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

Met deze opdracht wordt een query uitgevoerd en worden beveiligingsinformatie geretourneerd over alle bijgehouden documenten die zijn opgeslagen in uw tenant die overeenkomen met de volgende gegevens:

  • De bestandsnaam is test.docx
  • Het bestand is beveiligd door een gebruiker met het e-mailbericht alice@contoso.com
  • Het bestand is beveiligd in december 2020.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ContentName

Hiermee geeft u de volledige naam van het bijgehouden document, inclusief de bestandsextensie.

Als u de geïntegreerde labelclient hebt, moet u deze parameter of de eigenaar parameter opnemen of beide opnemen.

Fooi

Als u deze parameter gebruikt, raden we u aan ook de FromTime- en ToTime datumfilters te gebruiken om de geretourneerde gegevens te filteren.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-FromTime

Hiermee geeft u de begintijd (inclusief) voor het logboekbestand op als een DateTime--object. Als u een DateTime--object wilt ophalen, gebruikt u de cmdlet Get-Date. Geef de datum en tijd op volgens de landinstellingen van uw systeem.

Typ Get-Help Get-Datevoor meer informatie.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Owner

Hiermee geeft u het e-mailadres op van de gebruiker die het document heeft beveiligd (de Rights Management-uitgever of -eigenaar).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ToTime

Hiermee geeft u de stoptijd (inclusief) voor het logboekbestand op als een DateTime-object. Als u een DateTime--object wilt ophalen, gebruikt u de cmdlet Get-Date. Geef de datum en tijd op volgens de landinstellingen van uw systeem.

Typ Get-Help Get-Datevoor meer informatie.

Type:DateTime
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False