New-AddressRewriteEntry

Esse cmdlet está disponível ou é eficaz somente em servidores de Transporte de Borda no Exchange local.

Use o cmdlet New-AddressRewriteEntry para criar uma entrada de regravação de endereço que regrava endereços de email do remetente e do destinatário nas mensagens enviadas de ou para a sua organização por meio do servidor de Transporte de Borda.

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

Syntax

New-AddressRewriteEntry
   [-Name] <String>
   -ExternalAddress <String>
   -InternalAddress <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExceptionList <MultiValuedProperty>]
   [-OutboundOnly <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Nos servidores de Transporte de Borda, você deve ser um membro do grupo local de administradores para executar esse cmdlet.

Exemplos

Exemplo 1

New-AddressRewriteEntry -Name "Address rewrite entry for david@contoso.com" -InternalAddress david@contoso.com -ExternalAddress david@northwindtraders.com

Este exemplo cria uma entrada de reescrita de endereço que reescreve o endereço david@contoso.com de email para david@northwindtraders.com no email de saída. Como o parâmetro OutboundOnly não está definido como $true, o email de entrada enviado para david@northwindtraders.com é reescrito de volta para david@contoso.com.

Exemplo 2

New-AddressRewriteEntry -Name "Address rewrite entry for all contoso.com email addresses" -InternalAddress contoso.com -ExternalAddress northwindtraders.com

Este exemplo cria uma entrada de regravação de endereço que regrava todos os endereços de email no domínio contoso.com como northwindtraders.com no email de saída. Porque o parâmetro OutboundOnly não foi definido como $true, o email de saída enviado para destinatários do northwindtraders.com foi regravado como contoso.com.

Exemplo 3

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

Este exemplo cria uma entrada de regravação de endereço que regrava todos os endereços de email no domínio contoso.com e todos os subdomínios como northwindtraders.com. Entretanto, os endereços de email em research.contoso.com e em corp.contoso.com não são regravados. Como essa entrada de regravação de endereço afeta um domínio e todos os subdomínios (*.contoso.com), a regravação de endereço só acontece no email de saída.

Parâmetros

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExceptionList

O parâmetro ExceptionList especifica os domínios de endereço de email que não devem ser regravados quando o parâmetro InternalAddress contém o caractere curinga para regravar endereços em um domínio e em todos os subdomínios (*.contoso.com). Você pode inserir vários valores de domínio no parâmetro ExceptionList, separados por vírgulas.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalAddress

O parâmetro ExternalAddress especifica os endereços de email finais que você quer. Se o parâmetro InternalAddress especificar um único endereço de email (chris@contoso.com), o parâmetro ExternalAddress também deverá especificar um único endereço de email (support@contoso.com). Se o parâmetro InternalAddress especificar um único domínio (contoso.com) ou um domínio e todos os subdomínios (*.contoso.com), o parâmetro ExternalAddress deverá especificar um único domínio (fabrikam.com).

Não é possível usar o caractere curinga (*) com o parâmetro ExternalAddress.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalAddress

O parâmetro InternalAddress especifica os endereços de email originais que você quer alterar. É possível usar os seguintes valores:

  • Endereço de email único: david@contoso.com
  • Domínio único: contoso.com ou sales.contoso.com
  • Domínio e todos os subdomínios: *.contoso.com
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

O parâmetro Name especifica um nome exclusivo para esta entrada de regravação de endereço.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-OutboundOnly

O parâmetro OutboundOnly habilita ou desabilita a regravação de endereço somente de saída. A entrada válida para esse parâmetro é $true ou $false. O valor $true significa que a regravação de endereço ocorre somente no email de saída. O valor $false significa que a regravação de endereço ocorre no email de saída e também no email de entrada (endereços de email regravados são mudados de volta para o endereço original no email de entrada). O valor padrão é $false.

Defina este parâmetro como $true se o parâmetro InternalAddress contiver o caractere curinga para regravar endereços em um domínio e em todos os subdomínios (*.contoso.com).

Além disso, quando você configura regravação de endereço somente de saída, é preciso configurar o endereço de email regravado como um endereço proxy nos destinatários afetados. Por exemplo, se laura@sales.contoso.com for reescrito para laura@contoso.com, o endereço laura@contoso.com proxy deverá ser configurado na caixa de correio de Laura. Isso permite que respostas e mensagens de entrada sejam entregues corretamente.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-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, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.