New-AddressRewriteEntry

Artigo
09/30/2014

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

Tópico modificado em: 2010-10-20

Use o cmdlet New-AddressRewriteEntry para criar uma nova entrada de regravação de endereço que regrava endereços de email do remetente e do destinatário em mensagens de email enviadas de e para uma organização de email.

Sintaxe

new-AddressRewriteEntry -Name <String> -ExternalAddress <String> -InternalAddress <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExceptionList <MultiValuedProperty>] [-OutboundOnly <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

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 de Transporte de Borda esteja instalada.

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

Dica

Você só pode usar um endereço de email. Você não pode mapear vários endereços de email para um endereço de email.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
ExternalAddress	Necessário	System.String	Esse parâmetro especifica o endereço de email ou nome de domínio externo que é usado quando você reconfigura um endereço de email ou nome de domínio interno. 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 um nome de domínio com um 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 Reconfigurar um endereço de email único interno usando o endereço especificado. Por exemplo, `david@northwindtraders.com`. Nome de domínio Reconfigurar 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.
InternalAddress	Necessário	System.String	Esse parâmetro especifica o endereço de email ou nome de domínio interno a ser 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 Reconfigurar todos os endereços de email associados ao nome de domínio especificado. Por exemplo, `contoso.com`. Nome de domínio com asterisco Reconfigurar todos os endereços de email associados ao nome de domínio especificado e todos os subdomínios. Por exemplo, `*.contoso.com`.
Name	Necessário	System.String	Este parâmetro permite que o administrador modifique o nome exclusivo dessa entrada de regravação de endereço.
Confirm	Opcional	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 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 de 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. Para obter mais informações sobre como adicionar valores ou remover valores de propriedades com vários valores, consulte Modificando propriedades com valores múltiplos.
OutboundOnly	Opcional	System.Boolean	Esse parâmetro especifica se endereços de email deverão ser reconfigurados apenas quando mensagens de email saírem da organização do Exchange 2007 ou se endereços deverão ser reconfigurados quando mensagens forem 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 Esse parâmetro não poderá ser definido como `$false` se o valor especificado em InternalAddress contiver um caractere curinga.
TemplateInstance	Opcional	System.Management.Automation.PSObject	Quando um objeto existente for fornecido a esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto no servidor local ou de destino. Para obter mais informações, consulte Modelos.
WhatIf	Opcional	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

Exceções

Exceções	Descrição

Exemplo

Os exemplos a seguir mostram três cenários diferentes:

Reconfigurar um único endereço de email. Mensagens de email em ambas as direções são reconfiguradas.
Reconfigurar todos os endereços de email para o domínio contoso.com. Mensagens de email em ambas as direções são reconfiguradas.
Reconfigurar todos os endereços de email para o domínio contoso.com, e todos os subdomínios, exceto research.contoso.com e corp.contoso.com. Apenas mensagens de email de saída serão reconfiguradas.

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com e-mail addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com
New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com and subdomain e-mail addresses" -InternalAddress *.contoso.com -ExternalAddress northwindtraders.com -OutboundOnly:$true -ExceptionList research.contoso.com,corp.contoso.com

Compartilhar via