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