Get-AipServiceDocumentLog

Referencia

Módulo:: AIPService

Obtiene información de protección sobre los documentos de los que realiza el seguimiento Azure Information Protection.

Este cmdlet es compatible con los clientes de etiquetado clásico y unificado de Azure Information Protection, con un uso diferente, como se describe a continuación.

Syntax

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

Description

El cmdlet Get-AIPServiceDocumentLog ejecuta una consulta para devolver información de protección sobre los documentos con seguimiento.

La información devuelta incluye:

Identificador de contenido del documento, con el nombre del documento si está disponible.
El propietario de Rights Management y el emisor de Rights Management.
Usuarios y grupos a los que se concedió acceso.
Identificador de plantilla de protección o derechos de uso específicos que protegen el documento.
Cualquier configuración de expiración, acceso sin conexión o revocación.

Puede especificar una hora de inicio y de detención de las entradas que se van a incluir. La salida se devuelve como una lista de objetos de PowerShell en la consola de PowerShell.

Para obtener más información, consulte Rights Management owners and IRights Management issuers (Propietarios de Rights Management y emisores de administración de IRights).

Cuando se usa con el cliente de etiquetado unificado, la consulta se basa en el nombre del documento, el correo electrónico del propietario o ambos.

Debe especificar al menos uno de los parámetros siguientes:

ContentName
Propietario

Sugerencia

Si usa el parámetro ContentName , se recomienda usar también los parámetros FromTime y ToTime para filtrar el contenido a un período de tiempo específico.

Ejemplos

Ejemplo 1: (solo cliente de etiquetado unificado) Obtener información de protección sobre todos los documentos con seguimiento con un nombre de archivo específico, que se protegieron en un período de tiempo específico

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

Este comando ejecuta una consulta y devuelve información de protección sobre todos los documentos de seguimiento almacenados en el inquilino con el nombre de archivo test.docx, que se protegieron en diciembre de 2020.

Ejemplo 2: (solo cliente de etiquetado unificado) Obtener información de protección sobre todos los documentos con seguimiento con un nombre de archivo y propietario específicos, que se protegieron en un período de tiempo específico

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

Este comando ejecuta una consulta y devuelve información de protección sobre todos los documentos de seguimiento almacenados en el inquilino que coinciden con los detalles siguientes:

El nombre de archivo es test.docx
El archivo estaba protegido por un usuario con el correo electrónico. alice@contoso.com
El archivo se protegió en diciembre de 2020.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-ContentName

Especifica el nombre completo del documento con seguimiento, incluida la extensión de archivo.

Si tiene el cliente de etiquetado unificado, debe incluir este parámetro o el parámetro Owner , o bien puede incluir ambos.

Sugerencia

Si usa este parámetro, se recomienda usar también los filtros de fecha FromTime y ToTime para filtrar los datos devueltos.

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

-FromTime

Especifica la hora de inicio (inclusive) para el archivo de registro como un objeto DateTime . Para obtener un objeto DateTime , use el cmdlet Get-Date . Especifique la fecha y hora según la configuración regional del sistema.

Para obtener más información, escriba Get-Help Get-Date.

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

-Owner

Especifica la dirección de correo electrónico del usuario que protegió el documento (el emisor o propietario de Rights Management).

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

-ToTime

Especifica la hora de detención (inclusive) para el archivo de registro como un objeto DateTime . Para obtener un objeto DateTime , use el cmdlet Get-Date . Especifique la fecha y hora según la configuración regional del sistema.