Condividi tramite

Get-AipServiceDocumentLog

  • Riferimento
Modulo:
AIPService

Ottiene informazioni di protezione sui documenti rilevati da Azure Information Protection.

Questo cmdlet è supportato dai client di etichettatura classica e unificata di Azure Information Protection, con un 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 di protezione sui documenti rilevati.

Le informazioni restituite includono:

  • ID contenuto documento, con il nome del documento, se disponibile.
  • Proprietario di Rights Management e autorità emittente di 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 un'ora di arresto delle voci da includere. L'output viene restituito come elenco di oggetti di PowerShell nella console di PowerShell.

Per altre informazioni, vedere proprietari di Rights Management e autorità emittenti IRights Management.

Se 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

Mancia

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, protetti 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 di protezione su tutti i documenti rilevati archiviati nel tenant con il nome file test.docx, che sono stati protetti nel 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 di protezione su tutti i documenti rilevati archiviati nel tenant che corrispondono ai dettagli seguenti:

  • Il nome 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 conferma 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 rilevato, inclusa l'estensione del file.

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

Mancia

Se si usa questo parametro, è consigliabile usare anche i filtri FromTime FromTime e ToTime date 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 (inclusi) per il file di log come oggetto DateTime . Per ottenere un oggetto DateTime , utilizzare il cmdlet Get-Date . Specificare la data e l'ora in base alle impostazioni locali del sistema.

Per altre 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'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 , utilizzare il cmdlet Get-Date . Specificare la data e l'ora in base alle impostazioni locali del sistema.

Per altre 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 cosa accadrebbe se il cmdlet viene eseguito. 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