Condividi tramite


Get-AipServiceDocumentLog

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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Owner

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

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

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False