Regsvcs.exe (Narzędzie instalacji usług .NET)
Narzędzie instalacji usług platformy .NET wykonuje następujące akcje:
Ładuje i rejestruje zestawy.
Generuje, rejestruje i instaluje biblioteki typów w określonej aplikacji COM+.
Konfiguruje usługi, które zostały programowo dodane do klasy użytkownika.
Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.
W wierszu polecenia wpisz:
Składnia
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parametry
| Argument | opis |
|---|---|
| assemblyFile.dll | Plik zestawu źródłowego. Zestaw musi być podpisany za pomocą silnej nazwy. Aby uzyskać więcej informacji, zobacz Podpisywanie zestawu za pomocą silnej nazwy. |
| Opcja | Opis |
|---|---|
| /appdir: ścieżka | Określa katalog główny aplikacji. |
| /appname: applicationName | Określa nazwę aplikacji COM+, która ma zostać znaleziona lub utworzona. |
| /c | Tworzy aplikację docelową. |
| /componly | Konfiguruje tylko składniki; ignoruje metody i interfejsy. |
| /exapp | Określa, że narzędzie ma oczekiwać istniejącej aplikacji. |
| /extlb | Używa istniejącej biblioteki typów. |
| /Fc | Znajduje lub tworzy aplikację docelową. |
| /Pomoc | Wyświetla składnię polecenia i opcje narzędzia. |
| /noreconfig | Nie konfiguruje ponownie istniejącej aplikacji docelowej. |
| /nologo | Pomija wyświetlanie transparentu startowego firmy Microsoft. |
| /parname: nazwa | Określa nazwę lub identyfikator aplikacji COM+, która ma zostać znaleziona lub utworzona. |
| /reconfig | Konfiguruje ponownie istniejącą aplikację docelową. Jest to opcja domyślna. |
| /tlb: typelibraryfile | Określa plik biblioteki typów do zainstalowania. |
| /u | Odinstalowuje aplikację docelową. |
| /quiet | Określa tryb cichy; pomija wyświetlanie logo i komunikatów o sukcesie. |
| /? | Wyświetla składnię polecenia i opcje narzędzia. |
Uwagi
Regsvcs.exe wymaga pliku zestawu źródłowego określonego przez assemblyFile.dll. Ten zestaw musi być podpisany za pomocą silnej nazwy. Aby uzyskać więcej informacji na temat podpisywania silnej nazwy, zobacz Podpisywanie zestawu przy użyciu silnej nazwy. Nazwy aplikacji docelowej i pliku biblioteki typów są opcjonalne. Argument applicationName można wygenerować na podstawie pliku zestawu źródłowego i zostanie utworzony przez Regsvcs.exe, jeśli jeszcze nie istnieje. Argument typelibraryfile może określać nazwę biblioteki typów. Jeśli nie zostanie określona nazwa biblioteki typów, program Regsvcs.exe użyje nazwy zestawu jako wartości domyślnej.
Gdy Regsvcs.exe rejestruje metody składnika, podlega wymaganiom i wymaganiom dotyczącym tych metod. To narzędzie działa we w pełni zaufanym środowisku, więc większość żądań uprawnienia kończy się pomyślnie. Jednak Regsvcs.exe nie może zarejestrować składników z metodami chronionymi przez żądanie lub żądanie połączenia dla elementu StrongNameIdentityPermission lub PublisherIdentityPermission.
Aby używać programu Regsvcs.exe, trzeba mieć uprawnienia administracyjne na komputerze lokalnym.
Jeśli podczas wykonywania dowolnej z tych akcji w programie Regsvcs.exe wystąpi błąd, zostaną wyświetlone odpowiednie komunikaty o błędach.
Przykłady
Następujące polecenie dodaje wszystkie klasy publiczne zawarte w myTest.dll myTargetApp pliku (istniejąca aplikacja COM+) i tworzy bibliotekę myTest.tlb typów.
regsvcs /appname:myTargetApp myTest.dll
Następujące polecenie dodaje wszystkie klasy publiczne zawarte w myTest.dll myTargetApp pliku (istniejąca aplikacja COM+) i tworzy bibliotekę newTest.tlb typów.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
