Présentation des agents d’extension de cmdlet

S’applique à : Exchange Server 2010 SP2, Exchange Server 2010 SP3

Dernière rubrique modifiée : 2015-03-09

Les agents d’extension de cmdlet sont des composants de Microsoft Exchange Server 2010 appelés par les cmdlets d’Exchange 2010 au moment de leur exécution. Comme son nom l’indique, les agents d’extension de cmdlet étendent les fonctionnalités des cmdlets qui les appellent en contribuant au traitement des données ou en effectuant des opérations supplémentaires conformément aux exigences des cmdlets. Les agents d’extension de cmdlet sont disponibles sur un rôle serveur, sauf celui de transport Edge.

Les agents peuvent modifier, remplacer ou étendre les fonctionnalités des cmdlets Exchange Management Shell. Un agent peut attribuer une valeur à un paramètre requis qui n’est pas spécifiée pour une commande, remplacer une valeur attribuée par un utilisateur, effectuer d’autres opérations non comprises dans le flux de travail de la cmdlet pendant son exécution, et davantage.

Par exemple, la cmdlet New-Mailbox accepte le paramètre Database qui spécifie la base de données de boîtes aux lettres dans laquelle créer une nouvelle boîte aux lettres. Dans Exchange Server 2007, si vous ne spécifiez pas le paramètre Database au moment de l’exécution de la cmdlet New-Mailbox, la commande échoue. Avec Exchange 2010, la cmdlet New-Mailbox appelle l’agent de Mailbox Resources Management au moment de l’exécution de la cmdlet. Si le paramètre Database n’est pas spécifié, l’agent Mailbox Resources Management détermine automatiquement une base de données de boîtes aux lettres appropriée sur laquelle créer la nouvelle boîte aux lettres et insère cette valeur dans le paramètre Database.

Les agents d’extension de cmdlet peuvent uniquement être appelés par des cmdlets Exchange 2010. Les cmdlets Exchange 2007 et celles fournies par d’autres produits Microsoft et tiers ne peuvent pas appeler les agents d’extension de cmdlet. Les scripts ne peuvent également pas appeler directement les agents d’extension de cmdlet. Toutefois, si les scripts contiennent les cmdlets Exchange 2010, celles-ci continuent à appeler les agents d’extension de cmdlet.

Souhaitez-vous rechercher les tâches de gestion liées aux agents d’extension de cmdlet ? Voir Gestion des agents d’extension de cmdlet.

Priorité de l’agent

La priorité d’un agent détermine l’ordre dans lequel l’agent est appelé au moment de l’exécution d’une cmdlet. Un agent dont la priorité est élevée, proche de 0, est appelé en premier. La priorité d’un agent devient importante quand plusieurs agents tentent de définir la valeur de la même propriété. L’agent dont la priorité est élevée réussit à définir une valeur de propriété, alors que toutes les tentatives ultérieures de définition de la même propriété par les agents dont la priorité est moins élevée sont ignorées. Par exemple, si la propriété Name sur un objet est modifiée par un agent avec la priorité 3 et qu’un autre agent avec la priorité 6 modifie le même objet, la modification apportée par l’agent avec la priorité 6 est ignorée.

Si vous voulez utiliser l’Scripting agent pour définir la valeur des propriétés qui peuvent être définies par d’autres agents dont la priorité est élevée, vous disposez des options suivantes :

• Désactivez l’agent qui définit actuellement la propriété.

• Définissez l’Scripting agent sur une priorité supérieure à celle de l’agent existant à remplacer.

• Conservez la priorité des agents et veillez à ce que le script exécuté dans le cadre de l’Scripting agent respecte la valeur des autres agents.

Attention :
La modification de la priorité ou le remplacement de la fonctionnalité d’un agent intégré est une opération avancée. Assurez-vous que vous comprenez totalement les modifications que vous effectuez.

Pour plus d’informations sur la modification de la priorité d’un agent, voir Modifier la priorité d’un agent d’extension de cmdlet.

Agents intégrés

Exchange 2010 inclut plusieurs agents qui peuvent être appelés au moment de l’exécution d’une cmdlet. Le tableau suivant répertorie les agents, leur ordre et indique s’ils sont activés par défaut. Vous ne pouvez ni ajouter ni supprimer des agents d’un serveur qui exécute Exchange 2010. Vous pouvez toutefois utiliser l’agent de script pour exécuter les scripts Microsoft Windows PowerShell afin d’étendre les fonctionnalités des cmdlets qui l’utilisent. Pour plus d’informations sur l’agent d’écriture de script, consultez la rubrique Présentation de l’Agent de script.

Vous pouvez activer ou désactiver des agents ou encore modifier la priorité des agents si vous voulez remplacer les fonctionnalités d’un agent particulier par des fonctionnalités d’un script personnalisé que vous appelez via l’agent d’écriture de script.

La configuration des agents est enregistrée au niveau de l’organisation. Lorsque vous activez ou désactivez un agent, ou que définissez sa priorité, vous définissez la configuration de cet agent sur tous les serveurs de l’organisation, sauf en cas d’ajout de scripts à l’Scripting agent. Vous devez mettre à jour les scripts sur chaque serveur individuellement. Pour plus d’informations sur la configuration des scripts à utiliser avec l’Scripting agent, consultez la rubrique Présentation de l’Agent de script.

Attention :

Le changement de priorité des agents, ou l’activation ou la désactivation des agents, peut provoquer des effets non voulus si vous ne comprenez pas complètement le rôle de chaque agent et comment ils interagissent avec les cmdlets Exchange. Avant de changer la configuration d’un agent, veillez à bien comprendre les changements et résultats voulus et vérifiez que votre script personnalisé fonctionnera comme prévu.

Agents d’extension de cmdlet Exchange 2010