New-TransportRule
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-08-13
Utilice el cmdlet New-TransportRule para crear una nueva regla de transporte 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 de servidor de transporte de concentradores o de transporte de bordes de Microsoft Exchange Server 2007 instalada.
Sintaxis
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>]]
Descripción detallada
El cmdlet New-TransportRule le habilita para crear una nueva regla de transporte 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 de bordes en una organización de Exchange 2007.
Cada condición y excepción debe utilizar un predicado de regla admitida. Cada predicado consta del mismo predicado y del valor que desea comprobar.
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 admitida. Cada acción consta de la acción en sí y de los valores que la acción utiliza para llevar a cabo su tarea.
Para obtener una lista de las acciones de regla de transporte admitidas, vea Acciones de regla de transporte (en inglés).
Para obtener información detallada sobre cómo crear una nueva regla de transporte, vea Cómo crear nuevas reglas 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 New-TransportRule, la cuenta que utilice debe tener delegado lo siguiente:
- Función Administrador de la organización de Exchange
Para ejecutar el cmdlet New-TransportRule en un equipo que tiene instalada la función de servidor de transporte de bordes, debe iniciar sesión mediante 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 Exchange 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Actions |
Necesario |
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. |
Name |
Necesario |
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. |
Comments |
Opcional |
System.String |
Utilice este parámetro para agregar comentarios informativos a la regla, por ejemplo, para qué se utiliza la regla y cómo ha cambiado a lo largo del tiempo. La longitud del comentario no puede exceder los 1024 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 del servicio de directorio Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que ejecutan la función de servidor de transporte de bordes. La función de servidor de transporte de bordes sólo escribe en la instancia de ADAM local de Active Directory. |
Enabled |
Opcional |
System.Boolean |
Utilice este parámetro para especificar si la regla de transporte debe estar habilitada o deshabilitada cuando se crea. El valor predeterminado es |
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 aplica al mensaje la acción especificada en esta regla. |
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. |
TemplateInstance |
Opcional |
System.Management.Automation.PSObject |
Cuando un objeto existente se suministra a este parámetro, el comando utiliza la configuración de ese objeto para crear una copia idéntica del objeto en un servidor local o de destino. Para obtener más información, vea Plantillas (en inglés). |
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
En el siguiente ejemplo se muestra cómo crear una nueva regla de transporte en un servidor de transporte de concentradores.
Esta regla aplica las siguientes condiciones:
- entre lista de distribución y lista de distribución El primer valor de propiedad de predicado de esta condición es el grupo de distribución "Grupo Ventas". El valor de la segunda propiedad de predicado para esta condición es el grupo de distribución "Grupo de corretaje".
Se aplican las excepciones siguientes:
con patrones de texto en el asunto El valor de esta excepción es "Comunicado de prensa" o "Comunicación corporativa".
desde personas Los valores de esta excepción son los usuarios Ted Bremer y Pilar Ackerman.
Las siguientes acciones se aplicarán a cualquier mensaje que coincida con las condiciones que se describieron anteriormente, pero no coincidirán con las excepciones "con patrones de texto en el asunto" o "desde personas":
enviar mensajes rechazados al remitente El valor de esta acción es "Los mensajes de correo electrónico enviados entre el departamento de Ventas y el departamento de Corretaje están prohibidos".
registrar eventos con mensaje El valor de esta acción es "Se ha rechazado un mensaje de correo electrónico prohibido".
$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)