Outil Global Assembly Cache Tool (Gacutil.exe)
L'outil Global Assembly Cache Tool vous permet d'afficher et de manipuler le contenu du Global Assembly Cache et du cache de téléchargement.
gacutil [options] [assemblyName | assemblyPath | assemblyListFile]
Paramètres
| Argument | Description |
|---|---|
assemblyName |
Nom d'un assembly. Vous pouvez indiquer un nom d'assembly partiellement spécifié, tel que |
assemblyPath |
Nom d'un fichier comportant un manifeste d'assembly. |
assemblyListFile |
Chemin d'accès à un fichier texte ANSI qui répertorie des assemblys à installer ou à désinstaller. Pour utiliser un fichier texte afin d'installer des assemblys, spécifiez le chemin d'accès de chaque assembly sur une ligne distincte dans le fichier. L'outil interprète des chemins relatifs, par rapport à l'emplacement de assemblyListFile. Pour utiliser un fichier texte afin de désinstaller des assemblys, spécifiez le nom qualifié complet de chaque assembly sur une ligne distincte dans le fichier. Consultez les exemples de contenu de assemblyListFile plus loin dans cette rubrique. |
| Option | Description |
|---|---|
/cdl |
Supprime le contenu du cache de téléchargement. |
/f |
Spécifiez cette option avec les options /i ou /il pour forcer la réinstallation d'un assembly. Si un assembly portant le même nom existe déjà dans le Global Assembly Cache, l'outil le remplace. |
/h[elp] |
Affiche la syntaxe et les options de commande de l'outil. |
/i assemblyPath |
Installe un assembly dans le Global Assembly Cache. |
/if assemblyPath |
Installe un assembly dans le Global Assembly Cache. Si un assembly portant le même nom existe déjà dans le Global Assembly Cache, l'outil le remplace. La spécification de cette option revient à spécifier les options /i et /f ensemble. |
/il assemblyListFile |
Installe un ou plusieurs assemblys spécifiés dans assemblyListFile dans le Global Assembly Cache. |
/ir assemblyPath scheme id description |
Installe un assembly dans le Global Assembly Cache et ajoute une référence pour compter l'assembly. Vous devez spécifier les paramètres assemblyPath, scheme, id et description avec cette option. Pour une description des valeurs valides que vous pouvez spécifier pour ces paramètres, consultez l'option /r. La spécification de cette option revient à spécifier les options /i et /r ensemble. |
/l [assemblyName] |
Répertorie le contenu du Global Assembly Cache Si vous spécifiez le paramètre assemblyName , l'outil ne répertorie que les assemblys correspondant à ce nom. |
/ldl |
Répertorie le contenu du cache de fichiers téléchargés. |
/lr [assemblyName] |
Répertorie tous les assemblys et leurs décomptes de références correspondants. Si vous spécifiez le paramètre assemblyName, l'outil ne répertorie que les assemblys correspondant à ce nom et leurs décomptes de références correspondants. |
/nologo |
Supprime l'affichage de la bannière de démarrage Microsoft. |
/r [assemblyName | assemblyPath] scheme id description |
Spécifie une référence avec trace à un assembly ou des assemblys à installer ou à désinstaller. Spécifiez cette option avec les options /i, /il, /u ou /ul. Pour installer un assembly, spécifiez les paramètres assemblyPath, scheme, id et description avec cette option. Pour désinstaller un assembly, spécifiez les paramètres assemblyName, scheme, id et description. Pour supprimer une référence à un assembly, vous devez spécifier les mêmes paramètres scheme, id et description que ceux spécifiés avec les options /i et /r (ou /ir) lors de l'installation de l'assembly. Si vous désinstallez un assembly, l'outil supprime également l'assembly du Global Assembly Cache s'il s'agit de la dernière référence à supprimer et si Windows Installer ne possède aucune référence en suspens à l'assembly. Le paramètre scheme spécifie le type de schéma d'installation. Vous pouvez spécifier l'une des valeurs suivantes :
La valeur à spécifier pour le paramètre id dépend de la valeur spécifiée pour le paramètre scheme :
Le paramètre description vous permet de spécifier un texte descriptif concernant l'application à installer. Ces informations sont affichées lorsque des références sont énumérées. |
/silent |
Supprime l'affichage de toutes les sorties. |
/u assemblyName |
Désinstalle un assembly du Global Assembly Cache. |
/uf assemblyName |
Force la désinstallation d'un assembly spécifié en supprimant toutes les références à cet assembly. La spécification de cette option revient à spécifier les options /u et /f ensemble. Notes Vous ne pouvez pas utiliser cette option pour supprimer un assembly installé à l'aide de Microsoft Windows Installer. Si vous tentez cette opération, l'outil affiche un message d'erreur. |
/ul assemblyListFile |
Désinstalle un ou plusieurs assemblys spécifiés dans assemblyListFile du Global Assembly Cache. |
/u[ngen] assemblyName |
Désinstalle un assembly spécifié du Global Assembly Cache. S'il existe des décomptes de références pour l'assembly spécifié, l'outil les affiche et ne supprime pas l'assembly du Global Assembly Cache. Notes Dans la version 2.0 du .NET Framework, /ungen n'est pas pris en charge. À la place, utilisez la commande uninstall de Outil Native Image Generator Tool (Ngen.exe). Dans les versions 1.0 et 1.1 de .NET Framework, la spécification de /ungen conduit Gacutil.exe à supprimer l'assembly du cache des images natives. Ce cache stocke les images natives pour les assemblys qui ont été créés à l'aide de Outil Native Image Generator Tool (Ngen.exe). |
/ur assemblyName scheme id description |
Désinstalle une référence à un assembly spécifié du Global Assembly Cache. Pour supprimer une référence à un assembly, vous devez spécifier les mêmes paramètres scheme, id et description que ceux spécifiés avec les options /i et /r (ou /ir) lors de l'installation de l'assembly. Pour une description des valeurs valides que vous pouvez spécifier pour ces paramètres, consultez l'option /r. La spécification de cette option revient à spécifier les options /u et /r ensemble. |
/? |
Affiche la syntaxe et les options de commande de l'outil. |
Notes
Cet outil propose la plupart des fonctionnalités d'affichage du cache de Windows Shell Extension (Shfusion.dll), mais il s'utilise davantage à partir de scripts de compilation, de makefiles et de fichiers batch.
Gacutil.exe vous permet plus particulièrement d'installer des assemblys dans le cache, d'en supprimer du cache et de répertorier le contenu du cache.
Gacutil.exe fournit des options qui prennent en charge le décompte de références similaire au modèle de décompte de références pris en charge par Windows Installer. Vous pouvez utiliser Gacutil.exe pour installer deux applications qui installent le même assembly ; l'outil garde la trace du nombre de références à l'assembly. L'assembly reste donc sur l'ordinateur jusqu'à ce que les deux applications soient désinstallées. Si vous utilisez Gacutil.exe pour des installations de produits, utilisez les options qui prennent en charge le décompte de références. Utilisez les options /i et /r ensemble pour installer un assembly et ajouter une référence pour le décompter. Utilisez les options /u et /r ensemble pour supprimer un décompte de références pour un assembly. Notez que l'utilisation des options /i et /u seules ne prend pas en charge le décompte de références. Ces options conviennent à une utilisation pendant le développement d'un produit, mais pas pour des installations de produits.
Utilisez les options /il ou /ul pour installer ou désinstaller une liste d'assemblys stockés dans un fichier texte ANSI. Le contenu du fichier texte doit être correctement mis en forme. Pour utiliser un fichier texte afin d'installer des assemblys, spécifiez le chemin d'accès de chaque assembly sur une ligne distincte dans le fichier. L'exemple suivant illustre le contenu d'un fichier contenant des assemblys à installer.
myAssembly1.dll
myAssembly2.dll
myAssembly3.dll
Pour utiliser un fichier texte afin de désinstaller des assemblys, spécifiez le nom qualifié complet de chaque assembly sur une ligne distincte dans le fichier. L'exemple suivant illustre le contenu d'un fichier contenant des assemblys à désinstaller.
myAssembly1,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly2,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly3,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
Exemples
La commande suivante installe l'assembly mydll.dll dans le Global Assembly Cache.
gacutil /i mydll.dll
La commande suivante supprime l'assembly hello du Global Assembly Cache si aucun décompte de références n'existe pour l'assembly.
gacutil /u hello
Notez que la commande précédente peut supprimer plusieurs assemblys du cache de l'assembly, car le nom de l'assembly n'est pas complètement spécifié. Par exemple, si les versions 1.0.0.0 et 3.2.2.1 de hello sont installées dans le cache, la commande gacutil /u hello supprimera alors ces deux assemblys.
Suivez l'exemple suivant pour éviter de supprimer plusieurs assemblys. Cette commande supprime uniquement l'assembly hello correspondant au numéro de version, à la culture et à la clé publique intégralement spécifiés.
gacutil /u hello, Version=1.0.0.1, Culture="de",PublicKeyToken=45e343aae32233ca
La commande suivante installe les assemblys spécifiés dans le fichier assemblyList.txt dans le Global Assembly Cache.
gacutil /il assemblyList.txt
La commande suivante supprime les assemblys spécifiés dans le fichier assemblyList.txt du Global Assembly Cache.
gacutil /ul assemblyList.txt
La commande suivante installe myDll.dll dans le Global Assembly Cache et ajoute une référence pour le décompter. L'assembly myDll.dll est utilisé par l'application MyApp. Le paramètre UNINSTALL_KEY MyApp spécifie la clé de Registre qui ajoute MyApp à Ajout/Suppression de programmes dans Windows. Le paramètre description est spécifié en tant que My Application Description.
gacutil /i /r myDll.dll UNINSTALL_KEY MyApp "My Application Description"
La commande suivante installe myDll.dll dans le Global Assembly Cache et ajoute une référence pour le décompter. Le paramètre scheme, FILEPATH, et le paramètre id, c:\applications\myApp\myApp.exe, spécifient le chemin d'accès à l'application qui installe myDll.dll.. Le paramètre description est spécifié en tant que MyApp.
gacutil /i /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
La commande suivante installe myDll.dll dans le Global Assembly Cache et ajoute une référence pour le décompter. Le paramètre scheme, OPAQUE, vous permet de personnaliser les paramètres id et description.
gacutil /i /r mydll.dll OPAQUE "Insert custom application details here" "Insert Custom description information here"
La commande suivante supprime la référence à myDll.dll par l'application myApp. S'il s'agit de la dernière référence à l'assembly, elle supprime également l'assembly du Global Assembly Cache.
gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
La commande suivante répertorie le contenu du Global Assembly Cache.
gacutil /l
Voir aussi
Référence
Outils du .NET Framework
Assembly Cache Viewer (Shfusion.dll)
Outil Assembly Registration Tool (Regasm.exe)
Invite de commandes du Kit de développement SDK