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.