New-TransportRule
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2007-08-13
Use o cmdlet New-TransportRule para criar uma nova regra de transporte a ser usada pelo agente de Regras de Transporte ao processar 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
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet New-TransportRule permite que você crie uma nova regra de transporte que o agente de Regras de Transporte usa ao processar mensagens de email transmitidas por um servidor de Transporte de Hub ou Transporte de Borda em uma organização do Exchange 2007.
Cada condição e exceção deve usar um predicado de regra aceito. Cada predicado consiste no próprio predicado e no valor a ser testado.
Para obter uma lista de predicados de regras de transporte aceitos, consulte Predicados da regra de transporte.
Cada ação deve usar uma regra de ação aceita. Cada ação consiste na própria ação e nos valores que a ação usa para executar sua tarefa.
Para obter uma lista de ações de regras de transporte aceitas, consulte Ações de regras de transporte.
Para obter informações detalhadas sobre como criar uma nova regra de transporte, consulte Como criar uma nova 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 New-TransportRule, você deve usar a conta à qual esteja delegado o seguinte:
- Função Administrador da Organização do Exchange
Para executar o cmdlet New-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 |
|---|---|---|---|
Actions |
Necessário |
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. |
Name |
Necessário |
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. |
Comments |
Opcional |
System.String |
Use esse parâmetro para adicionar comentários informativos à regra, por exemplo, a função da regra ou como ela é alterada com o tempo. O comentário não pode exceder 1024 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 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 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). |
Enabled |
Opcional |
System.Boolean |
Use esse parâmetro para especificar se a regra de transporte deve ser habilitada ou desabilitada ao ser criada. O valor padrão é |
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 nesta regra será aplicada à mensagem. |
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. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Quando um objeto existente for fornecido a esse parâmetro, o comando usará a configuração desse objeto para criar uma cópia idêntica do objeto no servidor local ou de destino. Para obter mais informações, consulte Modelos. |
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 a seguir mostra como criar uma nova regra de transporte em um servidor de Transporte de Hub.
Essa regra aplica as seguintes condições:
- entre lista de distribuição e lista de distribuição O valor da primeira propriedade do predicado para essa condição é o grupo de distribuição "Grupo de Vendas". O segundo valor de propriedade de predicado desta condição é o grupo de distribuição "Brokerage Group".
As seguintes exceções são aplicadas:
com padrões de texto no assunto O valor dessa exceção é "Press Release" ou "Corporate Communication".
de pessoas Os valores desta exceção são os usuários Ted Bremer e Pilar Ackerman.
As ações a seguir serão aplicadas a todas as mensagens que corresponderem às condições descritas anteriormente, mas que não corresponderem às exceções "com padrões de texto no assunto" ou "de pessoas":
enviar mensagem repercutida ao remetente Esse valor para essa ação é "Mensagens de email enviadas entre o departamento de Vendas e o departamento de Corretagem são proibidas".
evento de log com mensagem O valor para essa ação é "Uma mensagem de email proibida foi rejeitada."
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)