Installutil.exe (Strumento Programma di installazione)

  • Articolo

Lo strumento Programma di installazione è un'utilità da riga di comando che consente di installare e disinstallare le risorse del server eseguendo i componenti del programma di installazione di assembly specificati. Questo strumento funziona insieme alle classi nello spazio dei nomi System.Configuration.Install.

Viene installato automaticamente con Visual Studio. Per eseguire lo strumento, usare il prompt dei comandi per gli sviluppatori di Visual Studio o Visual Studio Developer PowerShell.

Al prompt dei comandi digitare quanto segue:

Sintassi

installutil [/u[ninstall]] [options] assembly [[options] assembly] ...

Parametri

Argomento Descrizione
assembly Nome file dell'assembly in cui eseguire i componenti del programma di installazione. Omettere questo parametro se si desidera specificare il nome sicuro dell'assembly utilizzando l'opzione /AssemblyName.

Opzioni

Opzione Descrizione
/h[elp]

oppure

/?		 Visualizza la sintassi e le opzioni di comando dello strumento.
/helpassembly

oppure

/?assembly		 Visualizza le opzioni aggiuntive riconosciute dai singoli programmi di installazione all'interno dell'assembly specificato, insieme alla sintassi e alle opzioni di comando di InstallUtil.exe. Questa opzione aggiunge il testo restituito dalla proprietà Installer.HelpText di ogni componente del programma di installazione al testo della Guida di InstallUtil.exe. Ad esempio, se ServiceProcessInstaller.Account è User, sono disponibili le /username opzioni e /password .
/AssemblyName "assemblyName

,Version=major.minor.build.revision

,Culture=locale

,PublicKeyToken=publicKeyToken"		 Specifica il nome sicuro di un assembly, che verrà registrato nella Global Assembly Cache. Il nome dell'assembly deve essere completo, con versione, impostazioni cultura e token di chiave pubblica. Il nome completo deve essere racchiuso tra virgolette.

Ad esempio, "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0" è un nome di assembly completo.
/InstallStateDir=[directoryName] Specifica la directory del file con estensione InstallState contenente i dati utilizzati per la disinstallazione dell'assembly. La directory predefinita è quella che contiene l'assembly.
/LogFile=[filename] Specifica il nome del file di log in cui è registrato lo stato dell'installazione. Per impostazione predefinita, se l'opzione /LogFile viene omessa, viene creato un file di log denominato assemblyname.InstallLog. Se filename viene omesso, non verrà generato alcun file di log.
/LogToConsole={true|false} Se true, visualizza l'output sulla console. Se false (impostazione predefinita), evita la visualizzazione dell'output sulla console.
/ShowCallStack Restituisce lo stack di chiamate al file di log se si verifica un'eccezione durante l'installazione.
/u[ninstall] Disinstalla gli assembly specificati. A differenza delle altre opzioni, /u si applica a tutti gli assembly, indipendentemente dalla posizione dell'opzione nella riga di comando.

Opzioni aggiuntive del programma di installazione

I singoli programmi di installazione usati all'interno di un assembly sono in grado di riconoscere opzioni oltre a quelle elencate nella sezione Opzioni. Per ulteriori informazioni su queste opzioni, eseguire InstallUtil.exe con i percorsi degli assembly sulla riga di comando con l'opzione /? o /help. Per specificare queste opzioni, includerle nella riga di comando con le opzioni riconosciute da InstallUtil.exe.

Nota

Il testo della Guida sulle opzioni supportate da singoli componenti del programma di installazione viene restituito dalla proprietà Installer.HelpText. Le singole opzioni che sono state inserite nella riga di comando sono accessibili a livello di codice dalla proprietà Installer.Context.

Tutte le opzioni e i parametri della riga di comando vengono scritti nel file di log dell'installazione. Tuttavia, se si usa il /Password parametro , riconosciuto da alcuni componenti del programma di installazione, le informazioni sulla password vengono sostituite da otto asterischi (*) e non verranno visualizzate nel file di log.

Importante

In alcuni casi, i parametri passati al programma di installazione possono includere informazioni riservate o personali che, per impostazione predefinita, vengono scritte in un file di log di testo normale. Per evitare questo comportamento, è possibile eliminare il file di log specificando /LogFile= (senza argomento nome file ) nella riga di comando.

Osservazioni:

Le applicazioni .NET Framework sono costituite da file di programma tradizionali e risorse associate, ad esempio code di messaggi, registri eventi e contatori delle prestazioni, che devono essere creati quando l'applicazione viene distribuita. È possibile utilizzare i componenti del programma di installazione di un assembly per creare queste risorse quando l'applicazione viene installata e rimuoverle quando l'applicazione viene disinstallata. Installutil.exe rileva ed esegue questi componenti del programma di installazione.

È possibile specificare più assembly nella stessa riga di comando. Qualsiasi opzione specificata prima del nome di un assembly ha effetto sull'installazione di tale assembly. Fatta eccezione per /u e /AssemblyName, le opzioni sono cumulative ma sottoponibili a override. In altre parole, le opzioni specificate per un assembly vengono applicate a tutti gli assembly successivi a meno che l'opzione non venga specificata con un nuovo valore.

Se si esegue Installutil.exe su un assembly senza specificare alcuna opzione, i tre file seguenti verranno inseriti nella directory dell'assembly:

  • InstallUtil.InstallLog - Contiene una descrizione generale dello stato dell'installazione.
  • assemblyname.InstallLog: contiene informazioni specifiche della fase di commit del processo di installazione. Per ulteriori informazioni sulla fase di commit, vedere il metodo Commit.
  • assemblyname.InstallState: contiene i dati usati per disinstallare l'assembly.

Installutil.exe utilizza la reflection per esaminare gli assembly specificati e individuare tutti i tipi Installer il cui attributo System.ComponentModel.RunInstallerAttribute è impostato su true. Lo strumento esegue quindi il metodo Installer.Install o Installer.Uninstall su ciascuna istanza del tipo Installer. Installutil.exe esegue l'installazione in modo transazionale: se risulta impossibile installare uno degli assembly, viene eseguito il rollback dell'installazione di tutti gli altri assembly. La disinstallazione non è invece transazionale.

Installutil.exe può installare o disinstallare assembly con nome sicuro, ma non assembly con firma ritardata.

La versione a 32 bit di Common Language Runtime (CLR) viene fornita solo con la versione a 32 bit dello strumento Installer, ma la versione a 64 bit di CLR viene fornita con versioni a 32 bit e a 64 bit dello strumento Di installazione. Quando si usa CLR a 64 bit, usare lo strumento di installazione a 32 bit per installare assembly a 32 bit e lo strumento di installazione a 64 bit per installare assembly CIL (Common Intermediate Language) a 64 bit e a 64 bit. Il funzionamento delle due versioni dello strumento Programma di installazione è identico.

Non è possibile usare Installutil.exe per distribuire un servizio Windows creato con C++, perché Installutil.exe non riconosce il codice nativo incorporato prodotto dal compilatore C++. Se si tenta di distribuire un servizio di Windows C++ con Installutil.exe, verrà generata un'eccezione quale BadImageFormatException. Per operare con questo scenario, spostare il codice del servizio in un modulo C++, quindi scrivere l'oggetto del programma di installazione in C# o in Visual Basic.

Esempi

Il comando che segue visualizza una descrizione della sintassi e delle opzioni di comando per InstallUtil.exe.

installutil /?

Il comando che segue visualizza una descrizione della sintassi e delle opzioni di comando per InstallUtil.exe. Visualizza anche una descrizione e un elenco delle opzioni supportate dai componenti del programma di installazione in myAssembly.exe se il testo della Guida è stato assegnato alla proprietà Installer.HelpText del programma di installazione.

installutil /? myAssembly.exe

Il comando che segue esegue i componenti del programma di installazione nell'assembly myAssembly.exe.

installutil myAssembly.exe

Il comando che segue esegue i componenti del programma di installazione in un assembly utilizzando l'opzione /AssemblyName e un nome completo.

installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

Il comando che segue esegue i componenti del programma di installazione in un assembly specificato in base al nome file e in un assembly specificato in base al nome sicuro. Si noti che tutti gli assembly specificati in base al nome file devono precedere gli assembly specificati in base al nome sicuro nella riga di comando, poiché l'opzione /AssemblyName non può essere sottoposta a override.

installutil myAssembly.exe /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

Il comando che segue esegue i componenti del programma di disinstallazione nell'assembly myAssembly.exe.

installutil /u myAssembly.exe

Il comando seguente esegue i componenti del programma di disinstallazione negli assembly myAssembly1.exe e myAssembly2.exe.

installutil myAssembly1.exe /u myAssembly2.exe

Poiché la posizione dell'opzione /u nella riga di comando non è importante, questo è equivalente al comando seguente.

installutil /u myAssembly1.exe myAssembly2.exe

Il comando che segue esegue i programmi di installazione nell'assembly myAssembly.exe e specifica che le informazioni sullo stato verranno scritte in myLog.InstallLog.

installutil /LogFile=myLog.InstallLog myAssembly.exe

Il comando che segue esegue i programmi di installazione contenuti nell'assembly myAssembly.exe, specifica che le informazioni sullo stato di avanzamento devono essere scritte in myLog.InstallLog e utilizza l'opzione /reg personalizzata dei programmi di installazione per specificare che è necessario aggiornare il Registro di sistema.

installutil /LogFile=myLog.InstallLog /reg=true myAssembly.exe

Il comando seguente esegue i programmi di installazione contenuti nell'assembly myAssembly.exe, usa l'opzione /email personalizzata del programma di installazione per specificare l'indirizzo di posta elettronica dell'utente ed elimina l'output nel file di log.

installutil /LogFile= /email=admin@mycompany.com myAssembly.exe

Il comando che segue scrive lo stato dell'installazione di myAssembly.exe in myLog.InstallLog e quello di myTestAssembly.exe in myTestLog.InstallLog.

installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe

Vedi anche