Ejecución de IIS Express desde la línea de comandos

2024-03-08

por Vaidy Gopalakrishnan

Información general

IIS Express es una versión sencilla e independiente de IIS optimizada para los desarrolladores. En este tutorial se describe cómo ejecutar un sitio mediante la línea de comandos de IIS Express.

Requisitos previos

Para completar los procedimientos de este tutorial, debe tener instalado lo siguiente:

Windows XP o posterior
IIS Express

Para obtener información sobre cómo descargar e instalar IIS Express, consulte Introducción a IIS Express.

Ejecución de un sitio mediante IIS Express desde la línea de comandos

Abra un símbolo del sistema.

No necesita derechos de usuario administrador para ejecutar los comandos de este tutorial. Pero debe tener derechos de administrador si quiere ejecutar IIS Express en puertos numerados 1024 o menos.
Ejecute el siguiente comando para ir a la carpeta de instalación de IIS Express:
```
cd \Program Files\IIS Express
```
O bien, si usa un sistema operativo de 64 bits, ejecute el siguiente comando:
```
cd \Program Files (x86)\IIS Express
```

Ejecute el comando siguiente para ver la cadena de uso de IIS Express:

iisexpress /?

IIS Express Usage:
------------------
iisexpress [/config:config-file] [/site:site-name] [/siteid:site-id] [/systray:boolean] 
iisexpress /path:app-path [/port:port-number] [/clr:clr-version] [/systray:boolean] 

/config:config-file 
The full path to the applicationhost.config file. The default value is the IISExpress8\config\applicationhost.config file that is located in the user's Documents folder.

/site:site-name 
The name of the site to launch, as described in the applicationhost.config file. 

/siteid:site-id 
The ID of the site to launch, as described in the applicationhost.config file.

/path:app-path 
The full physical path of the application to run. You cannot combine this option with the /config and related options. 

/port:port-number 
The port to which the application will bind. The default value is 8080. You must also specify the /path option. 

/clr:clr-version The .NET Framework version (e.g. v2.0) to use to run the application. The default value is v4.0. You must also specify the /path option. 

/systray:boolean 
Enables or disables the system tray application. The default value is true. 

/trace:debug-trace-level 
Valid values are info or i,warning or w,error or e. 

Examples: 
iisexpress /site:WebSite1 
This command runs WebSite1 site from the user profile configuration file.

iisexpress /config:c:\myconfig\applicationhost.config 
This command runs the first site in the specified configuration file. 

iisexpress /path:c:\myapp\ /port:80 
This command runs the site from c:\myapp folder over port 80.

Ejecute el sitio mediante una de las siguientes opciones:
- Use /config para ejecutar un sitio desde un archivo de configuración.
  
  Para obtener más información, consulte Ejecución del sitio desde un archivo de configuración.
- Use /path para ejecutar un sitio desde la carpeta de la aplicación.
  
  Para obtener más información, consulte Ejecución del sitio desde la carpeta de la aplicación.
  
  Nota:
  
  La opción /path y la opción /config no se pueden combinar.
Una vez que el sitio se esté ejecutando, puede usar la bandeja del sistema de IIS Express para administrarlo. Para obtener más información, vea Uso de la bandeja del sistema de Windows para administrar sitios web y aplicaciones. De forma alternativa, puede deshabilitar la bandeja del sistema ejecutando la siguiente opción:
```
/systray:false
```

Ejecución del sitio desde un archivo de configuración

IIS Express e IIS usan el archivo ApplicationHost.config, que especifica la configuración global de sitios, grupos de aplicaciones, controladores, etc. IIS Express usa un archivo ApplicationHost.config predeterminado específico del usuario para permitir que muchos usuarios compartan el mismo equipo sin interferir con la configuración de otros usuarios. Este archivo se encuentra en la carpeta %userprofile%\Documents\IISExpress\config o %userprofile%\My Documents\IISExpress\config, según el sistema operativo. Al ejecutar un sitio desde un archivo de configuración, puede especificar qué sitio se va a ejecutar.

Para ello, puede usar los comandos siguientes:

Para ejecutar el sitio web Website1 en el archivo de configuración predeterminado, ejecute lo siguiente:
```
iisexpress /site:WebSite1
```
Para ejecutar el primer sitio web en el archivo de configuración predeterminado, ejecute lo siguiente:
```
iisexpress
```
Para ejecutar el primer sitio web en un archivo de configuración personalizado, ejecute lo siguiente:
```
iisexpress /config:c:\myconfig\applicationhost.config
```
Para ejecutar un sitio denominado MyBlog desde un archivo de configuración personalizado, ejecute lo siguiente:
```
iisexpress /config:c:\myconfig\applicationhost.config /site:MyBlog
```

Nota: La opción /config especifica la ruta de acceso completa del archivo de configuración. Puede omitir esta opción si quiere usar el archivo de configuración predeterminado. La opción /site especifica un sitio en particular en el archivo de configuración. Puede omitir esta opción para ejecutar el primer sitio en el archivo de configuración.

Ejecución del sitio desde la carpeta de la aplicación

También puede usar la opción /path para ejecutar un sitio directamente desde una carpeta. Esta opción funciona para cualquier tipo de aplicación, incluidos HTML estático, ASP.NET, PHP y WCF. De manera predeterminada, IIS Express ejecutará el sitio en http://localhost:8080/. En el caso de un sitio web administrado, como ASP.NET, IIS Express usará .NET 4.0. Puede usar las opciones /port y /clr para invalidar estos valores predeterminados.

Por ejemplo, el siguiente comando ejecuta la aplicación especificada, "myapp", en http://localhost:9090/ mediante .NET 2.0:

iisexpress /path:c:\myapp\ /port:9090 /clr:v2.0

Compartir a través de