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

  • Artículo

La herramienta Instalación de servicios de .NET realiza las siguientes acciones:

  • Carga y registra un ensamblado.

  • Genera, registra e instala una biblioteca de tipos en una aplicación COM+ específica.

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

Para ejecutar la herramienta, use el Símbolo del sistema para desarrolladores de Visual Studio o PowerShell de Visual Studio para desarrolladores.

En el símbolo del sistema, escriba lo siguiente:

Sintaxis

      regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb]  
[/reconfig] [/componly] [/appname:applicationName]  
[/nologo] [/quiet]assemblyFile.dll

Parámetros

Argumento Descripción
assemblyFile.dll Archivo de ensamblado de origen con el que se va a trabajar. El ensamblado debe estar firmado con un nombre seguro. Para obtener más información, vea Procedimiento para firmar 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+ que se busca o se crea.
/c Crea la aplicación de destino.
/componly Solo configura componentes; no tiene en cuenta métodos o interfaces.
/exapp Indica 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 las opciones y la sintaxis de los comandos para la herramienta.
/noreconfig No vuelve a configurar 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+ que se busca o se crea.
/reconfig Vuelve a configurar una aplicación de destino existente. Este 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 modo silencioso; suprime el logotipo y la presentación de mensajes de operaciones correctas.
/? Muestra las opciones y la sintaxis de los comandos para la herramienta.

Comentarios

Regsvcs.exe requiere un archivo de ensamblado de origen especificado por assemblyFile.dll. Este ensamblado debe estar firmado con un nombre seguro. Para obtener más información sobre la firma con nombres seguros, vea Procedimiento para 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 a partir del archivo de ensamblado de origen, 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 ningún 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 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 genera un error durante la realización de alguna de estas acciones, muestra los mensajes de error correspondientes.

Ejemplos

El comando siguiente agrega todas las clases públicas incluidas en myTest.dll a myTargetApp (aplicación COM+ existente) y genera la biblioteca de tipos myTest.tlb.

regsvcs /appname:myTargetApp myTest.dll

El comando siguiente agrega todas las clases públicas incluidas en myTest.dll a myTargetApp (aplicación COM+ existente) y genera la biblioteca de tipos newTest.tlb.

regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll

Vea también