Partilhar via

Get-AadrmTrackingLog

  • Referência
Módulo:
AADRM

Obtém informações de rastreio de documentos protegidos.

Sintaxe

Get-AadrmTrackingLog
   -UserEmail <String>
   [-FromTime <DateTime>]
   [-ToTime <DateTime>]

Description

Nota

Este cmdlet do módulo AADRM está agora depreciado. Depois de 15 de julho de 2020, este nome cmdlet será suportado apenas como um pseudónimo à sua substituição no módulo AIPService.

Para mais informações, consulte a página geral.

O Cmdlet Get-AadrmTrackingLog devolve informações sobre documentos protegidos para um utilizador especificado que protegeu documentos (o emitente de Gestão de Direitos) ou que acedeu a documentos protegidos. Este cmdlet ajuda a responder à pergunta "Que documentos protegidos fizeram uma faixa ou acesso especificados do utilizador?" A informação devolvida inclui:

  • O documento identificação do conteúdo, com o nome do documento, se disponível.
  • O emitente de Gestão de Direitos.
  • Os utilizadores que acederam ao documento, quando e a partir de que local.
  • Que identificação do modelo de proteção ou direitos de utilização específicos foram usados para proteger o documento e se o acesso foi concedido ou negado.

Pode especificar a hora de início e a hora de paragem das entradas para incluir. A saída é devolvida como uma lista de objetos PowerShell na consola PowerShell.

Em alternativa, pode utilizar o site de rastreio de documentos para obter as informações de proteção sobre os documentos rastreados. Para obter mais informações, consulte os documentos de rastreio e revogação da secção de utilizadores no guia de administração.

Exemplos

Exemplo 1: Obtenha todas as informações de rastreio para um utilizador

PS C:\>Get-AadrmTrackingLog -UserEmail "test@contoso.com"

Este comando gera um registo de todas as informações de rastreio de documentos protegidos ou acedidos pelo utilizador com o endereço de e-mail "test@contoso.com".

Exemplo 2: Obter informações de rastreio para um utilizador, durante um período de tempo específico

PS C:\>Get-AadrmTrackingLog -UserEmail "test@contoso.com" -FromTime "01/01/2018 00:00:00" -ToTime "01/31/2018 23:59:59"

Este comando é o mesmo que o exemplo anterior, exceto que os resultados estão limitados a documentos que foram rastreados dentro de um período de tempo específico utilizando os parâmetros FromTime e ToTime . Neste exemplo, o período de tempo é de todos os dias em janeiro de 2018, utilizando o formato de data dos EUA.

Exemplo 3: Obtenha todas as informações de rastreio de um utilizador e guarde os resultados para um ficheiro .csv

PS C:\>$trackingLogs = Get-AadrmTrackingLog -UserEmail "test@contoso.com"
PS C:\>$trackingLogs | Export-Csv 'C:\Temp\TrackingLog.csv' -NoTypeInformation

O primeiro comando gera um registo de todas as informações de rastreio de documentos que foram protegidos ou acedidos pelo utilizador com o endereço de e-mail "test@contoso.com", e guarda o resultado numa variável.

O segundo comando utiliza então o cmdlet Export-Csv para converter a informação de rastreio em formato .csv e guardá-la para o ficheiro C:\Temp\TrackingLog.csv.

Parâmetros

-FromTime

Especifica a hora de início (inclusiva) para o ficheiro de registo como um objeto DateTime . Para obter um objeto DateTime , utilize o cmdlet Get-Date . Especifique a data e a hora de acordo com as definições de localidade do seu sistema. Para mais informações, insira Get-Help Get-Date.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ToTime

Especifica o tempo de paragem (inclusive) para o ficheiro de registo como um objeto DateTime . Para obter um objeto DateTime , utilize o cmdlet Get-Date . Especifique a data e a hora de acordo com as definições de localidade do seu sistema. Para mais informações, insira Get-Help Get-Date.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserEmail

Especifica o endereço de e-mail do utilizador. O cmdlet obtém a informação de rastreio de documentos protegidos ou acedidos pelo utilizador que tem este endereço de e-mail.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False