Compartir a través de


Herramienta Instalación de servicios de .NET (Regsvcs.exe)

Esta herramienta realiza las siguientes acciones:

  • Carga y registra un ensamblado.

  • Genera, registra e instala una biblioteca de tipos en una aplicación COM+ 1.0 especificada.

  • Configura servicios que se han agregado a la clase mediante programación.

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: path

Especifica el directorio raíz de la aplicación.

/appname: applicationName

Especifica el nombre de la aplicación COM+ 1.0 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: name

Especifica el nombre o el identificador de la aplicación COM+ 1.0 que se busca o se crea.

/reconfig

Vuelve a configurar una aplicación de destino existente. Éste es el valor predeterminado.

/tlb: typelibraryfile

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 aprobación.

/?

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 mediante una petición o una 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. Para obtener una descripción más detallada de los posibles errores y mensajes de error, vea Registrar un ensamblado manualmente.

Ejemplos

El comando siguiente agrega todas las clases públicas contenidas en .dll a myTargetApp (aplicación de COM+ 1.0 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 .dll a myTargetApp (aplicación de COM+ 1.0 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

Herramientas de .NET Framework
Símbolo del sistema de SDK

Conceptos

Registrar manualmente un ensamblado