Set-ManagedContentSettings

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

Use o cmdlet Set-ManagedContentSettings para modificar as configurações de conteúdo gerenciado existentes para uma pasta gerenciada.

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

Syntax

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

Description

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. Para obter mais informações sobre configurações de conteúdo gerenciado, consulte Gerenciamento de Registros de Mensagens.

Embora o cmdlet New-ManagedContentSettings tenha o parâmetro MessageClass, o cmdlet Set-ManagedContentSettings não o tem. Se quiser alterar o tipo de mensagem ao qual as diretivas de conteúdo se aplicam, exclua e depois crie novamente as configurações de conteúdo. Para mais informações sobre o parâmetro MessageClass, consulte New-ManagedContentSettings.

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

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

Este exemplo especifica o endereço do destinatário do registro em diário que é o destino das operações de diário.

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
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 partir da data em que o item foi entregue ou da data em que um item foi criado, caso não tenha 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

-Identity

O parâmetro Identity especifica o nome, o DN ou o GUID das configurações de conteúdo gerenciado.

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

-JournalingEnabled

O parâmetro JournalingEnabled especifica se o registro em diário está habilitado quando está 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

-MessageFormatForJournaling

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

  • UseMsg Microsoft Outlook . Formato 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 o nome da pasta de destino para uma ação de retenção.

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:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetentionAction

O parâmetro RetentionAction especifica uma das ações seguintes a ser tomada quando um item atinge seu limite de idade de retenção, especificado pelo parâmetro AgeLimitForRetention. As seguintes ações de retenção podem ser usadas:

  • 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 se a retenção está habilitada quando estiver 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

-TriggerForRetention

O parâmetro TriggerForRetention especifica a data considerada a data inicial 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 de ter sido movido para uma pasta específica.

Os valores válidos incluem:

  • Quando entregue O item expira com base em quando ele foi entregue.
  • QuandoMoved O item expira com base na data em que foi movido.

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.