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 |
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 |
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:
Se esse parâmetro não estiver presente e o parâmetro RetentionEnabled estiver definido como |
RetentionEnabled |
Opcional |
System.Boolean |
O parâmetro RetentionEnabled especifica que a retenção está habilitada quando ele está definido como |
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 |
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