Remove-TransportRule
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-TransportRule para remover uma regra de transporte do agente de Regras de Transporte em um computador em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada em uma organização do Microsoft Exchange Server 2007.
Sintaxe
Remove-TransportRule -Identity <RuleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Remove-TransportRule permite remover uma regra de transporte não mais necessária.
Para obter informações sobre o agente de Regras de Transporte, consulte Visão geral de regras de transporte.
Para executar o cmdlet Remove-TransportRule, você deve usar uma conta à qual esteja delegado o seguinte:
- Função Administrador da Organização do Exchange
Para executar o cmdlet Remove-TransportRule 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.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Use esse parâmetro para especificar a regra de transporte a ser removida. Insira a GUID ou o Name da regra. Você pode omitir o rótulo do parâmetro Identity. |
Confirm |
Optional |
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 recupera dados do 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 que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda grava somente na instância local do Active Directory Application Mode (ADAM). |
WhatIf |
Optional |
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
O exemplo a seguir mostra como usar o comando Remove-TransportRule para remover uma única regra de transporte. O parâmetro WhatIf é usado para exibir quais alterações estão prestes a serem aplicadas sem confirmar essas alterações. Se você remover o parâmetro WhatIf e executar o comando novamente, a regra de transporte será removida.
Remove-TransportRule "Redirect messages to kim@contoso.com to legal@contoso.com" -WhatIf