Partager via


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

Outils du .NET Framework

Invite de commandes du Kit de développement SDK

Autres ressources

Manually Registering an Assembly