.NET Services Installation-Tool (Regsvcs.exe)
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+ 1.0-Anwendung
Konfigurieren von Diensten, die Sie programmgesteuert in eine Klasse eingefügt haben
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parameter
| Argument | Beschreibung |
|---|---|
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 | Beschreibung |
|---|---|
/appdir: path |
Gibt das Stammverzeichnis der Anwendung an. |
/appname: applicationName |
Gibt den Namen der zu suchenden oder zu erstellenden COM+ 1.0-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 die 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 die 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 Verknüpfungsforderungen 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. Allerdings kann Regsvcs.exe keine Komponenten mit Methoden registrieren, die durch eine Forderung oder Verknüpfungsforderung 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. Eine detaillierte Beschreibung der möglichen Fehler und Fehlermeldungen finden Sie unter Manuelles Registrieren einer Assembly.
Beispiele
Der folgende Befehl fügt myTargetApp (eine vorhandene COM+ 1.0-Anwendung) alle in myTest.dll enthaltenen öffentlichen Klassen hinzu und erstellt die Typbibliothek newTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
Der folgende Befehl fügt myTargetApp (eine vorhandene COM+ 1.0-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
.NET Framework-Tools
SDK-Eingabeaufforderung