Remove-TransportRule

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-07-27

La cmdlet Remove-TransportRule permet de supprimer une règle de transport de l'agent de règles de transport sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge Microsoft Exchange Server 2007 est installé.

Syntaxe

Remove-TransportRule -Identity <RuleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Remove-TransportRule permet de supprimer une règle de transport devenue inutile.

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 Remove-TransportRule, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur d'organisation Exchange.

Pour exécuter la cmdlet Remove-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 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Ce paramètre permet de spécifier la règle de transport à supprimer. Entrez le GUID ou le Name de la règle.

Vous pouvez omettre le libellé du paramètre Identity.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

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 du service d'annuaire 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.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple suivant illustre la procédure d'utilisation de la commande Remove-TransportRule pour supprimer une règle de transport. Le paramètre WhatIf permet d'afficher les modifications sur le point d'être appliquées sans les valider. Si vous supprimez le paramètre WhatIf et exécutez de nouveau la commande, la règle de transport est supprimée.

Remove-TransportRule "Redirect messages to kim@contoso.com to legal@contoso.com" -WhatIf