New-AddressRewriteEntry
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:
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:
|
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 Dica Esse parâmetro não poderá ser definido como |
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 |
|---|---|
|
Exceçõ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