Get-AipServiceTrackingLog

Obtiene información de seguimiento de documentos protegidos por 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-AipServiceTrackingLog
   -ContentId <Guid>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Get-AipServiceTrackingLog 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.
  • Emisor de Rights Management.
  • Los usuarios que accedieron al documento, cuándo y desde qué ubicación.
  • Qué identificador de plantilla de protección o derechos de uso específicos se usaron para proteger el documento y si se concedió o denegó el acceso.
  • La propiedad IsHiddenInfo , que siempre será false. Esta propiedad se usa para ocultar eventos para los usuarios en los que el seguimiento está deshabilitado.

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.

El cmdlet Get-AipServiceTracking devuelve información de seguimiento sobre un documento protegido con un contentID especificado.

Para recuperar el contentID de un documento específico, use el cmdlet Get-AipServiceDocumentLog .

Ejemplos

Ejemplo 1: Obtener datos de seguimiento de un documento específico, mediante su contentId

PS C:\>Get-AipServiceDocumentLog -ContentId c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

Este comando ejecuta una consulta para devolver información de seguimiento de un documento específico, con un valor contentID de c03bf90c-6e40-4f3f-9ba0-2bcd77524b87

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

-ContentId

Especifica el valor contentID del documento para el que desea devolver los datos de seguimiento.

Para recuperar el contentID de un documento específico, use el cmdlet Get-AipServiceDocumentLog .

Type:String
Aliases:cf
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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

-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. 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

-UserEmail

Especifica la dirección de correo electrónico del usuario. El cmdlet obtiene la información de seguimiento de los documentos protegidos por el usuario al que ha accedido o al que tiene esta dirección de correo electrónico.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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