Remove-AddressRewriteEntry
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 |
|---|---|
|
Exceçõ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