Regsvcs.exe (Herramienta de instalación de servicios de .NET)
Esta herramienta realiza las siguientes acciones:
Carga y registra un ensamblado.
Genera, registra e instala una biblioteca de tipos en una aplicación COM+ especificada.
Configura servicios que se han agregado a la clase mediante programación.
Esta herramienta se instala automáticamente con Visual Studio y con el SDK de Windows. Para ejecutar la herramienta, se recomienda usar el símbolo del sistema de Visual Studio o del SDK de Windows (shell de CMD). Estas utilidades permiten ejecutar la herramienta fácilmente, sin navegar a la carpeta de instalación. Para obtener más información, vea Símbolos del sistema del SDK de Windows y Visual Studio.
Si tiene instalado Visual Studio en el equipo: en la barra de tareas, haga clic en Start, All Programs, Visual Studio y Visual Studio Tools y, a continuación, haga clic en Visual Studio Command Prompt.
O bien
Si tiene el SDK de Windows instalado en el equipo: en la barra de tareas, haga clic en Start, All Programs, haga clic en la carpeta del SDK de Windows y, a continuación, haga clic en Command Prompt (o CMD Shell).
En el símbolo del sistema, escriba:
regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]
[/reconfig] [/componly] [/appname:applicationName]
[/nologo] [/quiet]assemblyFile.dll
Parámetros
Argumento |
Descripción |
---|---|
assemblyFile.dll |
Archivo origen de ensamblado a tratar. El ensamblado debe estar firmado con un nombre seguro. Para obtener más información, vea Firma de un ensamblado con un nombre seguro. |
Opción |
Descripción |
---|---|
/appdir:rutaAcceso |
Especifica el directorio raíz de la aplicación. |
/appname:nombreAplicación |
Especifica el nombre de la aplicación COM+ que se busca o se crea. |
/c |
Crea la aplicación de destino. |
/componly |
Sólo configura componentes; no tiene en cuenta métodos e interfaces. |
/exapp |
Especifica a la herramienta que debe contar con una aplicación existente. |
/extlb |
Utiliza una biblioteca de tipos existente. |
/fc |
Busca o crea la aplicación de destino. |
/help |
Muestra la sintaxis de comandos y opciones para la herramienta. |
/noreconfig |
No reconfigura una aplicación de destino existente. |
/nologo |
Suprime la presentación de la portada de inicio de Microsoft. |
/parname:nombre |
Especifica el nombre o el identificador de la aplicación COM+ que se busca o se crea. |
/reconfig |
Vuelve a configurar una aplicación de destino existente. Éste es el valor predeterminado. |
/tlb:archivoBibliotecaTipos |
Especifica el archivo de biblioteca de tipos que se instala. |
/u |
Desinstala la aplicación de destino. |
/quiet |
Especifica el método no interactivo; suprime el logotipo y la presentación de mensajes de operaciones correctas. |
/? |
Muestra la sintaxis de comandos y opciones para la herramienta. |
Comentarios
Regsvcs.exe requiere un archivo origen de ensamblado especificado por el argumento assemblyFile.dll. Este ensamblado debe estar firmado con un nombre seguro. Para obtener más información sobre la firma con nombres seguros, vea Firmar un ensamblado con un nombre seguro. Los nombres de la aplicación de destino y del archivo de biblioteca de tipos son opcionales. El argumento applicationName se puede generar desde el archivo origen de ensamblado y Regsvcs.exe lo creará si no existe todavía. El argumento typelibraryfile puede especificar un nombre de biblioteca de tipos. Si no se especifica un nombre de biblioteca de tipos, Regsvcs.exe utiliza el nombre del ensamblado como valor predeterminado.
Cuando Regsvcs.exe registra los métodos de un componente, se le aplican las peticiones y las peticiones de vínculos de estos métodos. Como la herramienta se ejecuta en un entorno de confianza total, la mayoría de las peticiones de permisos se llevan a cabo satisfactoriamente. Sin embargo, Regsvcs.exe no puede registrar componentes con métodos protegidos por una petición o petición de vínculo para StrongNameIdentityPermission o PublisherIdentityPermission.
Debe tener privilegios administrativos en el equipo local para utilizar Regsvcs.exe.
Si Regsvcs.exe falla durante la realización de una de estas acciones, muestra los mensajes de error correspondientes.
Ejemplos
El comando siguiente agrega todas las clases públicas contenidas en myTest.dll a myTargetApp (aplicación de COM+ existente) y produce la biblioteca de tipos myTest.tlb.
regsvcs /appname:myTargetApp myTest.dll
El comando siguiente agrega todas las clases públicas contenidas en myTest.dll a myTargetApp (aplicación de COM+ existente) y produce la biblioteca de tipos newTest.tlb.
regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll
Vea también
Tareas
Cómo: Firmar un ensamblado con un nombre seguro
Referencia
Símbolos del sistema del SDK de Windows y Visual Studio
Otros recursos
Herramientas de .NET Framework
Historial de cambios
Fecha |
Historial |
Motivo |
---|---|---|
1 de abril de 2011 |
Se agregó información sobre el uso de los símbolos del sistema de Visual Studio y del SDK de Windows. |
Mejora de la información. |
Junio de 2010 |
Se quitaron las designaciones de versión desfasadas. |
Comentarios de los clientes. |