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.

Syntax

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.

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

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

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

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