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-TransportRuleEn 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-ListEn 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.