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 als geïntegreerde labelclients van Azure Information Protection, met een ander gebruik, zoals hieronder wordt beschreven.

Syntax

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 documentnaam, indien beschikbaar.
De Rights Management-eigenaar en Rights Management-uitgever.
De gebruikers en groepen die toegang hebben gekregen.
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-verleners voor meer informatie.

Wanneer de query 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

Tip

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

Voorbeelden

Voorbeeld 1: (alleen geïntegreerde labelclient) Beveiligingsinformatie ophalen over alle bijgehouden documenten met een specifieke bestandsnaam, die in een bepaalde 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 worden 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 geïntegreerde labelclient) Beveiligingsinformatie ophalen over alle bijgehouden documenten met een specifieke bestandsnaam en eigenaar, die in een bepaalde 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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentName

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

Als u de client voor geïntegreerde labels hebt, moet u deze parameter of de parameter Eigenaar opnemen, of u kunt beide opnemen.

Tip

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-FromTime

Hiermee geeft u de begintijd (inclusief) voor het logboekbestand op als een DateTime-object . Gebruik de cmdlet Get-Date om een DateTime-object te verkrijgen. Geef de datum en tijd op volgens de landinstellingen van uw systeem.

Typ Get-Help Get-Date voor meer informatie.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ToTime

Hiermee geeft u de stoptijd (inclusief) voor het logboekbestand op als een DateTime-object . Gebruik de cmdlet Get-Date om een DateTime-object te verkrijgen. Geef de datum en tijd op volgens de landinstellingen van uw systeem.