Get-TransportRule
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-06-28
Use as regras de transporte de exibição do cmdlet Get-TransportRule que estão configuradas em um computador com a função de servidor de Transporte de Hub ou de Transporte de Borda do Microsoft Exchange Server 2007 instalada.
Sintaxe
Get-TransportRule [-Identity <RuleIdParameter>] [-DomainController <Fqdn>] [-State <Enabled | Disabled>]
Descrição detalhada
O cmdlet Get-TransportRule permite exibir a configuração de regras de transporte que estão definidas em um servidor de Transporte de Hub ou de Transporte de Borda. Se você executar esse comando em um servidor de Transporte de Hub, todas as regras de transporte configuradas na organização, exceto as regras configuradas em um servidor de Transporte de Borda, serão exibidas. Se executar esse comando em um servidor de Transporte de Borda, apenas as regras configuradas no servidor de Transporte de Borda local serão exibidas.
Para obter informações sobre como configurar regras de transporte executadas em relação a mensagens de email em uma organização do Exchange 2007, consulte Set-TransportRule.
Para obter informações sobre o agente de Regras de Transporte, consulte Visão geral de regras de transporte.
Para executar o cmdlet Get-TransportRule em um computador em que a função de servidor de Transporte de Hub esteja instalada, faça logon com uma conta de domínio que tenha as permissões atribuídas ao grupo Administradores Somente para Exibição do Exchange. A conta também deve ser membro do grupo Administradores local no computador.
Para executar o cmdlet Get-TransportRule em um computador em que a função de servidor de Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no computador.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
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 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 de Transporte de Borda. A função de servidor de Transporte de Borda grava somente na instância local do Active Directory Application Mode (ADAM). |
Identity |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Use esse parâmetro para especificar a regra de transporte a ser exibida. Insira a GUID ou o Name da regra. Você pode omitir o rótulo do parâmetro Identity. |
State |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.RuleState |
Use esse parâmetro para filtrar os resultados do comando Get-TransportRule. Os seguintes valores são válidos para este parâmetro:
|
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
Os exemplos a seguir mostram a sintaxe do comando Get-TransportRule. O primeiro exemplo retorna apenas a regra que corresponde ao nome "Block e-mail messages between Sales and Brokerage Groups". O comando é comunicado por pipe ao comando Format-List para exibir a configuração detalhada da regra de transporte especificada.
O segundo exemplo retorna uma lista resumida de todas as regras de transporte que estarão configuradas em uma organização do Exchange se o comando for executado em um servidor de Transporte de Hub ou as regras que estarão configuradas no computador local se o comando for executado em um servidor de Transporte de Borda.
Para obter mais informações sobre Pipelines, consulte Pipelining.
Para obter mais informações sobre como trabalhar com a saída de um comando, consulte Trabalhando com saída do comando.
Get-TransportRule "Block e-mail messages between Sales and Brokerage Groups" | Format-List
Get-TransportRule