Strumento di installazione dei servizi .NET (Regsvcs.exe)

Aggiornamento: novembre 2007

Lo strumento di installazione dei servizi .NET consente di eseguire le seguenti operazioni:

  • Caricamento e registrazione di un assembly.

  • Generazione, registrazione e installazione di una libreria dei tipi in un'applicazione COM+ 1.0 specificata.

  • Configurazione dei servizi aggiunti alla classe a livello di codice.

regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll 

Parametri

Argomento

Descrizione

Fileassembly.dll

File di assembly di origine. L'assembly deve essere firmato con un nome sicuro. Per ulteriori informazioni, vedere Firma di un assembly con un nome sicuro.

Opzione

Descrizione

/appdir:percorso

Consente di specificare la directory principale dell'applicazione.

/appname:Nomeapplicazione

Consente di specificare il nome dell'applicazione COM+ 1.0 da trovare o creare.

/c

Consente di creare l'applicazione di destinazione.

/componly

Consente di configurare solo i componenti, ignorando metodi e interfacce.

/exapp

Consente di indicare allo strumento di prevedere un'applicazione esistente.

/extlb

Consente di utilizzare una libreria dei tipi esistente.

/fc

Consente di trovare o creare l'applicazione di destinazione.

/help

Visualizza la sintassi e le opzioni dei comandi dello strumento.

/noreconfig

Consente di non riconfigurare un'applicazione di destinazione esistente.

/nologo

Evita la visualizzazione del messaggio di avvio Microsoft.

/parname:nome

Consente di specificare il nome o l'id dell'applicazione COM+ 1.0 da trovare o creare.

/reconfig

Consente di riconfigurare un'applicazione di destinazione esistente. Questa è l'impostazione predefinita.

/tlb:filelibreriatipi

Consente di specificare il file della libreria dei tipi da installare.

/u

Consente di disinstallare l'applicazione di destinazione.

/quiet

Consente di specificare la modalità invisibile all'utente, nonché di disattivare la visualizzazione del logo e dei messaggi di esito positivo.

/?

Visualizza la sintassi e le opzioni dei comandi dello strumento.

Note

Regsvcs.exe richiede un file di assembly di origine specificato da Fileassembly.dll. L'assembly deve essere firmato con un nome sicuro. Per ulteriori informazioni sulla firma con un nome sicuro, vedere Firma di un assembly con un nome sicuro. I nomi dell'applicazione di destinazione e del file della libreria dei tipi sono facoltativi. L'argomento Nomeapplicazione può essere generato dal file di assembly di origine e, se non esiste già, viene creato da Regsvcs.exe. L'argomento filelibreriatipi può specificare il nome di una libreria dei tipi. Se non si specifica il nome di alcuna libreria dei tipi, per impostazione predefinita Regsvcs.exe utilizzerà il nome dell'assembly.

Quando vengono registrati i metodi di un componente, lo strumento è soggetto a richieste e richieste di collegamento su questi metodi. Poiché lo strumento viene eseguito in un ambiente completamente attendibile, molte richieste di autorizzazione vengono completate. Regsvcs.exe non è tuttavia in grado di registrare componenti con metodi protetti da una richiesta o una richiesta di collegamento per StrongNameIdentityPermission o PublisherIdentityPermission.

Per utilizzare Regsvcs.exe, occorre disporre dei privilegi di amministratore sul computer locale.

Se durante una di queste operazioni l'esecuzione di Regsvcs.exe si interrompe, verrà visualizzato un messaggio di errore che indicherà il problema verificatosi. Per una descrizione dettagliata dei possibili errori e dei relativi messaggi, vedere Registrazione manuale di un assembly.

Esempi

Il comando riportato di seguito consente di aggiungere a myTargetApp (un'applicazione COM+ 1.0 esistente) tutte le classi pubbliche contenute in myTest.dll e di produrre la libreria dei tipi myTest.tlb.

regsvcs /appname:myTargetApp myTest.dll

Il comando riportato di seguito consente di aggiungere a myTargetApp, un'applicazione COM+ 1.0 esistente, tutte le classi pubbliche contenute in myTest.dll e di produrre la libreria dei tipi newTest.tlb.

regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll

Vedere anche

Attività

Procedura: firmare un assembly con un nome sicuro

Riferimenti

Strumenti di .NET Framework

Prompt dei comandi di SDK

Altre risorse

Manually Registering an Assembly