Executar o IIS Express na linha de comando

2024-03-10

por Vaidy Gopalakrishnan

Visão geral

O IIS Express é uma versão simples e independente do IIS otimizada para desenvolvedores. Este artigo contém etapas para executar um site usando a linha de comando do IIS Express.

Pré-requisitos

Para realizar os procedimentos deste artigo e seguir as etapas, você precisa instalar o seguinte:

Windows XP ou mais recente
IIS Express

Para saber como baixar e instalar o IIS Express, confira Visão geral do IIS Express.

Como executar um site usando o IIS Express na linha de comando

Abra um prompt de comando.

Você não precisa ter os direitos de usuário de um Administrador para executar os comandos descritos nas etapas deste artigo. No entanto, eles são necessários para executar o IIS Express em portas de número 1024 ou menos.
Execute o seguinte comando para acessar a pasta de instalação do IIS Express:
```
cd \Program Files\IIS Express
```
Se você estiver usando um sistema operacional de 64 bits, execute o seguinte comando:
```
cd \Program Files (x86)\IIS Express
```

Execute o seguinte comando para exibir a cadeia de caracteres de uso do 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.

Execute seu site usando uma das seguintes opções:
- Use /config para executar um site com base em um arquivo de configuração.
  
  Para saber mais, confira Executar um site com base em um arquivo de configuração.
- Use /path para executar um site com base na pasta do aplicativo.
  
  Para saber mais, confira Executar um site com base na pasta do aplicativo.
  
  Observação
  
  Não é possível combinar as opções /path e /config.
Depois que o site estiver em execução, você poderá usar a bandeja do sistema do IIS Express para gerenciá-lo. Para saber mais, confira Usar a bandeja do sistema do Windows para gerenciar sites e aplicativos. Você também pode desabilitar a bandeja do sistema executando a seguinte opção:
```
/systray:false
```

Como executar um site com base em um arquivo de configuração

O IIS Express e o IIS usam o arquivo ApplicationHost.config, que especifica configurações globais para sites, pools de aplicativos, manipuladores etc. O IIS Express usa um arquivo ApplicationHost.config padrão específico do usuário que permite que muitos usuários compartilhem o mesmo computador sem interferir nas configurações uns dos outros. Esse arquivo pode ser encontrado na pasta %userprofile%\Documents\IISExpress\config ou na pasta %userprofile%\My Documents\IISExpress\config, de acordo com o sistema operacional. É possível especificar qual site será executado com base em um arquivo de configuração.

Você pode usar os seguintes comandos:

Para executar o site Website1 no arquivo de configuração padrão, execute o seguinte:
```
iisexpress /site:WebSite1
```
Para executar o primeiro site no arquivo de configuração padrão, execute o seguinte:
```
iisexpress
```
Para executar o primeiro site em um arquivo de configuração padrão, execute o seguinte:
```
iisexpress /config:c:\myconfig\applicationhost.config
```
Para executar um site chamado MyBlog com base em um arquivo de configuração personalizado, execute o seguinte:
```
iisexpress /config:c:\myconfig\applicationhost.config /site:MyBlog
```

Observação: a opção /config especifica o caminho completo do arquivo de configuração. Você pode omitir essa opção ao usar o arquivo de configuração padrão. A opção /site especifica um site específico no arquivo de configuração. Você pode omitir essa opção para executar o primeiro site no arquivo de configuração.

Como executar um site com base na pasta do aplicativo

Você também pode usar a opção /path para executar um site diretamente de uma pasta. Essa opção funciona para qualquer tipo de aplicativo, como HTML estático, ASP.NET, PHP e WCF. Por padrão, o IIS Express executa o site em http://localhost:8080/. No caso de um site gerenciado, como o ASP.NET, o IIS Express usa o .NET 4.0. Você pode usar as opções /port e /clr para substituir esses valores padrão.

Por exemplo, o seguinte comando executa o aplicativo “myapp” especificado em http://localhost:9090/ usando .NET 2.0:

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

Compartilhar via