Get-TransportRule
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-06-28
La cmdlet Get-TransportRule permet d'afficher des règles de transport configurées sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge Microsoft Exchange Server 2007 est installé.
Syntaxe
Get-TransportRule [-Identity <RuleIdParameter>] [-DomainController <Fqdn>] [-State <Enabled | Disabled>]
Description détaillée
La cmdlet Get-TransportRule permet d'afficher la configuration de règles de transport définies sur un serveur de transport Hub ou Edge. Si vous exécutez cette commande sur un serveur de transport Hub, toutes les règles de transport configurées au sein de l'organisation, à l'exception de celles configurées sur un serveur de transport Edge, s'affichent. Si vous exécutez cette commande sur un serveur de transport Edge, seules les règles configurées sur le serveur de transport Edge local s'affichent.
Pour plus d'informations sur la configuration de règles de transport appliquées à des messages électroniques dans une organisation Exchange 2007, consultez la rubrique Set-TransportRule.
Pour plus d'informations sur l'agent de règles de transport, consultez la rubrique Vue d'ensemble des règles de transport.
Pour exécuter la cmdlet Get-TransportRule, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateurs Affichage seul d'Exchange.
Pour exécuter la cmdlet Get-TransportRule sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rôle serveur de transport Edge écrit uniquement sur l'instance Active Directory Application Mode (ADAM) locale. |
Identity |
Facultatif |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Ce paramètre permet de spécifier la règle de transport à afficher. Entrez le GUID ou le Name de la règle. Vous pouvez omettre le libellé du paramètre Identity. |
State |
Facultatif |
Microsoft.Exchange.MessagingPolicies.Rules.RuleState |
Ce paramètre permet de filtrer les résultats de la commande Get-TransportRule. Les valeurs suivantes sont valides pour ce paramètre :
|
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
Les exemples de code suivants illustrent la syntaxe de la commande Get-TransportRule. Le premier exemple retourne uniquement la règle correspondant au nom « Block e-mail 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.
Le second exemple retourne une liste récapitulative de toutes les règles de transport configurées dans une organisation Exchange si la commande est exécutée sur un serveur de transport Hub, ou des règles configurées sur l'ordinateur local si la commande est exécutée sur un serveur de transport Edge.
Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.
Pour plus d'informations sur l'utilisation de la sortie d'une commande, consultez la rubrique Utilisation de la sortie d'une commande.
Get-TransportRule "Block e-mail messages between Sales and Brokerage Groups" | Format-List
Get-TransportRule