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.