Outil .NET Services Installation Tool (Regsvcs.exe)
Mise à jour : novembre 2007
L'outil .NET Services Installation Tool (Installation des services .NET) effectue les actions suivantes :
il charge et inscrit un assembly ;
il génère, inscrit et installe une bibliothèque de types dans l'application COM+ 1.0 spécifiée ;
il configure les services que vous avez ajoutés à votre classe par programme.
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Paramètres
Argument |
Description |
|---|---|
assemblyFile.dll |
Fichier d'assembly source. L'assembly doit être signé avec un nom fort. Pour plus d'informations, consultez Signature d'un assembly avec un nom fort. |
Option |
Description |
|---|---|
/appdir:path |
Spécifie le répertoire racine de l'application. |
/appname:applicationName |
Spécifie le nom de l'application COM+ 1.0 à rechercher ou à créer. |
/c |
Crée l'application cible. |
/componly |
Configure uniquement les composants ; ignore les méthodes et les interfaces. |
/exapp |
Spécifie à l'outil qu'il doit attendre une application existante. |
/extlb |
Utilise une bibliothèque de types existante. |
/fc |
Recherche ou crée l'application cible. |
/help |
Affiche la syntaxe et les options de commande de l'outil. |
/noreconfig |
Ne reconfigure pas une application cible existante. |
/nologo |
Supprime l'affichage de la bannière de démarrage Microsoft. |
/parname:name |
Spécifie le nom ou l'identificateur de l'application COM+ 1.0 à rechercher ou à créer. |
/reconfig |
Reconfigure une application cible existante. Il s'agit de l'option par défaut. |
/tlb:typelibraryfile |
Spécifie le fichier bibliothèque de types à installer. |
/u |
Désinstalle l'application cible. |
/quiet |
Spécifie le mode silencieux ; supprime le logo et l'affichage des messages de réussite. |
/? |
Affiche la syntaxe et les options de commande de l'outil. |
Notes
Regsvcs.exe requiert un fichier d'assembly source spécifié par assemblyFile.dll. Cet assembly doit être signé avec un nom fort. Pour plus d'informations sur la signature avec un nom fort, consultez Signature d'un assembly avec un nom fort. Le nom de l'application cible et le nom du fichier bibliothèque de types sont facultatifs. L'argument applicationName peut être généré à partir du fichier d'assembly source et sera créé par Regsvcs.exe, s'il n'existe pas déjà. L'argument typelibraryfile peut spécifier un nom de bibliothèque de types. Si vous ne spécifiez pas de nom de bibliothèque de types, Regsvcs.exe utilise alors par défaut le nom de l'assembly.
Lorsque Regsvcs.exe inscrit les méthodes d'un composant, il est soumis aux demandes et aux demandes de liaison sur ces méthodes. Étant donné que l'outil s'exécute dans un environnement de niveau de confiance total, la plupart des demandes d'autorisation aboutissent. Toutefois, Regsvcs.exe ne peut pas inscrire de composants avec des méthodes protégées par une demande ou une demande de liaison pour les autorisations StrongNameIdentityPermission ou PublisherIdentityPermission.
Vous devez détenir des privilèges d'administrateur sur l'ordinateur local pour utiliser Regsvcs.exe.
Si Regsvcs.exe échoue tandis qu'il effectue l'une de ces actions, il affiche les messages d'erreur correspondants. Pour plus d'informations sur les défaillances éventuelles et les messages d'erreur, consultez Inscription manuelle d'un assembly.
Exemples
La commande suivante ajoute toutes les classes publiques figurant dans myTest.dll à myTargetApp (une application COM+ 1.0 existante) et génère la bibliothèque de types myTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
La commande suivante ajoute toutes les classes publiques figurant dans myTest.dll à myTargetApp (une application COM+ 1.0 existante) et génère la bibliothèque de types newTest.tlb.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
Voir aussi
Tâches
Comment : signer un assembly avec un nom fort
Référence
Invite de commandes du Kit de développement SDK