New-AddressRewriteEntry
Este cmdlet só está disponível ou em vigor em servidores de Transporte Edge no Exchange no 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.
Sintaxe
Default (Padrão)
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ços que reescreve o endereço david@contoso.com de e-mail para david@northwindtraders.com no correio de saída. Uma vez que o parâmetro OutboundOnly não está definido como $true, o e-mail de entrada enviado para david@northwindtraders.com é reescrito 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 estes cmdlets, você pode pular o pedido 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExceptionList
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExternalAddress
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 e-mail (chris@contoso.com), o parâmetro ExternalAddress também tem de especificar um único endereço de e-mail (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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InternalAddress
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro InternalAddress especifica os endereços de email originais que você quer alterar. É possível usar os seguintes valores:
- Endereço de e-mail único: david@contoso.com
- Domínio único: contoso.com ou sales.contoso.com
- Domínio e todos os subdomínios: *.contoso.com
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Name especifica um nome exclusivo para esta entrada de regravação de endereço.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OutboundOnly
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 predefinido é $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 tem de ser configurado na caixa de correio da Laura. Isso permite que respostas e mensagens de entrada sejam entregues corretamente.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.