Partilhar via

Get-AipServiceDocumentLog

  • Referência
Módulo:
AIPService

Obtém informações de proteção sobre documentos que são rastreados pela Proteção de Informações do Azure.

Esse cmdlet é suportado pelos clientes de rotulagem clássica e unificada da Proteção de Informações do Azure, com uso diferente, conforme descrito abaixo.

Sintaxe

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

Description

O cmdlet Get-AIPServiceDocumentLog executa uma consulta para retornar informações de proteção sobre documentos rastreados.

As informações devolvidas incluem:

  • O ID de conteúdo do documento, com o nome do documento, se disponível.
  • O proprietário do Rights Management e o emissor do Rights Management.
  • Os usuários e grupos aos quais foi concedido acesso.
  • O ID do modelo de proteção ou direitos de uso específicos que protegem o documento.
  • Qualquer configuração de validade, acesso offline ou revogação.

Você pode especificar uma hora de início e uma hora de parada das entradas a serem incluídas. A saída é retornada como uma lista de objetos do PowerShell no console do PowerShell.

Para obter mais informações, consulte proprietários do Rights Management e emissores do IRights Management.

Quando usada com o cliente de etiquetagem unificada, a consulta é baseada no nome do documento, no e-mail do proprietário ou em ambos.

Você deve especificar pelo menos um dos seguintes parâmetros:

  • ContentName
  • Owner

Dica

Se você usar o parâmetro ContentName, recomendamos que também use os parâmetros FromTime e ToTime para filtrar seu conteúdo para um período de tempo específico.

Exemplos

Exemplo 1: (Somente cliente de etiquetagem unificada) Obtenha informações de proteção sobre todos os documentos rastreados com um nome de arquivo específico, que foram protegidos em um período de tempo específico

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

Este comando executa uma consulta e retorna informações de proteção sobre todos os documentos rastreados armazenados em seu locatário com o nome de arquivo test.docx, que foram protegidos em dezembro de 2020.

Exemplo 2: (Somente cliente de etiquetagem unificada) Obtenha informações de proteção sobre todos os documentos rastreados com um nome de arquivo e proprietário específicos, que foram protegidos em um período de tempo 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 executa uma consulta e retorna informações de proteção sobre todos os documentos rastreados armazenados em seu locatário que correspondem aos seguintes detalhes:

  • O nome do arquivo é test.docx
  • O arquivo foi protegido por um usuário com o e-mail alice@contoso.com
  • O arquivo foi protegido em dezembro de 2020.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

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

-ContentName

Especifica o nome completo do documento controlado, incluindo a extensão do arquivo.

Se você tiver o cliente de rotulagem unificado, deverá incluir esse parâmetro ou o parâmetro Owner, ou poderá incluir ambos.

Dica

Se você usar esse parâmetro, recomendamos que você também use os filtros FromTime e ToTime date para filtrar os dados retornados.

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

-FromTime

Especifica a hora de início (inclusive) para o arquivo de log como um objeto DateTime . Para obter um objeto DateTime, use o cmdlet Get-Date. Especifique a data e a hora de acordo com as configurações de localidade do sistema.

Para obter mais informações, digite Get-Help Get-Date.

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

-Owner

Especifica o endereço de e-mail do usuário que protegeu o documento (o emissor ou proprietário do Rights Management).

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

-ToTime

Especifica a hora de parada (inclusive) para o arquivo de log como um objeto DateTime . Para obter um objeto DateTime, use o cmdlet Get-Date. Especifique a data e a hora de acordo com as configurações de localidade do sistema.

Para obter mais informações, digite Get-Help Get-Date.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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