Regsvcs.exe (nástroj pro instalaci služeb .NET)

  • Článek

Instalační nástroj .NET Services vykonává tyto akce:

  • Načítá a registruje sestavení.

  • Vytváří, registruje a instaluje knihovnu typů do zadané aplikace modelu COM+.

  • Konfiguruje služby, které jste přidali pomocí programu do vaší třídy.

Ke spuštění nástroje použijte Visual Studio Developer Command Prompt nebo Visual Studio Developer PowerShell.

V příkazovém řádku zadejte následující:

Syntaxe

      regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]  
[/reconfig] [/componly] [/appname:applicationName]  
[/nologo] [/quiet]assemblyFile.dll

Parametry

Argument Description
assemblyFile.dll Zdrojový soubor sestavení. Sestavení musí být podepsáno silným názvem. Další informace naleznete v tématu Podepsání sestavení silným názvem.
Možnost Popis
/appdir:path Určuje kořenový adresář aplikace.
/appname:applicationName Určuje název aplikace modelu COM+, která se má vyhledat nebo vytvořit.
/C Vytvoří cílovou aplikaci.
/componly Nakonfiguruje pouze součásti; ignoruje metody a rozhraní.
/exapp Určuje, že nástroj má očekávat existující aplikaci.
/extlb Použije existující knihovnu typů.
/Fc Vyhledá nebo vytvoří cílovou aplikaci.
/Pomoc Zobrazí syntaxi příkazu a možnosti nástroje.
/noreconfig Znovu nekonfiguruje existující cílovou aplikaci.
/nologo Potlačí zobrazení úvodního nápisu společnosti Microsoft.
/parname:name Určuje název nebo ID aplikace modelu COM+, která se má vyhledat nebo vytvořit.
/reconfig Znovu nakonfiguruje existující cílovou aplikaci. Tato možnost je výchozí.
/tlb:typelibraryfile Určuje soubor knihovny typů instalace, který se má nainstalovat.
/U Odinstaluje cílovou aplikaci.
/Tichý Určuje použití tichého režimu; potlačí zobrazování loga a zpráv o úspěchu.
/? Zobrazí syntaxi příkazu a možnosti nástroje.

Poznámky

Regsvcs.exe vyžaduje zdrojový soubor sestavení určený assemblyFile.dll. Toto sestavení musí být podepsáno silným názvem. Další informace o podepisování silného názvu naleznete v tématu Podepisování sestavení se silným názvem. Názvy cílové aplikace a souboru knihovny typů jsou volitelné. Argument applicationName lze vygenerovat ze zdrojového souboru sestavení a vytvoří ho Regsvcs.exe, pokud ještě neexistuje. Argument typelibraryfile může určovat název knihovny typů. Pokud název knihovny typů nezadáte, nástroj Regsvcs.exe použije jako výchozí název sestavení.

Když Regsvcs.exe zaregistruje metody komponenty, podléhá požadavkům a vazbám na tyto metody. Vzhledem k tomu, že se nástroj spouští v plně důvěryhodném prostředí, většina požadavků na oprávnění je splněna. Regsvcs.exe však nelze registrovat komponenty pomocí metod chráněných poptávkou nebo linkou pro StrongNameIdentityPermission nebo PublisherIdentityPermission.

Pro použití Regsvcs.exe musíte mít administrátorská oprávnění na místním počítači.

Pokud Regsvcs.exe selže při provádění kterékoli z těchto akcí, zobrazí se odpovídající chybové zprávy.

Příklady

Následující příkaz přidá všechny veřejné třídy obsažené v myTest.dllmyTargetApp (existující aplikace modelu COM+) a vytvoří knihovnu myTest.tlb typů.

regsvcs /appname:myTargetApp myTest.dll

Následující příkaz přidá všechny veřejné třídy obsažené v myTest.dllmyTargetApp (existující aplikace modelu COM+) a vytvoří knihovnu newTest.tlb typů.

regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll

Viz také