Gérer des agents d’extension de cmdlet

  • Article

S’applique à : Exchange Server 2013

Cette rubrique explique comment activer, désactiver, afficher et modifier la propriété des agents d'extension de cmdlet dans Microsoft Exchange Server 2013. Pour plus d'informations sur les agents d'extension de cmdlet dans Exchange 2013, voir Agents d'extension des cmdlets.

Ce qu'il faut savoir avant de commencer

  • Durée d'exécution estimée de chaque procédure : moins de 5 minutes

  • Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez entrée « agents d'extension de cmdlet » dans la rubrique Autorisations d'infrastructure Exchange et Shell.

  • Avant d’activer , Scripting Agentvous devez vérifier qu’il est correctement configuré. Pour plus d’informations sur , consultez Agents d’extension d’appletScripting Agent de commande.

  • Vous devez utiliser l'environnement de ligne de commande Exchange Management Shell pour effectuer ces procédures.

  • Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d'administration Exchange.

Conseil

Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums de Exchange Server.

Activer un agent d'extension de cmdlet

Lorsque vous activez un agent d'extension de cmdlet dans Exchange 2013, l'agent est exécuté sur chaque serveur qui exécute Exchange 2013 dans l'organisation. Quand un agent est activé, il est mis à la disposition des cmdlets qui peuvent ensuite utiliser l'agent pour effectuer des opérations supplémentaires.

Avertissement

Avant d'activer un agent, assurez-vous que vous connaissez son fonctionnement et l'impact qu'il aura sur votre organisation.

Cet exemple montre comment activer un agent d'extension de cmdlet à l'aide de la cmdlet Enable-CmdletExtensionAgent. Vous devez indiquer le nom de l'agent à activer lorsque vous exécutez la cmdlet. Avant d’activer , Scripting Agentvous devez vous assurer que vous avez déployé le ScriptingAgentConfig.xml fichier de configuration sur tous les serveurs de votre organisation. Si vous ne déployez pas le fichier de configuration en premier et que vous activez , Scripting ``Agenttoutes les applets de commande non-Get échouent lorsqu’elles sont exécutées. Cet exemple active .Scripting Agent

Enable-CmdletExtensionAgent "Scripting Agent"

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Enable-CmdletExtensionAgent.

Désactiver un agent d'extension de cmdlet

Lorsque vous désactivez un agent d'extension de cmdlet dans Exchange 2013, l'agent est désactivé sur tous les serveurs de l'organisation qui exécutent Exchange 2013. Lorsqu'un agent est désactivé, il n'est pas mis à la disposition des cmdlets. Les cmdlets ne peuvent plus utiliser l'agent pour effectuer d'autres opérations.

Avertissement

Avant de désactiver un agent, assurez-vous que vous connaissez le fonctionnement de l'agent, ainsi que les conséquences que la désactivation de l'agent entraînera dans l'organisation.

Pour désactiver un agent d'extension de cmdlet, utilisez la cmdlet Disable-CmdletExtensionAgent. Lorsque vous exécutez la cmdlet, indiquez le nom de l'agent que vous voulez désactiver. Cet exemple montre comment désactiver .Scripting Agent

Disable-CmdletExtensionAgent "Scripting Agent"

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Disable-CmdletExtensionAgent.

Afficher les agents d'extension de cmdlet existants

L'affichage des agents d'extension de cmdlet vous permet de voir les agents qui sont exécutés en premier et ceux qui sont activés dans une organisation Exchange 2013. Pour plus d'informations sur le traitement en pipeline et la cmdlet Format-Table, consultez les rubriques suivantes :

Cet exemple indique les détails d'un agent d'extension de cmdlet spécifique à l'aide de la cmdlet Get-CmdletExtensionAgent. Dans cet exemple, les détails du Mailbox Permissions Agent sont retournés.

Get-CmdletExtensionAgent "Mailbox Permissions Agent"

Dans cet exemple, nous récupérons plusieurs agents d'extension de cmdlet à l'aide de la cmdlet Get-CmdletExtensionAgent, puis canalisons la sortie vers la cmdlet Format-Table. Cet exemple affiche une liste de tous les agents d'extension de cmdlet, et en utilisant la cmdlet Format-Table, les propriétés Name, Enabled et Priority de chaque agent sont affichées dans un tableau.

Get-CmdletExtensionAgent | Format-Table Name, Enabled, Priority

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Get-CmdletExtensionAgent.

Modifier la priorité d'un agent d'extension de cmdlet

La possibilité de modifier la priorité d'un agent d'extension de cmdlet dans Exchange 2013 est une option utile si vous souhaitez qu'un agent soit appelé par une cmdlet avant un autre agent. Cela est particulièrement utile si vous créez un script personnalisé exécuté dans le Scripting Agentet que vous souhaitez que ce script soit prioritaire sur un agent intégré. Pour plus d’informations sur , consultez Agents d’extension d’appletScripting Agent de commande.

Avertissement

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.

Le classement des agents va de zéro au nombre maximal d'agents. Plus l'agent est près de zéro, plus il est prioritaire. Les agents dont la priorité est élevée sont appelés en premier. Pour plus d'informations sur la priorité des agents, consultez la rubrique Agents d'extension des cmdlets.

Cet exemple montre comment modifier la priorité d'un agent d'extension de cmdlet à l'aide de la cmdlet Set-CmdletExtensionAgent. Dans cet exemple, la priorité de est Scripting Agent remplacée par 3.

Set-CmdletExtensionAgent "Scripting Agent" -Priority 3

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Set-CmdletExtensionAgent.