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

La herramienta Instalación de servicios de .NET realiza las siguientes acciones:The .NET Services Installation tool performs the following actions:

  • Carga y registra un ensamblado.Loads and registers an assembly.

  • Genera, registra e instala una biblioteca de tipos en una aplicación COM+ específica.Generates, registers, and installs a type library into a specified COM+ application.

  • Configura los servicios que se han agregado a la clase mediante programación.Configures services that you have added programmatically to your class.

Para ejecutar la herramienta, use Símbolo del sistema para desarrolladores de Visual Studio (o Símbolo del sistema de Visual Studio en Windows 7).To run the tool, use the Developer Command Prompt for Visual Studio (or the Visual Studio Command Prompt in Windows 7). Para más información, consulte Símbolos del sistema.For more information, see Command Prompts.

En el símbolo del sistema, escriba lo siguiente:At the command prompt, type the following:

SintaxisSyntax

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

ParámetrosParameters

ArgumentoArgument DescripciónDescription
assemblyFile.dllassemblyFile.dll Archivo de ensamblado de origen con el que se va a trabajar.The source assembly file. El ensamblado debe estar firmado con un nombre seguro.The assembly must be signed with a strong name. Para obtener más información, vea Signing an Assembly with a Strong Name (Firmar un ensamblado con un nombre seguro).For more information, see Signing an Assembly with a Strong Name.
OpciónOption DescripciónDescription
/appdir: path/appdir: path Especifica el directorio raíz de la aplicación.Specifies the root directory of the application.
/appname: applicationName/appname: applicationName Especifica el nombre de la aplicación COM+ que se busca o se crea.Specifies the name of the COM+ application to either find or create.
/c/c Crea la aplicación de destino.Creates the target application.
/componly/componly Solo configura componentes; no tiene en cuenta métodos o interfaces.Configures components only; ignores methods and interfaces.
/exapp/exapp Indica a la herramienta que debe contar con una aplicación existente.Specifies to the tool to expect an existing application.
/extlb/extlb Utiliza una biblioteca de tipos existente.Uses an existing type library.
/fc/fc Busca o crea la aplicación de destino.Finds or creates the target application.
/help/help Muestra las opciones y la sintaxis de los comandos para la herramienta.Displays command syntax and options for the tool.
/noreconfig/noreconfig No vuelve a configurar una aplicación de destino existente.Does not reconfigure an existing target application.
/nologo/nologo Suprime la presentación de la portada de inicio de Microsoft.Suppresses the Microsoft startup banner display.
/parname: name/parname: name Especifica el nombre o el identificador de la aplicación COM+ que se busca o se crea.Specifies the name or id of the COM+ application to either find or create.
/reconfig/reconfig Vuelve a configurar una aplicación de destino existente.Reconfigures an existing target application. Este es el valor predeterminado.This is the default.
/tlb: typelibraryfile/tlb: typelibraryfile Especifica el archivo de biblioteca de tipos que se instala.Specifies the type library file to install.
/u/u Desinstala la aplicación de destino.Uninstalls the target application.
/quiet/quiet Especifica el modo silencioso; suprime el logotipo y la presentación de mensajes de operaciones correctas.Specifies quiet mode; suppresses the logo and success message display.
/?/? Muestra las opciones y la sintaxis de los comandos para la herramienta.Displays command syntax and options for the tool.

ComentariosRemarks

Regsvcs.exe requiere un archivo de ensamblado de origen especificado por assemblyFile.dll.Regsvcs.exe requires a source assembly file specified by assemblyFile.dll. Este ensamblado debe estar firmado con un nombre seguro.This assembly must be signed with a strong name. Para obtener más información sobre la firma con nombres seguros, vea Signing an Assembly with a Strong Name (Firmar un ensamblado con un nombre seguro).For more information on strong name signing, see Signing an Assembly with a Strong Name. Los nombres de la aplicación de destino y del archivo de biblioteca de tipos son opcionales.The names of the target application and the type library file are optional. El argumento applicationName se puede generar a partir del archivo de ensamblado de origen, y Regsvcs.exe lo creará si no existe todavía.The applicationName argument can be generated from the source assembly file and will be created by Regsvcs.exe, if it does not already exist. El argumento typelibraryfile puede especificar un nombre de biblioteca de tipos.The typelibraryfile argument can specify a type library name. Si no se especifica ningún nombre de biblioteca de tipos, Regsvcs.exe utiliza el nombre del ensamblado como valor predeterminado.If you do not specify a type library name, Regsvcs.exe uses the assembly name as the default.

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.When Regsvcs.exe registers a component's methods, it is subject to the demands and link demands on those methods. Como la herramienta se ejecuta en un entorno de confianza total, la mayoría de las peticiones de permisos se llevan a cabo satisfactoriamente.Because the tool executes in a fully-trusted environment, most demands for a permission succeed. 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.However, Regsvcs.exe cannot register components with methods protected by a demand or link demand for the StrongNameIdentityPermission or the PublisherIdentityPermission.

Debe tener privilegios administrativos en el equipo local para utilizar Regsvcs.exe.You must have administrative privileges on the local computer to use Regsvcs.exe.

Si Regsvcs.exe genera un error durante la realización de alguna de estas acciones, muestra los mensajes de error correspondientes.If Regsvcs.exe fails while performing any of these actions, it displays corresponding error messages.

EjemplosExamples

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.The following command adds all public classes contained in myTest.dll to myTargetApp (an existing COM+ application) and produces the myTest.tlb type library.

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.The following command adds all public classes contained in myTest.dll to myTargetApp (an existing COM+ application) and produces the newTest.tlb type library.

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

Vea tambiénSee also