Regsvcs.exe (.NET Services Installation Tool)
Het .NET Services-installatieprogramma voert de volgende acties uit:
Laadt en registreert een assembly.
Hiermee genereert, registreert en installeert u een typebibliotheek in een opgegeven COM+-toepassing.
Hiermee configureert u services die u programmatisch aan uw klas hebt toegevoegd.
Als u het hulpprogramma wilt uitvoeren, gebruikt u de Visual Studio Developer-opdrachtprompt of Visual Studio Developer PowerShell.
Typ het volgende bij de opdrachtprompt:
Syntaxis
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parameters
| Argument | Beschrijving |
|---|---|
| assemblyFile.dll | Het bronassemblybestand. De assembly moet worden ondertekend met een sterke naam. Zie Een assembly ondertekenen met een sterke naam voor meer informatie. |
| Optie | Omschrijving |
|---|---|
| /appdir: pad | Hiermee geeft u de hoofdmap van de toepassing. |
| /appname: applicationName | Hiermee geeft u de naam van de COM+ toepassing te zoeken of te maken. |
| /c | Hiermee maakt u de doeltoepassing. |
| /componly | Alleen onderdelen configureren; negeert methoden en interfaces. |
| /exapp | Hiermee geeft u aan dat het hulpprogramma een bestaande toepassing verwacht. |
| /extlb | Maakt gebruik van een bestaande typebibliotheek. |
| /Fc | Hiermee wordt de doeltoepassing gevonden of gemaakt. |
| /Help | Geeft de opdrachtsyntaxis en opties voor het hulpprogramma weer. |
| /noreconfig | Configureert een bestaande doeltoepassing niet opnieuw. |
| /nologo | Onderdrukt de weergave van de opstartbanner van Microsoft. |
| /parname: naam | Hiermee geeft u de naam of id van de COM+-toepassing op die moet worden gevonden of gemaakt. |
| /opnieuw configureren | Configureert een bestaande doeltoepassing opnieuw. Dit is de standaardinstelling. |
| /tlb: typelibraryfile | Hiermee geeft u het type bibliotheekbestand te installeren. |
| /u | Hiermee verwijdert u de doeltoepassing. |
| /rustig | Hiermee geeft u de stille modus; onderdrukt de weergave van het logo en het geslaagde bericht. |
| /? | Geeft de opdrachtsyntaxis en opties voor het hulpprogramma weer. |
Opmerkingen
Regsvcs.exe vereist een bronassemblybestand dat is opgegeven door assemblyFile.dll. Deze assembly moet worden ondertekend met een sterke naam. Zie Een assembly ondertekenen met een sterke naam voor meer informatie over sterke naamondertekening. De namen van de doeltoepassing en het typebibliotheekbestand zijn optioneel. Het argument ApplicationName kan worden gegenereerd op basis van het bronassemblybestand en wordt gemaakt door Regsvcs.exe, als dit nog niet bestaat. Het argument typelibraryfile kan een typebibliotheeknaam opgeven. Als u geen typebibliotheeknaam opgeeft, gebruikt Regsvcs.exe de assemblynaam als standaardnaam.
Wanneer Regsvcs.exe de methoden van een onderdeel registreert, is deze onderhevig aan de eisen en koppelingsvereisten voor deze methoden. Omdat het hulpprogramma wordt uitgevoerd in een volledig vertrouwde omgeving, slagen de meeste vereisten voor een machtiging. Regsvcs.exe kan echter geen onderdelen registreren met methoden die worden beveiligd door een vraag- of koppelingsvraag voor de StrongNameIdentityPermission of de PublisherIdentityPermission.
U moet beheerdersbevoegdheden hebben op de lokale computer om Regsvcs.exe te kunnen gebruiken.
Als Regsvcs.exe mislukt tijdens het uitvoeren van een van deze acties, worden bijbehorende foutberichten weergegeven.
Voorbeelden
Met de volgende opdracht worden alle openbare klassen toegevoegd myTest.dll aan myTargetApp (een bestaande COM+-toepassing) en wordt de myTest.tlb typebibliotheek geproduceerd.
regsvcs /appname:myTargetApp myTest.dll
Met de volgende opdracht worden alle openbare klassen toegevoegd myTest.dll aan myTargetApp (een bestaande COM+-toepassing) en wordt de newTest.tlb typebibliotheek geproduceerd.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
