New-ManagedContentSettings

Módulo:

ExchangePowerShell

Aplica-se a:

Exchange Server 2010

Esse cmdlet só está disponível no Exchange Server 2010.

Use o cmdlet New-ManagedContentSettings para criar configurações de conteúdo gerenciado para pastas gerenciadas.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

New-ManagedContentSettings
   [-Name] <String>
   -FolderName <ELCFolderIdParameter>
   -MessageClass <String>
   [-AddressForJournaling <RecipientIdParameter>]
   [-AgeLimitForRetention <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-JournalingEnabled <Boolean>]
   [-LabelForJournaling <String>]
   [-MessageFormatForJournaling <JournalingFormat>]
   [-MoveToDestinationFolder <ELCFolderIdParameter>]
   [-RetentionAction <RetentionAction>]
   [-RetentionEnabled <Boolean>]
   [-TriggerForRetention <RetentionDateType>]
   [-WhatIf]
   [<CommonParameters>]

Description

As configurações de conteúdo gerenciado são configurações que você associa a pastas gerenciadas para controlar a vida útil dos itens nas caixas de correio dos usuários. O tempo de vida é controlado das seguintes maneiras:

• Controlando a retenção de conteúdo e removendo conteúdo que não é mais necessário.
• Ao registrar automaticamente conteúdo importante em um local de armazenamento separado fora da caixa de correio.

Para obter mais informações sobre configurações de conteúdo gerenciado, consulte Gerenciamento de Registros de Mensagens.

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

New-ManagedContentSettings -Name "CS-Exec-DeletedItems" -FolderName "Exec-DeletedItems" -MessageClass * -RetentionEnabled $true -RetentionAction DeleteAndAllowRecovery -AgeLimitForRetention 30.00:00:00 -TriggerForRetention WhenDelivered

Este exemplo cria configurações de conteúdo gerenciado para a pasta padrão gerenciada Exec-DeletedItems. Quando adicionados a uma política de caixa de correio de pasta gerenciada e aplicados a uma caixa de correio, os itens na pasta Itens Excluídos serão excluídos permanentemente 30 dias a partir da data da entrega.

Exemplo 2

New-ManagedContentSettings -Name CS-Exec-Calendar -FolderName Exec-Calendar -MessageClass Calendar -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention 180

Este exemplo cria configurações de conteúdo gerenciado CS-Exec-Calendar para a classe de mensagem Calendário. As configurações de conteúdo gerenciado se aplicam à pasta padrão Calendário. A retenção está habilitada e os itens são movidos para a pasta Itens Excluídos após 180 dias.

Parâmetros

-AddressForJournaling

O parâmetro AddressForJournaling especifica o destinatário do diário para onde as mensagens em diário são enviadas. É possível usar qualquer valor que identifique o destinatário com exclusividade. Por exemplo:

• Nome
• Alias
• Nome diferenciado (DN)
• Nome diferenciado (DN)
• DN canônico
• GUID

Esse parâmetro será necessário se o parâmetro JournalingEnabled estiver definido como $true.

Type:	RecipientIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-AgeLimitForRetention

O parâmetro AgeLimitForRetention especifica a idade com que a retenção é imposta a um item. O limite de idade corresponde ao número de dias a contar da data em que o item foi entregue ou da data em que um item foi criado, se não tiver sido entregue. Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.

Type:	EnhancedTimeSpan
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-DomainController

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-FolderName

O parâmetro FolderName especifica o nome ou o GUID da pasta gerenciada à qual as configurações de conteúdo gerenciado se aplicam.

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-JournalingEnabled

O parâmetro JournalingEnabled especifica que o diário está habilitado quando definido como $true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-LabelForJournaling

O parâmetro LabelForJournaling especifica um rótulo anexado a um item. Esse rótulo é usado pelo repositório de destino para determinar o conteúdo do item e impor a diretiva apropriada.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageClass

O parâmetro MessageClass especifica o tipo de mensagem ao qual se aplicam as configurações de expiração e de configuração de diário nessas configurações de conteúdo.

O valor do parâmetro pode ser um tipo de mensagem bem conhecido, como itens de calendário, uma classe de mensagem específica, como IPM. NOTA. SMIME ou uma classe de mensagem personalizada. Os seguintes tipos de mensagem conhecidos podem ser usados:

• Para todo o conteúdo da caixa de correio, use o valor *.
• Para o tipo de mensagem itens calendário, use o IPM de valor. Nomeação*.
• Para o tipo de mensagem Contatos, use o IPM de valor. Contato*.
• Para o tipo de mensagem Documentos, use o IPM de valor. Documento*.
• Para o tipo de mensagem Faxes, use o IPM de valor. Nota. Microsoft. Fax.
• Para o tipo de mensagem Journalitems, use o IPM de valor. Atividade.
• Para o tipo de mensagem Solicitações de reunião, respostas e cancelamentos, use o IPM de valor. Agenda*.
• Para o tipo de mensagem Anotações, use o IPM de valor. StickyNote.
• Para o tipo de mensagem Posts, use o valor IPM.Post.
• Para o tipo de mensagem de itens RSS, use o IPM de valor. Post.RSS.
• Para o tipo de mensagem Tarefas, use o IPM de valor. Tarefa*.
• Para o tipo de mensagem de email de voz, use o IPM de valor. Nota. Microsoft. Voicemail*.

Os valores de parâmetro válidos para classes de mensagens personalizadas incluem:

• Uma classe de mensagem específica (por exemplo, IPM. OBSERVAÇÃO).
• O caractere curinga asterisco (*), que indica que as configurações de conteúdo se aplicam a todas as classes de mensagem.
• Uma classe de mensagem específica que tem o caractere curinga asterisco. O caractere curinga asterisco deve aparecer como o último caractere na classe de mensagem. Por exemplo, IPM. OBSERVAÇÃO* (inclui IPM. OBSERVAÇÃO e todas as subclasses) ou IPM. NOTE.* (inclui as subclasses para IPM. OBSERVAÇÃO, mas não IPM. NOTA em si). *. OBSERVAÇÃO e IPM.*. OBSERVAÇÃO não são valores válidos.

Observações:

• Quando caracteres curinga são usados, essas políticas se aplicam apenas a classes de mensagem que não têm uma configuração de conteúdo específica. Portanto, IPM. NOTA. O SMIME substitui o IPM. NOTA.*.
• Configurações específicas substituem configurações gerais, por exemplo, o Voicemail substitui AllMailboxContent.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MessageFormatForJournaling

O parâmetro MessageFormatForJournaling especifica o formato de mensagem no qual um item deve ser publicado em diário. É possível usar os seguintes valores:

• Formato UseMsg Outlook .msg
• Formato MAPI do UseTnef Outlook

Type:	JournalingFormat
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-MoveToDestinationFolder

O parâmetro MoveToDestinationFolder especifica a pasta de destino para uma ação de movimentação.

A pasta de destino deve ser uma pasta personalizada gerenciada existente. Se não for, um erro será retornado. Se o parâmetro MoveToDestinationFolder não estiver presente e o valor do parâmetro RetentionAction for MoveToFolder, um erro será retornado.

Type:	ELCFolderIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-Name

O parâmetro Name especifica um nome exclusivo para as configurações de conteúdo gerenciado.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionAction

O parâmetro RetentionAction especifica uma das seguintes ações:

• Marcar como fora do limite de retenção
• Mover para uma pasta personalizada gerenciada
• Mover para a pasta Itens Excluídos
• Excluir e permitir recuperação
• Excluir permanentemente

Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.

Type:	RetentionAction
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-RetentionEnabled

O parâmetro RetentionEnabled especifica que a retenção é habilitada quando definida como $true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TriggerForRetention

O parâmetro TriggerForRetention especifica a data considerada como a data de início do período de retenção. Um item pode atingir seu limite de retenção um número específico de dias após a entrega do item ou depois que ele foi movido para uma pasta.

Os valores válidos incluem:

• WhenDelivered
• WhenMoved

Esse valor corresponde à 0x4 bit do atributo msExchELCFlags no Active Directory. O sinalizador será definido como $true se o item expirar com base na data em que foi movido e $false se o item expirar com base na data de entrega.

Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como $true, um erro será retornado.

Type:	RetentionDateType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

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.