Regsvcs.exe (outil .NET Services Installation)
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+ spécifiée ;
il configure les services que vous avez ajoutés à votre classe par programme.
Cet outil est installé automatiquement avec Visual Studio et avec le Kit de développement logiciel Windows. Pour exécuter l'outil, nous vous recommandons d'utiliser l'invite de commandes Visual Studio ou l'invite de commandes du Kit de développement logiciel (l'interpréteur de commandes CMD). Ces utilitaires vous permettent d'exécuter l'outil facilement, sans naviguer jusqu'au dossier d'installation. Pour plus d'informations, consultez Invites de commandes Visual Studio e t Kit de développement logiciel (SDK) Windows.
Si Visual Studio est installé sur votre ordinateur : dans la barre des tâches, cliquez sur le bouton Start, All Programs, Visual Studio, sur Visual Studio Tools, puis sur Visual Studio Command Prompt.
ou
Si vous avez le Kit de développement logiciel Windows installé sur votre ordinateur : Dans la barre des tâches, cliquez sur Start, All Programs, le dossier correspondant au Kit de développement logiciel, puis sur Command Prompt (ou CMD Shell).
À l'invite de commandes, tapez ce qui suit :
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+ à 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+ à rechercher ou à créer. |
/reconfig |
Reconfigure une application cible existante. Il s'agit de la valeur 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.
Exemples
La commande suivante ajoute toutes les classes publiques figurant dans myTest.dll à myTargetApp (une application COM+ 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+ 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
Invites de commandes Visual Studio e t Kit de développement logiciel (SDK) Windows
Autres ressources
Historique des modifications
Date |
Historique |
Motif |
|---|---|---|
|
Avril 2011 |
Informations supplémentaires sur l'utilisation des invites de commandes de Visual Studio et du Kit de développement logiciel (SDK) Windows. |
Améliorations apportées aux informations. |
|
Juin 2010 |
A supprimé des désignations obsolètes de version. |
Commentaires client. |