Программа установки служб .NET (Regsvcs.exe)
Обновлен: Ноябрь 2007
Программа установки служб .NET выполняет следующие действия:
Загружает и регистрирует сборку.
Создает, регистрирует и устанавливает библиотеку типов в указанное приложение COM+ 1.0.
Настраивает службы, которые были программно добавлены в создаваемый класс.
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Параметры
Аргумент |
Описание |
|---|---|
файл_сборки.dll |
Исходный файл сборки. Сборка должна быть подписана с использованием строгого имени. Дополнительные сведения см. в разделе Подпись сборки со строгим именем. |
Параметр |
Описание |
|---|---|
/appdir:путь |
Определяет корневой каталог приложения. |
/appname:ИмяПриложения |
Задает имя приложения COM+ 1.0, которое следует найти или создать. |
/c |
Создает целевое приложение. |
/componly |
Выполняет только конфигурирование компонентов, методы и интерфейсы игнорируются. |
/exapp |
Указывает, что программа будет работать с существующим приложением. |
/extlb |
Использует существующую библиотеку типов. |
/fc |
Находит или создает целевое приложение. |
/help |
Отображает синтаксис команд и параметров программы. |
/noreconfig |
Запрещает изменять конфигурации существующего целевого приложения. |
/nologo |
Отключает отображение эмблемы Майкрософт при запуске. |
/parname:имя |
Задает имя или идентификатор приложения COM+ 1.0, которое следует найти или создать. |
/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+ 1.0) и создает библиотеку типов myTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
Следующая команда добавляет все открытые классы, содержащиеся в myTest.dll, в myTargetApp (существующее приложение COM+ 1.0) и создает библиотеку типов newTest.tlb.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
См. также
Задачи
Практическое руководство. Подписание сборки строгим именем