Compartilhar via


New-ManagedContentSettings

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2009-09-16

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

Sintaxe

New-ManagedContentSettings -Name <String> -FolderName <ELCFolderIdParameter> -MessageClass <String> [-AddressForJournaling <RecipientIdParameter>] [-AgeLimitForRetention <Nullable>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-JournalingEnabled <$true | $false>] [-LabelForJournaling <String>] [-MessageFormatForJournaling <UseMsg | UseTnef>] [-MoveToDestinationFolder <ELCFolderIdParameter>] [-RetentionAction <MoveToDeletedItems | MoveToFolder | DeleteAndAllowRecovery | PermanentlyDelete | MarkAsPastRetentionLimit>] [-RetentionEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-TriggerForRetention <WhenDelivered | WhenMoved>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

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

  • Controlando a retenção e a remoção de conteúdo que não é mais necessário.

  • Registrando em diário automaticamente o conteúdo importante para um local de armazenamento separado fora da caixa de correio.

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

Para executar o cmdlet New-ManagedContentSettings, você deve usar a conta à qual esteja delegada a seguinte função:

  • Função Administrador da Organização do Exchange

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

FolderName

Necessário

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

MessageClass

Necessário

System.String

O parâmetro MessageClass especifica o tipo de mensagem ao qual se aplicam quaisquer definições de configuração de expiração e registro em diário dentro dessas configurações de conteúdo.

  • O valor do parâmetro deve ser uma classe de mensagem específica, como IPM.NOTE.SMIME ou uma classe de mensagem personalizada.

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

  • Uma classe de mensagem específica (por exemplo, IPM.NOTE)

  • O caractere curinga de asterisco (*) indica que as configurações do conteúdo são aplicáveis a todas as classes de mensagem.

  • Uma classe de mensagem específica que tenha o caractere curinga de asterisco. O caractere curinga de asterisco deve ser o último caractere na classe de mensagem.

    Exemplos:

    • IPM.NOTE* (Inclui o IPM.NOTE e todas as subclasses.)

    • IPM.NOTE.* (Inclui as subclasses para IPM.NOTE mas não o próprio IPM.NOTE)

    • *.NOTE e IPM.*.NOTE não são aceitáveis.

Dica

Quando caracteres curinga são utilizados, essas diretivas se aplicam apenas às classes de mensagem que não possuem uma configuração de conteúdo específica. Sendo assim, IPM.NOTE.SMIME substitui IPM.NOTE.*

Dica

Configurações específicas substituem configurações gerais. Por exemplo, Mensagem de voz substitui Todo Conteúdo da Caixa de Correio.
A lista a seguir descreve tipos de mensagem conhecidos e fornece os valores que devem ser usados:

  • Para o tipo Todas as mensagens de conteúdo da caixa de correio, use o valor *.

  • Para o tipo de mensagem Itens de Calendário, use o valor IPM.Appointment*.

  • Para o tipo Mensagem dos Contatos, use o valor IPM.Contact*.

  • Para o tipo de mensagem Documentos, use o valor IPM.Document*.

  • Para o tipo de mensagem Faxes, use o valor IPM.Note.Microsoft.Fax.

  • Para o tipo de mensagem de itens Diário, use o valor IPM.Activity.

  • Para o tipo de mensagem Solicitações de reunião, respostas e cancelamentos use o valor IPM.Schedule*.

  • Para o tipo de mensagem Notas, use o valor IIPM.StickyNote.

  • Para o tipo de mensagem Postagens, use o valor IPM.Post.

  • Para o tipo de mensagem Postagens, use o valor IPM.Post.RSS.

  • Para o tipo de mensagem Tarefas, use o valor IIPM.Task*.

  • Para o tipo de mensagem Correio de Voz, use o valor IPM.Note.Microsoft.Voicemail*.

Name

Necessário

System.String

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

AddressForJournaling

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro AddressForJournaling especifica o endereço do repositório que será o destino da operação de diário. Se esse parâmetro não estiver presente e o parâmetro JournalingEnabled estiver definido como $true, um erro será retornado.

AgeLimitForRetention

Opcional

System.Nullable

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

Confirm

Optional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o FQDN (nome de domínio totalmente qualificado) do controlador de domínio que grava essas informações de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

JournalingEnabled

Opcional

System.Boolean

O parâmetro JournalingEnabled indica que o diário estará habilitado quando ele estiver definido como $true.

LabelForJournaling

Opcional

System.String

O parâmetro LabelForJournaling especifica um rótulo que será anexado a um item. Esse rótulo será usado pelo armazenamento de destino para determinar o conteúdo do item e forçar a diretiva apropriada.

MessageFormatForJournaling

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.JournalingFormat

O parâmetro MessageFormatForJournaling permite que o administrador especifique se um item deve ser registrado no diário no formato .msg do Microsoft Outlook ou no formato MAPI tradicional do Outlook.

MoveToDestinationFolder

Opcional

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

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

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

RetentionAction

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionActionType

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.

RetentionEnabled

Opcional

System.Boolean

O parâmetro RetentionEnabled especifica que a retenção está habilitada quando ele estiver definido como $true.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido ao parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma duplicata exata do objeto em um servidor local ou de destino.

TriggerForRetention

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

Esse parâmetro TriggerForRetention indica a data de início que será usada como início do período de retenção. Um item pode atingir seu limite de retenção em um número específico de dias depois que o item foi entregue ou depois que ele foi movido para uma pasta específica.

Esse valor corresponde a 0x4 bits do atributo msExchELCFlags em Active Directory. O sinalizador será definido como $true se o item expirar com base na data 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 for definido como $true, um erro será retornado.

WhatIf

Optional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

  

Exceções

Exceções Descrição

  

Exemplo

No primeiro exemplo, o comando New-ManagedContentSettings é usado para criar configurações de conteúdo gerenciado da classe de mensagem Calendário e denominado MyCalendarContentSettings. As configurações de conteúdo gerenciado se aplicam à pasta Calendário padrão. A retenção é habilitada e itens são movidos para a pasta Itens Excluídos depois de 30 dias.

No segundo exemplo, stubs (de uma classe de mensagem personalizada chamada IPM.Note.Archive.Shortcut) de conteúdo arquivado em Caixas de Entrada de usuário são excluídos com a configuração de conteúdo gerenciado RemoveArchiveStubs.

Para obter mais informações sobre classes de mensagem, consulte a descrição do parâmetro "MessageClass" neste tópico e a seção "About message classes" (Sobre classes de mensagem) do artigo 241235 da Base de Dados de Conhecimento Microsoft, How to globally change the default forms in Outlook by using the Forms Administrator utility.

New-ManagedContentSettings -FolderName Calendar -MessageClass Calendar -Name MyCalendarContentSettings -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "30"
New-ManagedContentSettings -FolderName Inbox -MessageClass IPM.Note.Archive.Shortcut -Name RemoveArchiveStubs -RetentionEnabled $true -RetentionAction MoveToDeletedItems -AgeLimitForRetention "1"