Get-TransportRule

 

S’applique à :Exchange Online, Exchange Online Protection, Exchange Server 2016

Dernière rubrique modifiée :2016-10-06

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Get-TransportRule permet d’afficher les règles de transport configurées dans votre organisation.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Get-TransportRule [-Identity <RuleIdParameter>] [-DlpPolicy <String>] [-DomainController <Fqdn>] [-Filter <String>] [-ResultSize <Unlimited>] [-State <Enabled | Disabled>]

Cet exemple renvoie toutes les règles de transport configurées dans votre organisation.

Get-TransportRule

Cet exemple renvoie uniquement la règle qui correspond au nom de « Block email messages between Sales and Brokerage Groups ». La commande est canalisée vers la commande Format-List pour afficher la configuration détaillée de la règle de transport spécifiée.

Get-TransportRule "Block email messages between Sales and Brokerage Groups" | Format-List

Pour plus d’informations sur le traitement en pipeline, voir Traitement en pipeline. Pour plus d’informations sur l’utilisation de la sortie d’une commande, consultez la rubrique Utilisation de la sortie de la commande.

Cet exemple renvoie les règles utilisées pour appliquer la stratégie DLP PII (États-Unis) dans votre organisation.

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

Cet exemple renvoie toutes les règles de votre organisation utilisées pour appliquer les stratégies DLP correspondantes. Le résultat de la commande est filtré pour n’afficher que les règles dont l’attribut DlpPolicy comporte une valeur.

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

La cmdlet Get-TransportRule vous permet d’afficher la configuration des règles de transport définies dans votre organisation.

Pour plus d’informations sur la configuration des règles de transport dans votre organisation, consultez la rubrique Set-TransportRule. Pour plus d’informations sur les règles de transport, consultez la rubrique Règles de flux de messagerie dans Exchange 2016.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Règles de transport » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

DlpPolicy

Facultatif

System.String

Le paramètre DlpPolicy spécifie la stratégie de protection contre la perte de données (DLP) lorsque vous souhaitez afficher les règles associées à une stratégie DLP spécifique. Les stratégies DLP de votre organisation permettent d’éviter une divulgation involontaire d’informations sensibles. Chaque stratégie de protection contre la perte de données est appliquée à l’aide d’un ensemble de règles de transport. Pour afficher les règles utilisées pour prendre en charge une stratégie DLP spécifique, spécifiez le nom de cette stratégie à l’aide de ce paramètre.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Le paramètre DomainController n’est pas pris en charge sur les serveurs de transport Edge. Un serveur de transport Edge utilise l’instance locale de Active Directory Lightweight Directory Services (AD LDS) pour lire et écrire des données.

Filter

Facultatif

System.String

Le paramètre Filter spécifie un filtre OPath qui renvoie toutes les règles de transport correspondant aux critères de recherche spécifiés. Ce paramètre recherche la propriété Description, qui comprend les conditions, les exceptions, les actions et les valeurs associées d’une règle de transport.

Ce paramètre utilise la syntaxe -Filter "Description -like '*<text>*'". Par exemple, -Filter "Description -like *192.168.1.1*'".

Identity

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Le paramètre Identity spécifie la règle de transport à afficher. Entrez le GUID ou le nom de la règle. Vous pouvez omettre l’étiquette de ce paramètre.

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ResultSize spécifie le nombre maximal de résultats à renvoyer. Pour retourner toutes les demandes correspondant à la requête, utilisez unlimited comme valeur pour ce paramètre. La valeur par défaut est 1000.

State

Facultatif

Microsoft.Exchange.MessagingPolicies.Rules.RuleState

Le paramètre State spécifie s’il faut renvoyer uniquement les règles activées ou celles qui sont désactivées. Les valeurs suivantes sont valides pour ce paramètre :

  • Enabled   La commande renvoie uniquement les règles actuellement activées.

  • Disabled   La commande renvoie uniquement les règles actuellement désactivées.

Si vous n’utilisez pas ce paramètre, la commande renvoie toutes les règles, activées et désactivées.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: