Remove-AddressRewriteEntry

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-07-27

Use o cmdlet Remove-AddressRewriteEntry para remover uma entrada de reconfiguração de endereço existente que não seja mais necessária.

Sintaxe

remove-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

No Microsoft Exchange Server 2007, a regravação de endereços permite modificar os endereços de remetentes e destinatários em mensagens que entram e saem de uma organização do Exchange 2007. Configure os agentes de Reconfiguração de Endereço no conector de Recebimento e de Envio em um computador em que a função de servidor Transporte de Borda esteja instalada.

Para executar o cmdlet Remove-AddressRewriteEntry em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
Identity	Necessário	Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter	O parâmetro especifica a entrada de reconfiguração de endereço para ser removida. O parâmetro Identity aceitará uma GUID ou o nome exclusivo da reconfiguração de endereço. Você pode omitir o rótulo do parâmetro Identity.
Confirm	Opcional	System.Management.Automation.SwitchParameter	O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.
DomainController	Opcional	Microsoft.Exchange.Data.Fqdn	Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores em que a função de servidor Transporte de Borda está instalada. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

Os exemplos a seguir mostram como remover entradas de reconfiguração de endereço existentes que não sejam mais necessárias. O primeiro exemplo mostra como remover uma entrada de reconfiguração de endereço específica.

O segundo exemplo mostra como ver uma lista de todas as entradas de reconfiguração de endereço que serão removidas se contiverem a cadeia de caracteres "contoso.com". Para remover várias entradas de reconfiguração de endereço, você deve usar pipeline para os resultados do comando Get-AddressRewriteEntry para o comando Remove-AddressRewriteEntry. Você usa o parâmetro WhatIf para simular as ações que o comando executaria, mas sem realmente aplicar as alterações. Se você remover o parâmetro WhatIf e executar o comando novamente, as entradas de reconfiguração de endereço serão removidas.

Para obter mais informações sobre pipeline, consulte Pipelining.

Remove-AddressRewriteEntry "Address rewrite entry for contoso.com"
Get-AddressRewriteEntry "*contoso.com" | Remove-AddressRewriteEntry -WhatIf:$true

Partilhar via