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

  • Статья

Программа установки служб .NET выполняет следующие действия:

  • Загружает и регистрирует сборку.

  • Создает, регистрирует и устанавливает библиотеку типов в указанное приложение COM+.

  • Настраивает службы, которые были программно добавлены в создаваемый класс.

Это средство устанавливается автоматически с Visual Studio и пакетом SDK Windows. Чтобы запустить инструмент, мы рекомендуем использовать командную строку Visual Studio или командную строку пакета Windows SDK (командную оболочку). Эти служебные программы позволяют легко работать с инструментом, не переходя к папке установки. Дополнительные сведения см. в разделе Командная строка Visual Studio и пакета Windows SDK.

  • Если на компьютере установлена среда Visual Studio: на панели задач последовательно щелкните Start, All Programs, Visual Studio, Visual Studio Tools и Visual Studio Command Prompt.

    – или –

    Если на компьютере установлен пакет Windows SDK: на панели задач щелкните Start, выберите All Programs и откройте папку с пакетом Windows SDK, затем щелкните Command Prompt (или CMD Shell).

  • В командной строке введите следующее:

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

Параметры

Аргумент

Описание

файл_сборки.dll

Исходный файл сборки. Сборка должна быть подписана с использованием строгого имени. Дополнительные сведения см. в разделе Подпись сборки со строгим именем.

Параметр

Описание

/appdir:путь

Определяет корневой каталог приложения.

/appname:имя_приложения

Задает имя приложения COM+, которое следует найти или создать.

/c

Создает конечное приложение.

/componly

Выполняет только конфигурирование компонентов, методы и интерфейсы игнорируются.

/exapp

Указывает, что программа будет работать с существующим приложением.

/extlb

Использует существующую библиотеку типов.

/fc

Находит или создает целевое приложение.

/help

Отображает синтаксис команд и параметры программы.

/noreconfig

Запрещает изменять конфигурации существующего целевого приложения.

/nologo

Отключает отображение эмблемы Майкрософт при запуске.

/parname:имя

Задает имя или идентификатор приложения COM+, которое следует найти или создать.

/reconfig

Изменяет конфигурацию существующего целевого приложения. Это значение по умолчанию.

/tlb:файл_библиотеки_типов

Задает устанавливаемый файл библиотеки типов.

/u

Удаляет целевое приложение.

/quiet

Отключает вывод логотипа и сообщений об успехе.

/?

Отображает синтаксис команд и параметры программы.

Заметки

Программе Regsvcs.exe требуется исходный файл сборки, заданной файлом файлСборки.dll. Эта сборка должна быть подписана с использованием строгого имени. Дополнительные сведения о подписи с использованием строгого имени см в разделе Подпись сборки с использованием строгого имени. Имена целевого приложения и файла библиотеки типов не являются обязательными. Аргумент имя_приложения может быть создан из исходного файла сборки. Если такое приложение не существует, Regsvcs.exe создает его. Аргумент файл_библиотеки_типов может задавать имя файла библиотеки типов. Если имя библиотеки типов не указано, программа Regsvcs.exe по умолчанию использует имя сборки.

Когда программа Regsvcs.exe регистрирует методы компонента, к ней применяются требования и требования связывания для этих методов. Поскольку эта программа выполняется в полностью доверенной среде, большинство требований на разрешения удовлетворяется. Но программа Regsvcs.exe не может регистрировать компоненты, используя методы, защищенные требованием или требованием связывания для StrongNameIdentityPermission или PublisherIdentityPermission.

Для использования программы Regsvcs.exe пользователь должен обладать привилегиями администратора на локальном компьютере.

Если Regsvcs.exe не может выполнить какие-либо из этих действий, на экран выводится соответствующее сообщение об ошибке.

Примеры

Следующая команда добавляет все открытые классы, содержащиеся в myTest.dll, в myTargetApp (существующее приложение COM+) и создает библиотеку типов myTest.tlb.

regsvcs /appname:myTargetApp myTest.dll

Следующая команда добавляет все открытые классы, содержащиеся в myTest.dll, в myTargetApp (существующее приложение COM+) и создает библиотеку типов newTest.tlb.

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

См. также

Задачи

Практическое руководство. Подписание сборки строгим именем

Ссылки

Командная строка Visual Studio и пакета Windows SDK

Другие ресурсы

Инструменты .NET Framework

Журнал изменений

Дата

Журнал

Причина

Апрель 2011

Добавлены сведения об использовании командных строк Visual Studio и Windows SDK.

Улучшение информации.

Июнь 2010

Удалены устаревшие обозначения версий.

Обратная связь от клиента.