Set-AddressRewriteEntry
Este cmdlet só está disponível ou em vigor em servidores de Transporte Edge no Exchange no local.
Utilize o cmdlet Set-AddressRewriteEntry para modificar uma entrada de reescrita de endereços existente que reescreve os endereços de e-mail do remetente e do destinatário em mensagens enviadas ou enviadas da sua organização através de um servidor de Transporte Edge.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Set-AddressRewriteEntry
[-Identity] <AddressRewriteEntryIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-ExceptionList <MultiValuedProperty>]
[-ExternalAddress <String>]
[-InternalAddress <String>]
[-Name <String>]
[-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
Set-AddressRewriteEntry "Address rewrite entry for contoso.com" -Name "Address rewrite entry for northwindtraders.com" -InternalAddress northwindtraders.com
Este exemplo modifica a entrada de reescrita de endereços existente denominada "Entrada de reescrita de endereços para contoso.com" com as seguintes definições:
Altera os endereços de e-mail originais que são afetados pela entrada de reescrita de endereços para todos os endereços no domínio northwindtraders.com.
Altera o valor Nome para "Entrada de reescrita de endereços para northwindtraders.com".
Exemplo 2
Set-AddressRewriteEntry "Address rewrite entry for all contoso.com email addresses" -OutboundOnly $true
Este exemplo altera a entrada de reescrita de endereços existente denominada "Entrada de endereço para todos os endereços de e-mail contoso.com" de entrada e saída apenas para saída. Tem de configurar um endereço proxy que corresponda ao endereço de e-mail reescrito de todos os destinatários afetados.
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 nomes de domínio que devem ser excluídos da reescrita de endereços quando o parâmetro InternalAddress contém um valor que especifica vários nomes de domínio. Pode separar vários nomes de domínio incluídos com o parâmetro ExceptionList com vírgulas. Para obter mais informações sobre como adicionar valores ou remover valores de propriedades de valores múltiplos, veja Modificar propriedades de valores múltiplos.
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: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Identity especifica a entrada de reescrita de endereços que pretende modificar. Pode especificar o nome ou GUID da entrada de reescrita de endereços.
Propriedades do parâmetro
| Tipo: | AddressRewriteEntryIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| 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: | False |
| 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: | Named |
| Obrigatório: | False |
| 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.