Get-AipServiceDocumentLog
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
Default (Padrão)
Get-AipServiceDocumentLog
-ContentName <String>
-Owner <String>
[-FromTime <DateTime>]
[-ToTime <DateTime>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
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
- Proprietário
Sugestão
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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
| Pseudónimos: | Cf. |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Sugestão
Se você usar esse parâmetro, recomendamos que você também use os filtros FromTime e ToTime date para filtrar os dados retornados.
Propriedades dos parâmetros
| Tipo: | String |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FromTime
Especifica a hora de início (inclusive) para o arquivo de log como um objeto DateTime
Para obter mais informações, digite Get-Help Get-Date.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Owner
Especifica o endereço de e-mail do usuário que protegeu o documento (o emissor ou proprietário do Rights Management).
Propriedades dos parâmetros
| Tipo: | String |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ToTime
Especifica a hora de parada (inclusive) para o arquivo de log como um objeto DateTime
Para obter mais informações, digite Get-Help Get-Date.
Propriedades dos parâmetros
| Tipo: | DateTime |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Suporta curingas: | False |
| DontShow: | False |
| Pseudónimos: | Wi |
Conjuntos de parâmetros
(All)
| Posição: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.