Get-AipServiceDocumentLog

Riferimento

Modulo:: AIPService

Ottiene le informazioni sulla protezione dei documenti rilevati da Azure Information Protection.

Questo cmdlet è supportato sia dai client di etichettatura classica che unificata di Azure Information Protection, con utilizzo diverso, come descritto di seguito.

Sintassi

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

Descrizione

Il cmdlet Get-AIPServiceDocumentLog esegue una query per restituire informazioni sulla protezione sui documenti rilevati.

Le informazioni restituite includono:

ID contenuto documento, con il nome del documento se disponibile.
Proprietario di Rights Management e autorità di certificazione Rights Management.
Utenti e gruppi a cui è stato concesso l'accesso.
ID modello di protezione o diritti di utilizzo specifici che proteggono il documento.
Qualsiasi impostazione di scadenza, accesso offline o revoca.

È possibile specificare un'ora di inizio e di fine per le voci da includere. L'output viene restituito come elenco di oggetti PowerShell nella console di PowerShell.

Per altre informazioni, vedere Proprietari di Rights Management e autorità di gestione IRights.

Quando viene usato con il client di etichettatura unificata, la query si basa sul nome del documento, sul messaggio di posta elettronica del proprietario o su entrambi.

È necessario specificare almeno uno dei parametri seguenti:

ContentName
Proprietario

Suggerimento

Se si usa il parametro ContentName , è consigliabile usare anche i parametri FromTime e ToTime per filtrare il contenuto in un periodo di tempo specifico.

Esempio

Esempio 1: (solo client di etichettatura unificata) Ottenere informazioni di protezione su tutti i documenti rilevati con un nome file specifico, protetto in un intervallo di tempo specifico

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

Questo comando esegue una query e restituisce informazioni sulla protezione su tutti i documenti rilevati archiviati nel tenant con il nome file test.docx, protetti nel mese di dicembre 2020.

Esempio 2: (solo client di etichettatura unificata) Ottenere informazioni di protezione su tutti i documenti rilevati con un nome file e un proprietario specifici, protetti in un intervallo di tempo specifico

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

Questo comando esegue una query e restituisce informazioni sulla protezione su tutti i documenti rilevati archiviati nel tenant che corrispondono ai dettagli seguenti:

Il nome del file è test.docx
Il file è stato protetto da un utente con il messaggio di posta elettronica alice@contoso.com
Il file è stato protetto nel dicembre 2020.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-ContentName

Specifica il nome completo del documento monitorato, inclusa l'estensione del file.

Se si dispone del client di etichettatura unificata, è necessario includere questo parametro o il parametro Owner oppure è possibile includere entrambi.

Suggerimento

Se si usa questo parametro, è consigliabile usare anche i filtri date FromTime e ToTime per filtrare i dati restituiti.

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

-FromTime

Specifica l'ora di inizio (inclusiva) per il file di log come oggetto DateTime . Per ottenere un oggetto DateTime , usare il cmdlet Get-Date . Specificare la data e l'ora in base alle impostazioni locali del sistema.

Per ulteriori informazioni, digitare Get-Help Get-Date.

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

-Owner

Specifica l'indirizzo di posta elettronica dell'utente che ha protetto il documento (l'autorità emittente o il proprietario di Rights Management).

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

-ToTime

Specifica l'ora di arresto (inclusiva) per il file di log come oggetto DateTime . Per ottenere un oggetto DateTime , usare il cmdlet Get-Date . Specificare la data e l'ora in base alle impostazioni locali del sistema.