Regsvcs.exe(.NET 服务安装工具)
更新:2011 年 4 月
.NET 服务安装工具执行下列操作:
加载并注册程序集。
生成、注册类型库并将其安装到指定的 COM+ 应用程序中。
配置以编程方式添加到类的服务。
安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具,我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符(也称 CMD Shell)。 您可以使用这些实用程序轻松运行工具,而不需要导航到安装文件夹。 有关更多信息,请参见 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
参数
参数 |
说明 |
---|---|
assemblyFile.dll |
源程序集文件。 此程序集必须用强名称进行签名。 有关更多信息,请参见使用强名称为程序集签名。 |
选项 |
说明 |
---|---|
/appdir:路径 |
指定应用程序的根目录。 |
/appname:应用程序名称 |
指定要查找或创建的 COM+ 应用程序的名称。 |
/c |
创建目标应用程序。 |
/componly |
只配置组件;忽略方法和接口。 |
/exapp |
向此工具指定需要现有应用程序。 |
/extlb |
使用现有类型库。 |
/fc |
查找或创建目标应用程序。 |
/help |
显示该工具的命令语法和选项。 |
/noreconfig |
不重新配置现有的目标应用程序。 |
/nologo |
取消显示 Microsoft 启动标题。 |
/parname:名称 |
指定要查找或创建的 COM+ 应用程序的名称或 ID。 |
/reconfig |
重新配置现有目标应用程序。 这是默认值。 |
/tlb:typelibraryfile |
指定要安装的类型库文件。 |
/u |
卸载目标应用程序。 |
/quiet |
指定安静模式;取消显示登录和成功消息。 |
/? |
显示该工具的命令语法和选项。 |
备注
Regsvcs.exe 需要由 assemblyFile.dll 指定的源程序集文件。 此程序集必须用强名称进行签名。 有关强名称签名的更多信息,请参见使用强名称为程序集签名。 目标应用程序的名称和类型库文件的名称都是可选的。 applicationName 参数如果不存在,则该参数可从源程序集文件生成并且将由 Regsvcs.exe 创建。 typelibraryfile 参数可以指定类型库名称。 如果未指定类型库名称,默认情况下,Regsvcs.exe 将使用程序集名称。
当 Regsvcs.exe 注册组件的方法时,它需要遵从那些方法的要求和链接要求。 因为该工具在完全受信任的环境中执行,所以大多数权限要求都会成功。 但是,如果组件中的方法受 StrongNameIdentityPermission 或 PublisherIdentityPermission 的要求或链接要求保护,则 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
请参见
任务
参考
Visual Studio 和 Windows SDK 命令提示
其他资源
修订记录
Date |
修订记录 |
原因 |
---|---|---|
2011 年 4 月 |
添加了有关使用 Visual Studio 和 Windows SDK 命令提示符的信息。 |
信息补充。 |
2010 年 6 月 |
已移除过期的版本指定。 |
客户反馈 |