Global ferramenta cache assembly (Gacutil.exe)

Artigo
08/25/2010

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.

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.
/h[elp]	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. You must specify the assemblyPath, scheme, id,and description parameters with this option. 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.
/r [assemblyName \| 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 To install an assembly, specify the assemblyPath, scheme, id,and description parameters with this option. To uninstall an assembly, specify the assemblyName, scheme, id,and description parameters. 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: UNINSTALL_KEY: especifique esse valor se o instalador adiciona o aplicativo para adicionar ou remover programas no Microsoft Windows. Aplicativos adicionar eles mesmos para adicionar ou remover programas, adicionando uma chave do registro a HKLM\Software\Microsoft\Windows\CurrentVersion. FILEPATH: especifique esse valor se o instalador não adiciona o aplicativo para adicionar ou remover programas. OPAQUE: especifique esse valor se fornecer uma chave do Registro ou caminho do arquivo não não aplicar a seu cenário de instalação. Esse valor, você pode especificar as informações personalizadas para o id parâmetro. O valor para especificar para o id parâmetro depende do valor especificado para o scheme parâmetro: Se você especificar UNINSTALL_KEY para o esquema parâmetro, especifique o nome do aplicativo definido na chave do registro HKLM\Software\Microsoft\Windows\CurrentVersion. Por exemplo, se a chave do registro for HKLM\Software\Microsoft\Windows\CurrentVersion\MyApp, especifique MyApp para o ID parâmetro. Se você especificar FILEPATH para o scheme Parâmetro, especificar o caminho completo para o arquivo executável que instala conjunto como o id parâmetro. Se você especificar OPAQUE para o scheme parâmetro, você pode fornecer qualquer parte de dados como o id parâmetro. Você especificar os dados devem ser colocados entre aspas (""). 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.
/u[ngen] assemblyName	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 estrutura versão 2.0, /ungen não é suportado. Em vez disso, use o uninstall comando da Nativo imagem gerador (NGen.exe). 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 criados usando o Nativo imagem gerador (NGen.exe).
/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 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 and /r opções para instalar um assembly e adicione uma referência para contar a ele. Use o /u and /r opções em conjunto para remover uma contagem de referência para um assembly. Lembre-se de que o usando**/i** and /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 or /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 Sumário de um arquivo contendo 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 de esquema, FILEPATHe o parâmetro de id c:\applications\myApp\myApp.exe, especifique o caminho para o aplicativo que está instalando myDll.dll. Parâmetro descrição é especificado sistema autônomo 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.