Share via

Get-AadrmDocumentLog

  • Referência
Módulo:
AADRM

Obtém informações de proteção sobre documentos que são rastreados.

Syntax

Get-AadrmDocumentLog
   -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 Get-AadrmDocumentLog cmdlet devolve informações de proteção sobre os documentos rastreados para um utilizador especificado se esses documentos protegidos pelo utilizador (o emitente de Gestão de Direitos) ou se foi o proprietário da Gestão de Direitos para documentos, ou documentos protegidos foram configurados para conceder acesso diretamente ao utilizador. Este cmdlet ajuda a responder à pergunta "Como são protegidos os documentos para um utilizador especificado?" A informação devolvida inclui:

  • O documento identificação do conteúdo, com o nome do documento, se disponível.
  • O proprietário da Gestão de Direitos e emitente de Gestão de Direitos.
  • Os utilizadores e grupos a quem foi concedido acesso.
  • O ID do modelo de proteção ou direitos de utilização específicos que protegem o documento.
  • Qualquer validade, acesso offline ou definição de revogação.

Mais informações sobre o proprietário da Gestão de Direitos e o emitente de Gestão de Direitos.

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 para a secção de utilizadores no guia de administração do Azure Information Protection cliente.

Exemplos

Exemplo 1: Obtenha informações de proteção sobre todos os documentos rastreados para um utilizador

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

Este comando obtém informações de proteção sobre os documentos rastreados para um utilizador que tem o endereço de e-mail de "test@contoso.com" e que o utilizador é o emitente de Gestão de Direitos ou titular da Gestão de Direitos para o documento, ou o documento foi configurado para conceder acesso a esse utilizador.

Exemplo 2: Obter informações de proteção sobre documentos rastreados para um utilizador, durante um período de tempo específico

PS C:\>Get-AadrmDocumentLog -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 protegidos 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 informações de proteção sobre todos os documentos rastreados para um utilizador e guarde os resultados para um ficheiro .csv

PS C:\>$documentLogs = Get-AadrmDocumentLog -UserEmail "test@microsoft.com"
PS C:\>$documentLogs | Export-Csv 'C:\Temp\DocumentLog.csv' -NoTypeInformation

O primeiro comando obtém a informação de proteção sobre os documentos rastreados para um utilizador que tem o endereço de e-mail de "test@contoso.com" e esse utilizador é o emitente de Gestão de Direitos ou titular da Gestão de Direitos para o documento, ou o documento foi configurado para conceder acesso a esse utilizador. A informação é guardada numa variável.

O segundo comando utiliza então o cmdlet Export-Csv para converter as informações de proteção em formato .csv e guardá-las para o ficheiro C:\Temp\DocumentLog.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.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-UserEmail

Especifica o endereço de e-mail do utilizador. O cmdlet obtém a informação de proteção de documentos se esses documentos protegidos pelo utilizador (o emitente de Gestão de Direitos) ou se o titular da Gestão de Direitos para documentos, ou documentos protegidos foram configurados para conceder acesso diretamente ao utilizador. Os endereços de grupo não são suportados com este cmdlet.

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