Share via

Set-AddressRewriteEntry (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-07

Use o cmdlet Set-AddressRewriteEntry para modificar uma entrada de reconfiguração de endereço existente que reconfigura os endereços de email do remetente e do destinatário nas mensagens de email enviadas de e para uma organização de email.

Sintaxe

set-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>]

set-addressrewriteentry [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-ExternalAddress <String>] [-Instance <AddressRewriteEntry>] [-InternalAddress <String>] [-Name <String>] [-OutboundOnly <$true | $false>]

Descrição detalhada

No Microsoft Exchange Server 2007, a regravação de endereços permite modificar os endereços de remetentes e destinatários em mensagens que entram e saem de uma organização do Exchange 2007. Configure os agentes de Reconfiguração de Endereço no conector de Recebimento e de Envio em um computador em que a função de servidor Transporte de Borda esteja instalada.

Para executar o cmdlet Set-AddressRewriteEntry em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon usando uma conta que seja membro do grupo Administradores local nesse computador.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter

Esse parâmetro especifica a entrada de reconfiguração de endereço a ser modificada. O parâmetro Identity aceitará uma GUID ou o nome exclusivo da reconfiguração de endereço.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. Os servidores de Transporte de Borda não dão suporte ao parâmetro DomainController. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.

ExceptionList

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os nomes de domínio que não devem ser reconfigurados quando o parâmetro InternalAddress contém um valor que especifique vários nomes de domínio. É possível separar os diversos nomes de domínio incluídos entre vírgulas no parâmetro ExceptionList.

ExternalAddress

Opcional

System.String

Esse parâmetro permite que o administrador modifique o endereço de email externo ou o nome de domínio usado ao reconfigurar um endereço de email interno ou um nome de domínio. Se um endereço de email for especificado em InternalAddress, o valor especificado em ExternalAddress também deverá ser um endereço de email. Se um nome de domínio ou nome de domínio com caractere curinga for especificado em InternalAddress, um nome de domínio deverá ser especificado em ExternalAddress. Endereços ou nomes de domínio podem ser inseridos nos dois formatos a seguir:

  • Endereço de email   Reconfigure um único endereço de email interno usando o endereço especificado. Por exemplo, david@northwindtraders.com.

  • Nome de domínio   Reconfigure todos os endereços de email internos incluídos em InternalAddress usando o nome de domínio externo especificado. Por exemplo, northwindtraders.com.

Dica

O caractere de asteriisco não pode ser usado com o parâmetro ExternalAddress.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.AddressRewriteEntry

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

InternalAddress

Opcional

System.String

Esse parâmetro permite que o administrador modifique o endereço de email interno ou o nome de domínio que estiver sendo reconfigurado. Endereços ou nomes de domínio podem ser inseridos nos três formatos a seguir:

  • Endereço de email único   Reconfigurar somente o endereço especificado. Por exemplo, david@contoso.com.

  • Nome de domínio  Reconfigura todos os endereços de email associados ao nome de domínio especificado. Por exemplo, contoso.com.

  • Nome de domínio com asterisco   Reconfigura todos os endereços de email associados ao nome de domínio especificado, bem como todos os subdomínios. Por exemplo, *.contoso.com.

Name

Opcional

System.String

Este parâmetro permite que o administrador modifique o nome exclusivo dessa entrada de regravação de endereço.

OutboundOnly

Opcional

System.Boolean

Esse parâmetro permite que o administrador defina se os endereços de email devem ser reconfigurados somente quando as mensagens de email saem da organização do Exchange Server 2007 ou se os endereços devem ser reconfigurados quando as mensagens são enviadas em ambas as direções. Os dois valores possíveis para esse parâmetro são $true ou $false. O valor padrão é $false.

Dica

O parâmetro não poderá ser definido como $false se o valor especificado em InternalAddress contiver um caractere coringa.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Os exemplos a seguir mostram como modificar uma entrada de reconfiguração de endereço existente. O primeiro exemplo define o nome de domínio interno a ser reconfigurado. O nome descritivo da entrada também é alterado para refletir o novo domínio a ser reconfigurado.

O segundo exemplo define o parâmetro OutboundOnly como $true. Essa ação faz com que o agente de Reconfiguração de Endereço reconfigure endereços apenas em emails de saída da organização do Exchange 2007.

Importante

Os remetentes internos afetados por uma entrada de reconfiguração de endereço com o parâmetro OutboundOnly definido como $true devem ter um endereço de proxy configurado que corresponda ao endereço de email reconfigurado.

Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com 
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com e-mail addresses" -OutboundOnly:$true