Installation d'un assembly dans le GAC

  • Article

Installez et désinstallez manuellement un assembly BizTalk dans le global assembly cache (GAC) à l’aide de l’outil Gacutil inclus dans Visual Studio.

À l’aide de Visual Studio, vous pouvez installer automatiquement des assemblys BizTalk dans le GAC lorsqu’ils sont déployés à partir de Visual Studio. Définissez cette option dans les propriétés de déploiement du projet BizTalk ; Consultez Comment définir les propriétés de déploiement dans Visual Studio. Vous ne pouvez pas utiliser cette méthode pour installer des assemblys .NET non BizTalk dans le GAC ; vous devez les installer manuellement, comme décrit dans cette rubrique.

Notes

Vous pouvez également spécifier des options de déploiement pour les assemblys après leur déploiement dans une application BizTalk, en utilisant la console Administration de BizTalk Server. Consultez Comment modifier les options de déploiement d’un assembly BizTalk et Comment modifier les options de déploiement d’un assembly .NET, d’un composant COM, d’un fichier ou d’un artefact BAM.

Prérequis

Connectez-vous avec un compte disposant de l’autorisation Écriture au GAC. Le compte des administrateurs de l'ordinateur local dispose de cette autorisation.

Installer à l’aide de gacutil

  1. Copiez l’assembly BizTalk sur votre ordinateur local.

  2. Ouvrez l’invite de commandes développeur pour Visual Studio en tant qu’administrateur.

  3. Tapez la commande suivante :

    gacutil /i path_to_assembly_file /f

    Par exemple, entrez :
    gacutil /i c:\temp\filename.dll /f

L’option /f remplace tout assembly existant qui a le même nom d’assembly. Pour plus d’informations sur les commandes et options gacutil, tapez gacutil /?.

Désinstaller à l’aide de gacutil

La désinstallation d’un assembly à partir du global assembly cache (GAC) est nécessaire pour annuler complètement le déploiement d’une application. Vous pouvez automatiser ce processus. Avant de déployer l’application dans un environnement de production, écrivez un script de prétraitement qui désinstalle automatiquement l’assembly du GAC lorsque l’application est désinstallée. Consultez Utilisation de scripts de prétraitement et de post-traitement pour personnaliser le déploiement d’applications.

Vous pouvez également utiliser un script pour supprimer des fichiers et des paramètres supplémentaires. Consultez Comment supprimer d’autres fichiers et paramètres pour une application BizTalk.

Utilisation de l’interface Windows

  1. Ouvrez %systemdrive%\Windows\Assembly.

  2. Cliquez avec le bouton droit sur chaque fichier d’assembly inclus dans votre application, sélectionnez Désinstaller, puis Sélectionnez Oui pour confirmer.

Utilisation de la ligne de commande

  1. Ouvrez l’invite de commandes développeur pour Visual Studio en tant qu’administrateur.

  2. Tapez la commande suivante :

    gacutil /u<nom complet de l’assembly>

    Par exemple, entrez :
    gacutil /u "hello,Version=1.0.0.0, Culture=neutral, PublicKeyToken=0123456789ABCDEF"

Voir aussi

Déploiement des assemblys BizTalk à partir de Visual Studio dans une application BizTalk
Annulation du déploiement des applications BizTalk
Désinstallation d'une application BizTalk
Suppression d'une application BizTalk du groupe BizTalk