Compartilhar via


Disable-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 Disable-TransportRule para instruir o agente de Regras de Transporte a desabilitar o processamento de uma regra de transporte específica para todas as mensagens de email transmitidas por um computador em que a função de servidor Transporte de Hub ou Transporte de Borda do Microsoft Exchange Server 2007 esteja instalada.

Sintaxe

Disable-TransportRule -Identity <RuleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Disable-TransportRule instrui o agente de Regras de Transporte a desabilitar o processamento de uma regra de transporte específica para todas as mensagens de email transmitidas por meio de um servidor de Transporte de Hub ou Transporte de Borda.

Para obter informações sobre como habilitar o processamento de regras de transporte para mensagens de email em uma organização do Exchange 2007, consulte Enable-TransportRule.

Para obter informações sobre o agente de Regras de Transporte, consulte Visão geral de regras de transporte.

Para executar o cmdlet Disable-TransportRule, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função Administrador da Organização do Exchange

Para executar o cmdlet Disable-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 a ser desabilitada. Insira a GUID ou o Name da regra.

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 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

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

O exemplo de código a seguir mostra a sintaxe do comando Disable-TransportRule.

Disable-TransportRule "Block e-mail messages between Sales and Brokerage groups"