Запуск IIS Express из командной строки

2023-07-19

Вайди Гопалакришнан

Общие сведения

IIS Express — это простая и автономная версия IIS, оптимизированная для разработчиков. В этом пошаговом руководстве описывается запуск сайта с помощью командной строки IIS Express.

Предварительные требования

Для выполнения процедур, описанных в этом пошаговом руководстве, необходимо установить следующие компоненты:

Windows XP или более поздней версии
IIS Express

Сведения о скачивании и установке IIS Express см. в разделе IIS Express Обзор.

Запуск сайта с помощью IIS Express из командной строки

Откройте командную строку.

Для выполнения команд, приведенных в этом пошаговом руководстве, права администратора не требуются. Однако для запуска IIS Express на портах с номером 1024 или менее необходимо иметь права администратора.
Выполните следующую команду, чтобы перейти в папку установки IIS Express:
```
cd \Program Files\IIS Express
```
Или, если вы используете 64-разрядную ОС, выполните следующую команду:
```
cd \Program Files (x86)\IIS Express
```

Выполните следующую команду, чтобы просмотреть строку использования 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.

Запустите сайт, используя одно из следующих средств:
- Используйте /config для запуска сайта из файла конфигурации.
  
  Дополнительные сведения см. в статье Запуск сайта из файла конфигурации.
- Используйте /path для запуска сайта из папки приложения.
  
  Дополнительные сведения см. в статье Запуск сайта из папки приложения.
  
  Примечание
  
  Параметры /path и /config не могут быть объединены.
После запуска сайта для управления им можно использовать IIS Express области управления. Дополнительные сведения см. в статье Управление веб-сайтами и приложениями с помощью панели управления windows. Кроме того, можно отключить область задач, выполнив следующий параметр:
```
/systray:false
```

Запуск сайта из файла конфигурации

IIS Express и IIS используют файл ApplicationHost.config, который задает глобальные параметры для сайтов, пулов приложений, обработчиков и т. д. IIS Express использует файл ApplicationHost.config по умолчанию, чтобы многие пользователи могли совместно использовать один и тот же компьютер без вмешательства в настройки других пользователей. Этот файл находится в папке %userprofile%\Documents\IISExpress\config или %userprofile%\My Documents\IISExpress\config в зависимости от операционной системы. При запуске сайта из файла конфигурации можно указать сайт для запуска.

Доступны следующие команды.

Чтобы запустить веб-сайт Website1 в файле конфигурации по умолчанию, выполните следующую команду:
```
iisexpress /site:WebSite1
```
Чтобы запустить первый веб-сайт в файле конфигурации по умолчанию, выполните следующую команду:
```
iisexpress
```
Чтобы запустить первый веб-сайт в пользовательском файле конфигурации, выполните следующую команду:
```
iisexpress /config:c:\myconfig\applicationhost.config
```
Чтобы запустить сайт с именем MyBlog из пользовательского файла конфигурации, выполните следующую команду:
```
iisexpress /config:c:\myconfig\applicationhost.config /site:MyBlog
```

Примечание. Параметр /config указывает полный путь к файлу конфигурации. Этот параметр можно опустить, если вы хотите использовать файл конфигурации по умолчанию. Параметр /site указывает конкретный сайт в файле конфигурации. Этот параметр можно опустить, чтобы запустить первый сайт в файле конфигурации.

Запуск сайта из папки приложения

Вы также можете использовать параметр /path для запуска сайта непосредственно из папки. Этот параметр подходит для любого типа приложения, включая статический HTML, ASP.NET, PHP и WCF. По умолчанию IIS Express будет запускать сайт на http://localhost:8080/. Для управляемого веб-сайта, например ASP.NET, IIS Express будет использовать .NET 4.0. Для переопределения этих значений по умолчанию можно использовать параметры /port и /clr.

Например, следующая команда запускает указанное приложение myapp http://localhost:9090/ в с помощью .NET 2.0:

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