Outil Global Assembly Cache Tool (Gacutil.exe)

Article
08/21/2008

Mise à jour : novembre 2007

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 myAssembly ou un nom d'assembly complètement spécifié, tel que myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5.
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.

/cdl

Supprime le contenu du cache de téléchargement.

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

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

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 :

UNINSTALL_KEY : spécifiez cette valeur si le programme d'installation ajoute l'application à Ajout/Suppression de programmes dans Microsoft Windows. Les applications s'ajoutent elles-mêmes à Ajout/Suppression de programmes en ajoutant une clé de Registre à HKLM\Software\Microsoft\Windows\CurrentVersion.
FILEPATH : spécifiez cette valeur si le programme d'installation n'ajoute pas l'application à Ajout/Suppression de programmes.
OPAQUE : spécifiez cette valeur si l'indication d'une clé de Registre ou d'un chemin d'accès au fichier ne s'applique pas à votre scénario d'installation. Cette valeur vous permet de spécifier des informations personnalisées pour le paramètre id.

La valeur à spécifier pour le paramètre id dépend de la valeur spécifiée pour le paramètre scheme :

Si vous spécifiez UNINSTALL_KEY pour le paramètre scheme, spécifiez le nom de l'application défini dans la clé de Registre HKLM\Software\Microsoft\Windows\CurrentVersion. Par exemple, si la clé de Registre est HKLM\Software\Microsoft\Windows\CurrentVersion\MyApp, spécifiez MyApp pour le paramètre id.
Si vous spécifiez FILEPATH pour le paramètre scheme, spécifiez le chemin d'accès complet au fichier exécutable qui installe l'assembly en tant que paramètre id.
Si vous spécifiez OPAQUE pour le paramètre scheme, vous pouvez fournir n'importe quelles données en tant que paramètre id. Les données que vous spécifiez doivent être mises entre guillemets ("").

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.

Remarque :
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.

/ulassemblyListFile

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.

Remarque :
Dans la version 2.0 du .NET Framework, /ungen n'est pas pris en charge. À la place, utilisez la commande uninstall de l'Outil Native Image Generator Tool (Ngen.exe).

Dans les versions 1.0 et 1.1 du .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 l'Outil Native Image Generator Tool (Ngen.exe).

/ur assemblyName

scheme

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.

Remarque :
Vous devez disposer des droits d'administrateur pour utiliser Gacutil.exe.

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.