Set-AddressRewriteEntry (RTM)

Artigo
09/30/2014

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

Exceçõ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

Compartilhar via