.NET 服务安装工具 (Regsvcs.exe)

.NET 服务安装工具执行下列操作:

  • 加载并注册程序集。

  • 生成、注册类型库并将其安装到指定的 COM+ 1.0 应用程序中。

  • 配置以编程方式添加到类的服务。

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

参数

参数 说明

assemblyFile.dll

源程序集文件。此程序集必须用强名称进行签名。有关更多信息,请参见使用强名称为程序集签名

选项 说明

/appdir: path

指定应用程序的根目录。

/appname: applicationName

指定要查找或创建的 COM+ 1.0 应用程序的名称。

/c

创建目标应用程序。

/componly

只配置组件;忽略方法和接口。

/exapp

向此工具指定需要现有应用程序。

/extlb

使用现有类型库。

/fc

查找或创建目标应用程序。

/help

显示该工具的命令语法和选项。

/noreconfig

不重新配置现有的目标应用程序。

/nologo

取消显示 Microsoft 启动标题。

/parname: name

指定要查找或创建的 COM+ 1.0 应用程序的名称或 ID。

/reconfig

重新配置现有目标应用程序。这是默认设置。

/tlb: typelibraryfile

指定要安装的类型库文件。

/u

卸载目标应用程序。

/quiet

指定安静模式;取消显示登录和成功消息。

/?

显示该工具的命令语法和选项。

备注

Regsvcs.exe 需要由 assemblyFile.dll 指定的源程序集文件。此程序集必须用强名称进行签名。有关强名称签名的更多信息,请参见使用强名称为程序集签名。目标应用程序的名称和类型库文件的名称都是可选的。applicationName 参数如果不存在,则该参数可从源程序集文件生成并且将由 Regsvcs.exe 创建。typelibraryfile 参数可以指定类型库名称。如果未指定类型库名称,默认情况下,Regsvcs.exe 将使用程序集名称。

当 Regsvcs.exe 注册组件的方法时,它需要遵从那些方法的要求链接要求。因为该工具在完全受信任的环境中执行,所以大多数权限要求都会成功。然而,如果组件中的方法受 StrongNameIdentityPermissionPublisherIdentityPermission 的要求或链接要求保护,则 Regsvcs.exe 无法注册这些组件。

您必须在本地计算机上具有管理特权才能使用 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

请参见

任务

如何:使用强名称为程序集签名

参考

.NET Framework 工具
SDK 命令提示

概念

手动注册程序集