Get-TransportRulePredicate
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
Utilisez la cmdlet Get-TransportRulePredicate pour afficher les prédicats (conditions et exceptions) qui sont disponibles pour les règles de transport (règles de flux de messagerie).
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Get-TransportRulePredicate
[[-Name] <String>]
[<CommonParameters>] Description
Collectivement, les conditions et les exceptions des règles sont également appelées prédicats, car pour chaque condition, il existe une exception correspondante qui utilise les mêmes paramètres et la même syntaxe. La seule différence réside dans le fait que les conditions spécifient les messages à inclure, tandis que les exceptions spécifient les messages à exclure. C’est pourquoi la sortie de cette cmdlet ne répertorie pas les exceptions séparément. De plus, les noms de certains prédicats renvoyés par cette cmdlet sont différents des noms de paramètres correspondants dans les cmdlets New-TransportRule et Set-TransportRule.
Dans Exchange local, les prédicats disponibles sur les serveurs de boîtes aux lettres et le serveur de transports Edge sont différents.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Get-TransportRulePredicateCet exemple renvoie la liste récapitulative de tous les prédicats.
Exemple 2
Get-TransportRulePredicate -Name SubjectMatches | Format-ListCet exemple renvoie des informations détaillées sur le prédicat nommé SubjectMatches.
Pour plus d’informations sur le pipeline, consultez À propos des pipelines. Pour plus d’informations sur l’utilisation de la sortie d’une commande, consultez Utilisation de la sortie de commande.
Exemple 3
Get-TransportRulePredicate | Where {$_.Name -like "*Attachment*"}Cet exemple renvoie une liste récapitulative de tous les prédicats dont le nom inclut « pièce jointe ».
Pour plus d’informations sur l’utilisation de la sortie d’une commande, consultez Utilisation de la sortie de commande.
Paramètres
-Name
Le paramètre Name spécifie le nom du prédicat à afficher. Pour afficher la liste des noms disponibles, exécutez la commande Get-TransportRulePredicate.
| Type: | String |
| Position: | 1 |
| 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 |
Entrées
Input types
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.
Sorties
Output types
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.