Get-TransportRule
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser 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.
Sintaxis
Default (Es el valor predeterminado).
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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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 Exchange local, este ejemplo devuelve una lista de resumen de las reglas que aplican la directiva DLP denominada PII (EE. UU.) en la organización.
Ejemplo 4
Get-TransportRule | Where {$_.DlpPolicy -ne $null}
En Exchange local, este ejemplo devuelve una lista de resumen de todas las reglas que aplican directivas DLP en la organización.
Parámetros
-DlpPolicy
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Nota: Este parámetro solo funciona en Exchange local.
El parámetro DlpPolicy filtra los resultados por 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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-DomainController
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propiedades del parámetro
| Tipo: | Fqdn |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExcludeConditionActionDetails
Aplicable: Exchange Online, Exchange Online Protection
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 valor es el predeterminado.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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
Propiedades del parámetro
| Tipo: | RuleIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-ResultSize
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propiedades del parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-State
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
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.
Propiedades del parámetro
| Tipo: | RuleState |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
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.