Get-AipServiceDocumentLog

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

Esse cmdlet é compatível com o Azure Proteção de Informações clientes de rotulagem clássicos e unificados, 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 retornadas incluem:

  • A 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 que receberam acesso.
  • A ID do modelo de proteção ou os direitos de uso específicos que protegem o documento.
  • Qualquer expiração, acesso offline ou configuração de revogação.

Você pode especificar uma hora de início e de fim 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 rotulagem unificada, a consulta é baseada no nome do documento, no email do proprietário ou em ambos.

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

  • ContentName
  • Proprietário

Dica

Se você usar o parâmetro ContentName , recomendamos que você 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 rotulagem 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 específico

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

Esse 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 arquivotest.docx, que foram protegidos em dezembro de 2020.

Exemplo 2: (somente cliente de rotulagem 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 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"

Esse 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 email alice@contoso.com
  • O arquivo foi protegido em dezembro de 2020.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContentName

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

Se você tiver o cliente de rotulagem unificada, deverá incluir esse parâmetro ou o parâmetro Proprietário ou pode incluir ambos.

Dica

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Owner

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False