Compartilhar via


Set-ManagedContentSettings

 

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

Tópico modificado em: 2007-10-08

Use o cmdlet Set-ManagedContentSettings para alterar as Configurações de Conteúdo Gerenciado correspondentes.

Sintaxe

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

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

Descrição detalhada

Configurações de conteúdo gerenciado são configurações que você aplica a pastas gerenciadas para controlar o tempo de vida de itens nas caixas de correio dos usuários. Para obter mais informações sobre configurações de conteúdo gerenciado, consulte Administrando o Gerenciamento de Registros de Mensagens.

Para executar o cmdlet Set-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.

Dica

Embora o cmdlet New-ManagedContentSettings possua o parâmetro MessageClass, o comando Set-ManagedContentSettings não o possui. Se desejar alterar o tipo de mensagem à qual as configurações do conteúdo se aplicam, será necessário excluir e recriar as configurações de conteúdo. Para obter mais informações sobre o parâmetro MessageClass, consulte New-ManagedContentSettings.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.ELCContentSettingsIdParameter

O parâmetro Identity especifica o nome, o nome distinto ou a GUID da diretiva de caixa de correio de pasta gerenciada.

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.

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 do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ElcContentSettings

O parâmetro Instance especifica a identidade das configurações de conteúdo da pasta gerenciada.

JournalingEnabled

Opcional

System.Boolean

O parâmetro JournalingEnabled indica que o diário está habilitado quando ele está 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 o nome da pasta de destino para uma ação de retenção.

Name

Opcional

System.String

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

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 está definido como $true.

TriggerForRetention

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.RetentionDateType

O parâmetro TriggerForRetention indica a data de início que será usada como o 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 em que ele foi movido e como $false se expirar com base na data da entrega. Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver 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

Nesse exemplo, o comando Set-ManagedContentSettings é utilizado para especificar o endereço do repositório que será o destino de uma operação de diário.

Set-ManagedContentSettings -Identity MyManagedContentSettings -AddressForJournaling MySmtpAddress@contoso.com