Regsvcs.exe (программа установки служб .NET)Regsvcs.exe (.NET Services Installation Tool)

Программа установки служб .NET выполняет следующие действия.The .NET Services Installation tool performs the following actions:

  • Загружает и регистрирует сборку.Loads and registers an assembly.

  • Создает, регистрирует и устанавливает библиотеку типов в указанное приложение COM+.Generates, registers, and installs a type library into a specified COM+ application.

  • Настраивает службы, которые были программно добавлены в создаваемый класс.Configures services that you have added programmatically to your class.

Чтобы применить этот инструмент, воспользуйтесь командной строкой разработчика для Visual Studio (или командной строкой Visual Studio в Windows 7).To run the tool, use the Developer Command Prompt for Visual Studio (or the Visual Studio Command Prompt in Windows 7). Дополнительные сведения см. в разделе Командные строки.For more information, see Command Prompts.

В командной строке введите следующее.At the command prompt, type the following:

СинтаксисSyntax

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

ПараметрыParameters

АргументArgument ОписаниеDescription
assemblyFile.dllassemblyFile.dll Исходный файл сборки.The source assembly file. Сборка должна быть подписана с использованием строгого имени.The assembly must be signed with a strong name. Дополнительные сведения см. в разделе Подпись сборки строгим именем.For more information, see Signing an Assembly with a Strong Name.
ПараметрOption ОписаниеDescription
/appdir: path/appdir: path Определяет корневой каталог приложения.Specifies the root directory of the application.
/appname: applicationName/appname: applicationName Задает имя приложения COM+, которое следует найти или создать.Specifies the name of the COM+ application to either find or create.
/c/c Создает конечное приложение.Creates the target application.
/componly/componly Выполняет только конфигурирование компонентов, методы и интерфейсы игнорируются.Configures components only; ignores methods and interfaces.
/exapp/exapp Указывает, что программа будет работать с существующим приложением.Specifies to the tool to expect an existing application.
/extlb/extlb Использует существующую библиотеку типов.Uses an existing type library.
/fc/fc Находит или создает конечное приложение.Finds or creates the target application.
/help/help Отображает синтаксис команд и параметров программы.Displays command syntax and options for the tool.
/noreconfig/noreconfig Запрещает изменять конфигурации существующего конечного приложения.Does not reconfigure an existing target application.
/nologo/nologo Отключает отображение эмблемы Майкрософт при запуске.Suppresses the Microsoft startup banner display.
/parname: name/parname: name Задает имя или идентификатор приложения COM+, которое следует найти или создать.Specifies the name or id of the COM+ application to either find or create.
/reconfig/reconfig Изменяет конфигурацию существующего конечного приложения.Reconfigures an existing target application. Это значение по умолчанию.This is the default.
/tlb: typelibraryfile/tlb: typelibraryfile Задает устанавливаемый файл библиотеки типов.Specifies the type library file to install.
/u/u Удаляет конечное приложение.Uninstalls the target application.
/quiet/quiet Задает тихий режим, логотип и сообщения об успешном завершении операций не отображаются.Specifies quiet mode; suppresses the logo and success message display.
/?/? Отображает синтаксис команд и параметров программы.Displays command syntax and options for the tool.

ПримечанияRemarks

Программе Regsvcs.exe требуется исходный файл сборки, заданный библиотекой assemblyFile.dll.Regsvcs.exe requires a source assembly file specified by assemblyFile.dll. Эта сборка должна быть подписана с использованием строгого имени.This assembly must be signed with a strong name. Дополнительные сведения о подписи с использованием строгого имени см. в разделе Подпись сборки строгим именем.For more information on strong name signing, see Signing an Assembly with a Strong Name. Имена конечного приложения и файла библиотеки типов не являются обязательными.The names of the target application and the type library file are optional. Аргумент applicationName может быть создан из исходного файла сборки, и в случае его отсутствия он будет создан программой Regsvcs.exe.The applicationName argument can be generated from the source assembly file and will be created by Regsvcs.exe, if it does not already exist. Аргумент typelibraryfile может задавать имя библиотеки типов.The typelibraryfile argument can specify a type library name. Если имя библиотеки типов не указано, программа Regsvcs.exe по умолчанию использует имя сборки.If you do not specify a type library name, Regsvcs.exe uses the assembly name as the default.

Когда программа Regsvcs.exe регистрирует методы компонента, к ней применяются требования и требования ссылки для этих методов.When Regsvcs.exe registers a component's methods, it is subject to the demands and link demands on those methods. Поскольку эта программа выполняется в полностью доверенной среде, большинство требований на получение разрешения удовлетворяется.Because the tool executes in a fully-trusted environment, most demands for a permission succeed. Однако программа Regsvcs.exe не может регистрировать компоненты с помощью методов, защищенных требованием или требованием связи для StrongNameIdentityPermission или PublisherIdentityPermission.However, Regsvcs.exe cannot register components with methods protected by a demand or link demand for the StrongNameIdentityPermission or the PublisherIdentityPermission.

Для работы с программой Regsvcs.exe требуются права администратора на локальном компьютере.You must have administrative privileges on the local computer to use Regsvcs.exe.

Если программа Regsvcs.exe не может выполнить какие-либо из этих действий, на экран выводится соответствующее сообщение об ошибке.If Regsvcs.exe fails while performing any of these actions, it displays corresponding error messages.

ПримерыExamples

Следующая команда добавляет все открытые классы, содержащиеся в myTest.dll, в myTargetApp (существующее приложение COM+) и создает библиотеку типов myTest.tlb.The following command adds all public classes contained in myTest.dll to myTargetApp (an existing COM+ application) and produces the myTest.tlb type library.

regsvcs /appname:myTargetApp myTest.dll  

Следующая команда добавляет все открытые классы, содержащиеся в myTest.dll, в myTargetApp (существующее приложение COM+) и создает библиотеку типов newTest.tlb.The following command adds all public classes contained in myTest.dll to myTargetApp (an existing COM+ application) and produces the newTest.tlb type library.

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

См. такжеSee also