Partilhar via

Get-AipServiceDocumentLog

  • Referência
Módulo:
AIPService

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

Este cmdlet é suportado tanto pelo Azure Information Protection clientes de rotulagem clássicos e unificados, com uma utilização diferente, como 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 devolver informações de proteção sobre documentos rastreados.

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.

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.

Para mais informações, consulte os proprietários da Rights Management e os emitentes da IRights Management.

Quando utilizado com o cliente de rotulagem unificado, a consulta baseia-se no nome do documento, no e-mail do proprietário, ou em ambos.

Deve especificar pelo menos um dos seguintes parâmetros:

  • ConteúdoName
  • Proprietário

Dica

Se utilizar o parâmetro Menu de Conteúdo , recomendamos que utilize também os parâmetros FromTime e ToTime para filtrar o seu conteúdo para um período de tempo específico.

Exemplos

Exemplo 1: (Apenas cliente de rotulagem unificada) Obtenha informações de proteção sobre todos os documentos rastreados com um nome de ficheiro específico, que foram protegidos num determinado prazo

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 devolve informações de proteção sobre todos os documentos rastreados armazenados no seu inquilino com o nome de arquivotest.docx, que foram protegidos em dezembro de 2020.

Exemplo 2: (Apenas cliente de rotulagem unificada) Obtenha informações de proteção sobre todos os documentos rastreados com um nome de arquivo específico e proprietário, que foram protegidos num determinado prazo

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 devolve informações de proteção sobre todos os documentos rastreados armazenados no seu inquilino que correspondem aos seguintes detalhes:

  • O nome de arquivo é test.docx
  • O ficheiro foi protegido por um utilizador com o e-mail alice@contoso.com
  • O processo foi protegido em dezembro de 2020.

Parâmetros

-Confirm

Solicita a sua 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 rastreado, incluindo a extensão do ficheiro.

Se tiver o cliente de rotulagem unificado, deve incluir este parâmetro, ou o parâmetro Proprietário , ou pode incluir ambos.

Dica

Se utilizar este parâmetro, recomendamos que utilize também os filtros FromTime e ToTime para filtrar os dados devolvidos.

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

-Owner

Especifica o endereço de e-mail do utilizador que protegeu o documento (o emitente ou proprietário da Gestão de Direitos).

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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