Set-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 Set-TransportRule para modificar uma regra de transporte existente que o agente de Regras de Transporte usa quando processa mensagens de email que passam por um computador em que a função de servidor Transporte de Hub ou de Transporte de Borda esteja instalada.
Sintaxe
Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Set-TransportRule permite modificar uma regra de transporte existente que o agente de Regras de Transporte usa quando processa mensagens de email que passam por um servidor de Transporte de Hub ou de Transporte de Borda.
Cada condição e exceção deve usar um predicado de regra de transporte aceito. Cada predicado consiste em pelo menos uma condição e os valores que a condição testa.
Para obter uma lista de predicados de regras de transporte aceitos, consulte Predicados da regra de transporte.
Cada ação deve usar uma ação de regra de transporte aceita. Cada ação consiste em pelo menos uma ação e os valores que a ação usa para realizar sua tarefa.
Para obter uma lista de ações de regras aceitas, consulte Ações de regras de transporte.
Para obter informações detalhadas sobre como modificar uma regra de transporte existente, consulte Como modificar uma regra de transporte.
Para obter informações sobre o agente de Regras de Transporte, consulte Visão geral de regras de transporte.
Para executar o cmdlet Set-TransportRule, você deve usar a conta à qual esteja delegado o seguinte:
- Função Administrador da Organização do Exchange
Para executar o cmdlet Set-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 Microsoft Exchange Server 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 GUID da regra de transporte ou o nome da regra que foi configurado pelo administrador quando a regra foi criada. |
Actions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
Use este parâmetro para especificar as ações que a regra de transporte aplicará à mensagem de email se todas as condições forem atendidas e nenhuma exceção for atendida. É necessário especificar pelo menos uma ação para cada regra. |
Comments |
Opcional |
System.String |
Use esse parâmetro para adicionar comentários informativos à regra de transporte, como para que a regra é utilizada ou como ela se alterou com o tempo. O comentário não pode exceder 512 caracteres. |
Conditions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Use este parâmetro para especificar as condições que serão aplicadas pela regra de transporte a todas as mensagens de email enviadas ao agente de Regras de Transporte. Se você não configurar uma condição em uma regra, a regra será aplicada a todas as mensagens se nenhuma exceção for correspondida. |
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 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). |
Exceptions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Use este parâmetro para especificar as exceções que a regra de transporte aplicará à mensagem de email. Se uma mensagem corresponder a alguma exceção, nenhuma ação especificada nessa regra será aplicada à mensagem. |
Instance |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule |
Use esse parâmetro para passar um objeto inteiro para o comando para ser processado. Esse parâmetro é usado principalmente em scripts em que um objeto inteiro deve ser passado para o comando. |
Name |
Opcional |
System.String |
Use este parâmetro para especificar o nome para exibição da regra de transporte a ser criada. O tamanho do nome não pode exceder 64 caracteres. |
Priority |
Opcional |
System.Int32 |
Use este parâmetro para especificar a ordem em que as regras de transporte serão aplicadas. Se você modificar a prioridade da regra, a posição da regra na lista de regras será alterada para corresponder à prioridade especificada e o agente de Regras de Transporte incrementará todas as regras com um valor de prioridade maior. As regras com um valor de prioridade menor são processadas primeiro. O valor deste parâmetro deve ser maior ou igual a 0. |
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
A seguir há um exemplo completo que mostra como modificar uma regra de transporte existente em um servidor de Transporte de Hub. Esse exemplo mostra como você pode modificar as condições em uma regra de transporte sem afetar as exceções ou as ações na mesma regra.
Essa regra será modificada para aplicar a seguinte condição:
- do membro de lista de distribuição O valor para essa condição é o grupo de distribuição "Sales Group".
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)