New-AddressRewriteEntry

Este cmdlet está disponível ou é efetivo 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.

Examples

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 regravação de endereço que regrava o endereço de email david@contoso.com como david@northwindtraders.com, no email de saída. Como o parâmetro OutboundOnly não foi definido como $true, o email de saída enviado para david@northwindtraders.com foi regravado como 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 reconfiguração de endereço afeta um domínio e todos os subdomínios ( * . contoso.com), a reconfiguração de endereço ocorre somente no email de saída.

Parameters

-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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, 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
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.

Não há suporte para o parâmetro DomainController na função de servidor Transporte de Borda. Um servidor de transporte de borda usa a instância local do Active Directory Lightweight Directory Services (AD LDS) para ler e gravar dados.

Type:Fqdn
Position:Named
Default value:None
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 reconfigurados quando o parâmetro InternalAddress contiver o caractere curinga para regravar endereços em um domínio e 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
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 especifica um único endereço de email (chris@contoso.com), o parâmetro ExternalAddress também deve 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).

Você não pode usar o caractere curinga ( * ) com o parâmetro ExternalAddress.

Type:String
Position:Named
Default value:None
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
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
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.

Você deve definir esse parâmetro para $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 regravado como laura@contoso.com, o endereço proxy laura@contoso.com deve ser configurado na caixa de correio da Laura. Isso permite que respostas e mensagens de entrada sejam entregues corretamente.

Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Inputs

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.

Outputs

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.