Get-RetentionPolicyTag

Syntax

Get-RetentionPolicyTag
   [[-Identity] <RetentionPolicyTagIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Get-RetentionPolicyTag
   [-Mailbox <MailboxIdParameter>]
   [-OptionalInMailbox]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Description

Marcas de retenção são usadas para aplicar configurações de retenção de mensagens a mensagens ou pastas. Existem três tipos de marcas de retenção:

• Marcas de diretiva de retenção
• Marcas de diretiva padrão
• Marcas pessoais

As marcas de diretiva de retenção são aplicadas a pastas padrão, como Caixa de Entrada e Itens Excluídos. As marcas pessoais estão disponíveis para usuários, com a finalidade de marcar itens e pastas. A marca de diretiva padrão é aplicada a todos os itens que não têm uma marca aplicada pelo usuário ou não foram herdados pela pasta na qual estão localizados. O cmdlet Get-RetentionPolicyTag exibe todas as configurações da marca especificada.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-RetentionPolicyTag

Este exemplo retorna todas as marcas de retenção.

Exemplo 2

Get-RetentionPolicyTag -IncludeSystemTags

Este exemplo retorna marcas de sistema, além de marcas pessoais e padrão.

Exemplo 3

Get-RetentionPolicyTag "Consolidated Messenger"

Este exemplo retorna as configurações da marca Consolidated Messenger.

Exemplo 4

Get-RetentionPolicyTag -Types Inbox,All | Format-Table Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize

Este exemplo retorna todas as marcas de retenção de Inbox e Todos os tipos e canaliza os resultados para o comando Format-Table para exibir as propriedades Nome, Tipo, RetentionEnabled, AgeLimitForRetention e RetentionAction.

Parâmetros

-DomainController

-Identity

-IncludeSystemTags

-Mailbox

-OptionalInMailbox

-Types

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.