Import-TransportRuleCollection

Article
09/30/2014

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

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

La cmdlet Import-TransportRuleCollection permet d'importer un regroupement de règles de transport précédemment exporté pour être utilisé par 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

Import-TransportRuleCollection -FileName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Import-TransportRuleCollection importe un regroupement de règles de transport précédemment exportée pour être utilisée par l'agent de règles de transport.

Attention :
L'importation d'un regroupement de règles de transport à partir d'un fichier XML supprime ou remplace toutes les règles de transport préexistantes définies pour l'agent de règles de transport. Assurez-vous que vous disposez d'une sauvegarde de votre regroupement de règles de transport avant d'importer et d'écraser vos règles de transport actuelles. Sur les serveurs de transport Hub, la commande Import-TransportRuleCollection remplace toutes les règles de transport configurées dans l'organisation Exchange 2007, à l'exception des règles de transport sur les serveurs de transport Edge. Sur les serveurs de transport Edge, cette commande remplace uniquement les règles de transport configurées sur l'ordinateur local.

L'importation d'un regroupement de règles de transport à partir d'un fichier XML supprime ou remplace toutes les règles de transport préexistantes définies pour l'agent de règles de transport. Assurez-vous que vous disposez d'une sauvegarde de votre regroupement de règles de transport avant d'importer et d'écraser vos règles de transport actuelles.
Sur les serveurs de transport Hub, la commande Import-TransportRuleCollection remplace toutes les règles de transport configurées dans l'organisation Exchange 2007, à l'exception des règles de transport sur les serveurs de transport Edge. Sur les serveurs de transport Edge, cette commande remplace uniquement les règles de transport configurées sur l'ordinateur local.

Pour plus d'informations sur la procédure d'exportation d'un regroupement de règles de transport vers un fichier XML, consultez la rubrique Export-TransportRuleCollection.

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

le rôle Administrateur d'organisation Exchange.

Pour exécuter la cmdlet Import-TransportRuleCollection 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
FileName	Obligatoire	System.String	Ce paramètre permet de spécifier le chemin d'accès complet et le nom du fichier XML à importer. Si le chemin d'accès ou le nom de fichier contiennent des espaces, mettez la chaîne de caractères entre guillemets. Par exemple, `"C:\Transport Rules\New Transport Rules.xml"`
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 de code suivant illustre la syntaxe de la commande Import-TransportRuleCollection.

Import-TransportRuleCollection -FileName "c:\transport rules\new transport rules.xml"