Gacutil. exe (ferramenta de Cache de Assembly Global)
A ferramenta Global Assembly Cache permite que você possa exibir e manipular o conteúdo do cache de assembly globais e também permite o download desses arquivos.
A ferramenta Global Assembly Cache é instalada automaticamente com o Visual Studio. Para iniciar a ferramenta, use o Prompt de comando Visual Studio. No prompt de comando, digite o seguinte:
gacutil [options] [assemblyName | assemblyPath | assemblyListFile]
Parâmetros
Argumento |
Descrição |
|---|---|
assemblyName |
O nome de um assembly. Você pode fornecer um nome parcial ou completo de um assembly. Por exemplo, você pode fornecer o nome myAssembly ou o nome completo, como myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5. |
assemblyPath |
O nome de um arquivo que contém um manifesto de conjunto de módulos (assembly). |
assemblyListFile |
Caminho para um arquivo de texto ANSI que lista assemblies para instalar ou desinstalar. O exemplo a seguir demonstra o conteúdo de um arquivo que contém conjuntos de módulos (assemblies) para instalar. A ferramenta interpreta caminhos relativos, relativos ao local da assemblyListFile. Para usar um arquivo de texto para desinstalar conjuntos de módulos (assemblies), especifique o nome conjunto totalmente qualificado de cada conjunto em uma linha separada no arquivo. Consulte os exemplos de assemblyListFile posteriormente contidas neste tópico. |
Opção |
Descrição |
|---|---|
/cdl |
Exclui o conteúdo do cache de download. |
/f |
Especificar essa opção com ou /il Opções para forçar um conjunto de módulos (assembly) para reinstalar. o /i Se um conjunto com o mesmo nome já existe no cache de conjunto de módulos global, a ferramenta substitui-lo. |
/help |
Exibe sintaxe de comando e opções para a ferramenta. |
/i assemblyPath |
Instala um conjunto no cache de conjunto global. |
/if assemblyPath |
Instala um conjunto no cache de conjunto global. Se um conjunto com o mesmo nome já existe no cache de conjunto de módulos global, a ferramenta substitui-lo. Especificar essa opção será equivalente à especificação e /f Opções juntos. o /i |
/il assemblyListFile |
Instala um ou mais conjuntos de módulos (assemblies) especificado no assemblyListFile no cache de conjunto global. |
/ir assemblyPath Esquema id description |
Instala um conjunto no cache de conjunto global e adiciona uma referência à montagem contar. Você deve especificar o assemblyPath, esquema, id,e Descrição parâmetros com essa opção. Para obter uma descrição dos valores válidos você pode especificar para esses parâmetros, consulte a /r opção. Especificar essa opção será equivalente à especificação e /r Opções juntos. o /i |
/l assemblyName |
Lista o conteúdo do cache de montagem global. Se você especificar o assemblyName parâmetro, a ferramenta listará somente as montagens correspondência esse nome. |
/ldl |
Lista o conteúdo do cache arquivos baixados. |
/LR assemblyName |
Lista todos os conjuntos de módulos e sua referência correspondente conta. Se você especificar o assemblyName parâmetro, a ferramenta lista somente as montagens correspondência esse nome e conta sua referência correspondente. |
/nologo |
Suprime a exibição Microsoft faixa de inicialização. |
/rassemblyName | assemblyPath Esquema id description |
Especifica uma referência a um conjunto ou conjuntos de módulos (assemblies) para instalar ou desinstalar rastreados. Especificar essa opção com ou /ul Opções., /u a /i, /il Para instalar um assembly, especifique o assemblyPath, esquema, id,e Descrição parâmetros com essa opção. Para desinstalar um assembly, especifique o assemblyName, esquema, id,e Descrição parâmetros. Para remover uma referência a uma montagem, você deve especificar o mesmo scheme, id,. e /r e description parâmetros que foram especificados com (ou /ir) opções ao conjunto de módulos (assembly) foi instalado o /i Se você está desinstalando conjuntos, a ferramenta também removerá montagem do cache de conjunto de módulos global se ele for a última referência para remover e se Windows Installer tem pendentes não possui referências ao conjunto. O scheme parâmetro especifica o tipo de esquema instalação. Você pode especificar um dos seguintes valores:
O valor para especificar para o id parâmetro depende do valor especificado para o scheme parâmetro:
O description parâmetro permite que você para especificar texto descritivo sobre o aplicativo para instalar. Essas informações é exibida quando referências são enumerados. |
/ silencioso |
Suprime a exibição de todas as saídas. |
/u assemblyName |
Desinstala um conjunto a partir do cache de conjunto de módulos global. |
/uf assemblyName |
Força um conjunto especificado para desinstalar, removendo todas as referências ao conjunto. Especificar essa opção será equivalente à especificação e /f Opções juntos. o /u Observação Não use esta opção para remover um conjunto que foi instalado com Microsoft Windows Installer.Se você tentar esta operação, a ferramenta exibirá uma mensagem de erro. |
/ul assemblyListFile |
Desinstala um ou mais conjuntos de módulos (assemblies) especificado assemblyListFile a partir do cache de conjunto de módulos global. |
/ungenassemblyName |
Desinstala um conjunto especificado do cache de conjunto de módulos global. Se o conjunto especificado tiver existente contagens referência, a ferramenta exibe a contagem de referência e não remove montagem do cache de conjunto de módulos global. Observação No.NET Framework versão 2.0, /ungen não é suportada.Em vez disso, use o uninstall comando da NGen (Native Image Generator). Nas versões do .NET Framework 1.0 e 1.1, especificar /ungen faz Gacutil.exe para remover conjunto do cache de imagem nativo. Esse cache armazena as imagens nativas para assemblies que foram criados usando o NGen (Native Image Generator). |
/ur assemblyName Esquema id description |
Desinstala uma referência a um conjunto especificado do cache de conjunto de módulos global. Para remover uma referência a uma montagem, você deve especificar o mesmo scheme, id, e description parâmetros que foram especificados com e /r (ou /ir) Opções ao conjunto de módulos (assembly) foi instalado. o /i Para obter uma descrição dos valores válidos você pode especificar para esses parâmetros, consulte a /r opção. Especificar essa opção será equivalente à especificação e /r Opções juntos. o /u |
/? |
Exibe sintaxe de comando e opções para a ferramenta. |
Comentários
Esta ferramenta fornece máximo a mesma funcionalidade para exibir o cache como a extensão do shell do Windows (Shfusion.dll), mas é mais utilizável de scripts compilação, makefiles, e arquivos em lotes.
Observação
Você deve ter privilégios de administrador para usar o Gacutil. exe.
Especificamente, Gacutil.exe permite que você possa instalar conjuntos de módulos (assemblies) no cache, removê-los do cache, e listar o conteúdo do cache.
Gacutil.exe fornece opções que suportam contagem referência semelhante à referência contagem esquema suporte ao Windows Installer. Você pode usar Gacutil.exe para instalar dois aplicativos que instalar o mesmo conjunto; a ferramenta mantém registro do número de referências ao conjunto. Como resultado, montagem permanecerá no computador até que ambos os aplicativos estão desinstalados. Se você estiver usando Gacutil.exe para instalações produto real, use as opções que suportam contagem referência. Use o /i e /r opções para instalar um assembly e adicionar uma referência para contar a ele. Use o /u e /r opções juntas para remover uma contagem de referência para um assembly. Esteja ciente de que usando o /i e /u opções sozinhas não oferece suporte a contagem de referência. Essas opções são apropriadas para uso durante o desenvolvimento do produto, mas não para instalações do produto real.
Use o /il ou /ul opções para instalar ou desinstalar uma lista de módulos (assemblies) armazenados em um arquivo de texto ANSI. Para usar um arquivo de texto para instalar conjuntos de módulos (assemblies), especificar o caminho para cada conjunto em uma linha separada no arquivo. O exemplo a seguir demonstra o conteúdo de um arquivo que contém conjuntos de módulos (assemblies) para instalar. O exemplo a seguir demonstra o conteúdo de um arquivo que contém módulos (assemblies) para instalar.
myAssembly1.dll
myAssembly2.dll
myAssembly3.dll
Para usar um arquivo de texto para desinstalar conjuntos de módulos (assemblies), especifique o nome conjunto totalmente qualificado de cada conjunto em uma linha separada no arquivo. O exemplo a seguir demonstra o conteúdo de um arquivo que contém conjuntos de módulos (assemblies) para desinstalar.
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
Exemplos
O comando a seguir instala montagem mydll.dll no cache de conjunto global.
gacutil /i mydll.dll
O comando a seguir remove conjunto hello a partir do cache de conjunto de módulos global, desde que nenhuma conta referência existe para montagem.
gacutil /u hello
Observe que o comando anterior talvez remova mais de um conjunto de cache de conjunto porque o nome conjunto totalmente não foi especificado. Por exemplo, se dois versão 1.0.0.0 e 3.2.2.1 de hello estiverem instalados no cache, o comando gacutil /u hello remove ambos os as montagens.
Use o exemplo a seguir para evitar remover mais de um conjunto. O comando remove somente conjunto hello que corresponda o número totalmente especificado versão, cultura e chave pública.
gacutil /u hello, Version=1.0.0.1, Culture="de",PublicKeyToken=45e343aae32233ca
O comando a seguir instala as montagens especificadas no arquivo assemblyList.txt no cache de conjunto global.
gacutil /il assemblyList.txt
O comando a seguir remove as montagens especificadas no arquivo assemblyList.txt a partir do cache de conjunto de módulos global.
gacutil /ul assemblyList.txt
O comando a seguir instala myDll.dll no cache de conjunto global e adiciona uma referência para contar-lo. Conjunto myDll.dll é usado pelo aplicativo MyApp. O UNINSTALL_KEY MyApp parâmetro especifica a chave do Registro que adiciona MyApp ao adicionar ou remover programas no Windows. O parâmetro descrição é especificado como My Application Description.
gacutil /i /r myDll.dll UNINSTALL_KEY MyApp "My Application Description"
O comando a seguir instala myDll.dll no cache de conjunto global e adiciona uma referência para contar-lo. O parâmetro Esquema, FILEPATH,., e o parâmetro id, c:\applications\myApp\myApp.exe Especificar o caminho para o aplicativo que está instalando myDll.dll. O parâmetro descrição é especificado como MyApp
gacutil /i /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
O comando a seguir instala myDll.dll no cache de conjunto global e adiciona uma referência para contar-lo. O parâmetro OPAQUE Esquema,., você pode personalizar os parâmetros identificação e descrição
gacutil /i /r mydll.dll OPAQUE "Insert custom application details here" "Insert Custom description information here"
O comando a seguir remove a referência à myDll.dll pelo aplicativo myApp. Se esta for a última referência ao conjunto, ele também removerá conjunto a partir do cache de conjunto de módulos global.
gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
O comando a seguir lista o conteúdo do cache de montagem global.
gacutil /l
Consulte também
Referência
Shfusion (Visualizador do Cache de Assembly)
Regasm. exe (ferramenta de registro de Assembly)
Prompt de comando Visual Studio