Get-AadrmDocumentLog
Obtém informações de proteção sobre documentos que são rastreados.
Sintaxe
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
.
Tipo: | DateTime |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
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 |
-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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |