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.