Regsvcs.exe (.NET Services Installation-Tool)
Aktualisiert: April 2011
Mit dem .NET Services Installation-Tool können folgende Aktionen ausgeführt werden:
Laden und Registrieren einer Assembly
Generieren, Registrieren und Installieren einer Typbibliothek in einer angegebenen COM+-Anwendung
Konfigurieren von Diensten, die Sie programmgesteuert in eine Klasse eingefügt haben
Dieses Tool wird automatisch mit Visual Studio und mit dem Windows SDK installiert. Um das Tool auszuführen, empfiehlt es sich, dass Sie die Visual Studio-Eingabeaufforderung oder Windows SDK-Eingabeaufforderung (CMD-Shell) verwenden. Mit diesen Hilfsprogrammen können Sie das Tool problemlos ausführen, ohne in den Installationsordner zu navigieren. Weitere Informationen finden Sie unter Visual Studio- und Windows SDK-Eingabeaufforderungen.
Wenn Visual Studio auf dem Computer installiert ist: Klicken Sie auf der Taskleiste auf Start, All Programs, Visual Studio und Visual Studio Tools, und klicken Sie dann auf Visual Studio Command Prompt.
– oder –
Wenn das Windows SDK auf Ihrem Computer installiert ist: Klicken Sie auf der Taskleiste auf Start, All Programs, klicken Sie auf den Ordner für das Windows SDK, und klicken anschließend auf Command Prompt (oder CMD Shell).
Geben Sie an der Eingabeaufforderung Folgendes ein:
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parameter
Argument |
Beschreibungen |
---|---|
assemblyFile.dll |
Die Quelldatei für die Assembly. Die Assembly muss mit einem starken Namen signiert sein. Weitere Informationen dazu finden Sie unter Signieren einer Assembly mit einem starken Namen. |
Option |
Beschreibungen |
---|---|
/appdir:path |
Gibt das Stammverzeichnis der Anwendung an. |
/appname:applicationName |
Gibt den Namen der zu suchenden oder zu erstellenden COM+-Anwendung an. |
/c |
Erstellt die Zielanwendung. |
/componly |
Konfiguriert nur Komponenten und ignoriert Methoden und Schnittstellen. |
/exapp |
Legt für das Tool fest, dass eine vorhandene Anwendung erwartet wird. |
/extlb |
Verwendet eine vorhandene Typbibliothek. |
/fc |
Sucht oder erstellt die Zielanwendung. |
/help |
Zeigt Befehlssyntax und Optionen für das Tool an. |
/noreconfig |
Eine vorhandene Zielanwendung wird nicht neu konfiguriert. |
/nologo |
Unterdrückt die Anzeige des Startbanners von Microsoft. |
/parname:name |
Gibt den Namen oder die ID der zu suchenden oder zu erstellenden COM+ 1.0-Anwendung an. |
/reconfig |
Konfiguriert eine vorhandene Zielanwendung neu. Dies ist die Standardeinstellung. |
/tlb:typelibraryfile |
Gibt die zu installierende Typbibliotheksdatei an. |
/u |
Deinstalliert die Zielanwendung. |
/quiet |
Gibt den stillen Modus an, in dem das Logo und die Anzeige von Erfolgsmeldungen unterdrückt werden. |
/? |
Zeigt Befehlssyntax und Optionen für das Tool an. |
Hinweise
Für Regsvcs.exe ist eine von assemblyFile.dll angegebene Quelldatei für die Assembly erforderlich. Diese Assembly muss mit einem starken Namen signiert sein. Weitere Informationen zum Signieren mit starken Namen finden Sie unter Signieren einer Assembly mit einem starken Namen. Die Namen der Zielanwendung und der Typbibliothek sind optional. Das applicationName-Argument kann aus der Quelldatei für die Assembly generiert werden und wird von Regsvcs.exe erstellt, sofern nicht bereits vorhanden. Über das typelibraryfile-Argument kann der Name einer Typbibliothek angeben werden. Wenn Sie keinen Typbibliotheksnamen angeben, verwendet Regsvcs.exe als Standardwert den Assemblynamen.
Wenn Regsvcs.exe die Methoden einer Komponente registriert, unterliegt es den Forderungen und Linkforderungen für diese Methoden. Da das Tool in einer vollständig vertrauenswürdigen Umgebung ausgeführt wird, sind die meisten Forderungen für eine Berechtigung erfolgreich. Regsvcs.exe kann jedoch keine Methoden registrieren, die durch eine Forderung oder Linkforderung für StrongNameIdentityPermission oder PublisherIdentityPermission geschützt sind.
Für die Verwendung von Regsvcs.exe benötigen Sie Administratorrechte auf dem lokalen Computer.
Wenn beim Ausführen einer dieser Aktionen ein Fehler auftritt, zeigt Regsvcs.exe entsprechende Fehlermeldungen an.
Beispiele
Der folgende Befehl fügt myTargetApp (eine vorhandene COM+-Anwendung) alle in myTest.dll enthaltenen öffentlichen Klassen hinzu und erstellt die Typbibliothek myTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
Der folgende Befehl fügt myTargetApp (eine vorhandene COM+-Anwendung) alle in myTest.dll enthaltenen öffentlichen Klassen hinzu und erstellt die Typbibliothek newTest.tlb.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
Siehe auch
Aufgaben
Gewusst wie: Signieren einer Assembly mit einem starken Namen
Referenz
Visual Studio- und Windows SDK-Eingabeaufforderungen
Weitere Ressourcen
Änderungsprotokoll
Datum |
Versionsgeschichte |
Grund |
---|---|---|
April 2011 |
Hinzugefügte Informationen zur Verwendung der Visual Studio- und Windows SDK-Eingabeaufforderungen. |
Informationsergänzung. |
Juni 2010 |
Veraltete Versionsbezeichnungen entfernt. |
Kundenfeedback. |