Compartir a través de


Get-TransportRule

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-TransportRule para ver las reglas de transporte (reglas de flujo de correo) de su organización.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

Get-TransportRule
   [[-Identity] <RuleIdParameter>]
   [-DomainController <Fqdn>]
   [-State <RuleState>]
   [-DlpPolicy <String>]
   [-ExcludeConditionActionDetails <Boolean>]
   [-Filter <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

En los servidores de buzones de correo, este cmdlet devuelve todas las reglas de la organización de Exchange que se almacenan en Active Directory. En un servidor de transporte perimetral, este cmdlet solo devuelve reglas configuradas en el servidor local.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-TransportRule

En este ejemplo se devuelve una lista de resumen de todas las reglas de la organización.

Ejemplo 2

Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List

En este ejemplo se devuelve información detallada de la regla denominada "Muro ético: departamentos de ventas y corretaje".

Para obtener más información sobre la canalización, vea Acerca de las canalizaciones. Para obtener más información sobre cómo trabajar con la salida de un comando, vea Trabajar con la salida del comando.

Ejemplo 3

Get-TransportRule -DlpPolicy "PII (U.S.)"

En este ejemplo se devuelve una lista de resumen de las reglas que aplican la directiva DLP denominada PII (EE. UU.) en su organización.

Ejemplo 4

Get-TransportRule | Where {$_.DlpPolicy -ne $null}

En este ejemplo se devuelve una lista de resumen de todas las reglas que aplican directivas DLP en su organización.

Parámetros

-DlpPolicy

El parámetro DlpPolicy filtra los resultados mediante el nombre de la directiva de prevención de pérdida de datos (DLP) especificada. Si el valor contiene espacios, escriba el valor entre comillas (").

Las directivas DLP de una organización permiten evitar la divulgación involuntaria de información confidencial. Cada directiva DLP se aplica mediante un conjunto de reglas de transporte.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

El parámetro DomainController no es compatible con los servidores de transporte perimetral. Un servidor de transporte perimetral usa la instancia local de Active Directory Lightweight Directory Services (AD LDS) para leer y escribir datos.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExcludeConditionActionDetails

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro ExcludeConditionActionDetails especifica si se deben ocultar detalles específicos de los resultados. Los valores admitidos son:

  • $true: las propiedades Description, Conditions y Actions, así como los valores de las propiedades de condición, excepción y acción configurados están en blanco.
  • $false: no se ocultan propiedades ni valores de propiedad. Este es el valor predeterminado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

El parámetro Filter filtra los resultados mediante un OPATH. Este parámetro realiza una búsqueda en la propiedad Description, que contiene las condiciones, las excepciones, las acciones y los valores asociados de una regla de transporte.

Este parámetro usa la sintaxis "Description -like 'Text*'". Por ejemplo, "Description -like '192.168.1.1*'".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

El parámetro Identity especifica la regla que desea ver. Puede usar cualquier valor que identifique de forma exclusiva la regla. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:RuleIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-State

El parámetro State especifica que filtra los resultados mediante reglas habilitadas o deshabilitadas. Los valores admitidos son:

  • Habilitado: solo se devuelven reglas habilitadas en los resultados.
  • Deshabilitado: solo se devuelven reglas deshabilitadas en los resultados.

Si no se utiliza este parámetro, el comando devuelve todas las reglas: las habilitadas y las deshabilitadas.

Type:RuleState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.