Set-TransportRule
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-27
Utilice el cmdlet Set-TransportRule para modificar una regla de transporte existente que utilice el agente de reglas de transporte al procesar mensajes de correo electrónico que pasan a través de un equipo con la función del servidor Transporte de concentradores o de transporte perimetral instalada.
Sintaxis
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>]]
Descripción detallada
El cmdlet Set-TransportRule le permite modificar una regla de transporte existente que utilice el agente de reglas de transporte al procesar mensajes de correo electrónico que pasan a través de un servidor de transporte de concentradores o de transporte perimetral.
Cada condición y excepción debe utilizar un predicado de regla de transporte admitida. Cada predicado consta de, al menos, una condición y de los valores que la condición pone a prueba.
Para obtener una lista de los predicados de regla admitidos, vea Predicados de la regla de transporte (en inglés).
Cada acción debe utilizar una acción de regla de transporte admitida. Cada acción consta de, al menos, una acción y de los valores que la acción utiliza para llevar a cabo su tarea.
Para obtener una lista de las acciones de regla admitidas, vea Acciones de regla de transporte (en inglés).
Para obtener información detallada sobre cómo modificar una regla de transporte específica, vea Cómo modificar una regla de transporte (en inglés).
Para obtener más información acerca del agente de reglas de transporte, vea Introducción a las reglas de transporte (en inglés).
Para ejecutar el cmdlet Set-TransportRule, la cuenta que utilice debe tener delegadas las siguientes funciones:
- Función Administrador de la organización de Exchange
Para ejecutar el cmdlet Set-TransportRule en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores en dicho equipo.
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Utilice este parámetro para especificar el GUID de la regla de transporte o el nombre de la regla configurado por el administrador al crear la regla. |
Actions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
Utilice este parámetro para especificar las acciones que aplica la regla de transporte al mensaje de correo electrónico si se cumplen todas las condiciones y no se alcanzan ninguna de las excepciones. Se debe especificar al menos una acción para cada regla. |
Comments |
Opcional |
System.String |
Utilice este parámetro para agregar comentarios informativos a la regla de transporte, por ejemplo, para qué se utiliza la regla y cómo ha cambiado a lo largo del tiempo. La longitud del comentario no puede superar los 512 caracteres. |
Conditions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Utilice este parámetro para especificar las condiciones que se aplican por medio de la regla de transporte a los mensajes de correo electrónico que se envían al agente de reglas de transporte. Si no configura una condición en una regla, la regla se aplicará a todos los mensajes si no se hacen coincidir las excepciones. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que recupera los datos de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que ejecutan la función del servidor Transporte perimetral. La función del servidor Transporte perimetral sólo escribe en la instancia de ADAM local de Active Directory. |
Exceptions |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Utilice este parámetro para especificar las excepciones que aplica la regla de transporte al mensaje de correo electrónico. Si un mensaje coincide con cualquier excepción, no se le aplican las acciones especificadas en esta regla. |
Instance |
Opcional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule |
Utilice este parámetro para pasar todo el objeto al comando para que sea procesado. Este parámetro se utiliza, principalmente, en scripts en los que todo el objeto debe pasar al comando. |
Name |
Opcional |
System.String |
Utilice este parámetro para especificar el nombre para mostrar de la regla de transporte que va a ser creada. La longitud del nombre no puede superar los 64 caracteres. |
Priority |
Opcional |
System.Int32 |
Utilice este parámetro para especificar el orden en el que se aplican las reglas de transporte. Si modifica la prioridad de la regla, la posición de la regla en la lista de reglas cambia para coincidir con la prioridad que ha especificado, y el agente de la regla de transporte incrementa, al mismo tiempo, todas las reglas con un valor de prioridad mayor. Las reglas con un valor de prioridad inferior se procesan en primer lugar. El valor de este parámetro debe ser mayor que o igual a 0. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
|
Ejemplo
A continuación, se ofrece un ejemplo completo que muestra cómo modificar una regla de transporte específica en un servidor de transporte de concentradores. Este ejemplo muestra cómo puede modificar las condiciones en una regla de transporte sin afectar a las excepciones o acciones en la misma regla.
Esta regla será modificada para aplicar la siguiente condición:
- desde miembro de lista de distribución El valor de esta condición es el grupo de distribución "Grupo de ventas".
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)