CGI <cgi>
Общие сведения
Элемент <cgi>
настраивает параметры по умолчанию для приложений CGI для служб IIS 7. Эти параметры определяют среду, которую iis 7 будет использовать при запуске процессов CGI. Например, атрибуты createCGIWithNewConsole и createProcessAsUser указывают, как IIS 7 будет запускать приложение CGI, а атрибут timeout указывает, как долго IIS позволит приложению CGI запускаться до завершения процесса.
Иногда CGI считается устаревшей средой приложения. Из-за затрат на обработку, связанных с запуском приложений CGI как отдельных процессов, технологии, такие как HTTP-модули, расширения ISAPI, ASP/ASP.NET и FastCGI, предпочтительнее, чем CGI для разработки приложений.
Примечание
Среда CGI не установлена по умолчанию; однако при установке среды CGI также устанавливаются необходимые функциональные возможности для использования приложений FastCGI. Дополнительные сведения об использовании FastCGI в IIS 7 см. в элементе <fastCgi> .
Совместимость
Версия | Примечания |
---|---|
IIS 10.0 | Элемент <cgi> не был изменен в IIS 10.0. |
IIS 8,5 | Элемент <cgi> не был изменен в IIS 8.5. |
IIS 8,0 | Элемент <cgi> не был изменен в IIS 8.0. |
IIS 7,5 | Элемент <cgi> не был изменен в IIS 7.5. |
IIS 7.0 | Элемент <cgi> появился в IIS 7.0. |
IIS 6,0 | Атрибуты элемента <cgi> заменяют следующие свойства метабазы IIS 6.0: CreateProcessAsUser, CreateCGIWithNewConsole и CGITimeout. |
Настройка
Элемент <cgi>
не входит в установку iis 7 и более поздних версий по умолчанию. Чтобы использовать среду CGI, необходимо сначала установить службу роли CGI. Процесс установки регистрирует службу роли CGI в элементе <globalModules>
и <modules>
.
Windows Server 2012 или Windows Server 2012 R2
- На панели задач щелкните Диспетчер сервера.
- В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
- В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
- На странице Роли сервера разверните узлы Веб-сервер (IIS),Веб-сервер, Разработка приложений, а затем выберите CGI. Щелкните Далее.
.
- На странице Выбор компонентов нажмите кнопку Далее.
- На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
- На странице Результаты нажмите кнопку Закрыть.
Windows 8 или Windows 8.1
- На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите панель управления.
- В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
- Разверните узлы Службы IIS, Веб-службы, Функции разработки приложений, а затем выберите CGI.
- Нажмите кнопку ОК.
- Щелкните Закрыть.
Windows Server 2008 или Windows Server 2008 R2
- На панели задач нажмите кнопку Пуск, выберите Администрирование, а затем диспетчер сервера.
- В области иерархии диспетчер сервера разверните узел Роли и выберите Веб-сервер (IIS).
- На панели Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
- На странице Выбор служб ролеймастера добавления служб ролей выберите CGI и нажмите кнопку Далее.
- На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
- На странице Результаты нажмите кнопку Закрыть.
Windows Vista или Windows 7
- На панели задач нажмите кнопку Пуск, а затем панель управления.
- В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
- Разверните узел Службы IIS, выберите CGI и нажмите кнопку ОК.
Инструкции
Настройка параметров CGI для сайта
Откройте диспетчер служб IIS:
Если вы используете Windows Server 2012 или Windows Server 2012 R2:
- На панели задач щелкните диспетчер сервера, выберите Сервис, а затем диспетчер служб IIS.
Если вы используете Windows 8 или Windows 8.1:
- Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
- Щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.
Если вы используете Windows Server 2008 или Windows Server 2008 R2:
- На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем выберите Пункт Диспетчер служб IIS.
Если вы используете Windows Vista или Windows 7:
- На панели задач нажмите кнопку Пуск, а затем панель управления.
- Дважды щелкните Администрирование, а затем дважды щелкните Диспетчер служб IIS.
В области Подключения разверните имя сервера, узел Сайты, а затем перейдите к веб-сайту или веб-приложению, которые требуется настроить.
На домашней панели сайта или приложения дважды щелкните CGI.
На панели CGI настройте необходимые параметры и нажмите кнопку Применить на панели Действия .
Конфигурация
Атрибуты
Атрибут | Описание |
---|---|
createCGIWithNewConsole |
Дополнительный логический атрибут. Указывает, выполняется ли приложение CGI в собственной консоли. Примечание: Если задано значение true, каждое приложение CGI создает новую консоль при запуске приложения. Значение false указывает, что приложения CGI должны выполняться без консоли. Значение по умолчанию — false . |
createProcessAsUser |
Дополнительный логический атрибут. Указывает, создается ли процесс CGI в контексте системы или в контексте запрашивающего пользователя. Значение по умолчанию — true . |
timeout |
Необязательный атрибут timeSpan. Указывает время ожидания для приложения CGI. Значение по умолчанию — 00:15:00 (15 минут). |
Дочерние элементы
Отсутствует.
Образец конфигурации
В следующем примере конфигурации указывается, что каждое приложение CGI создает новую консоль при запуске приложения, что процессы CGI создаются в контексте запрашивающего пользователя и что время ожидания для приложений CGI составляет 20 минут.
<configuration>
<system.webServer>
<cgi createCGIWithNewConsole="true"
createProcessAsUser="false"
timeout="00:20:00" />
</system.webServer>
</configuration>
Пример кода
В следующих примерах кода указывается, что каждое приложение CGI создает новую консоль при запуске приложения, что процессы CGI создаются в контексте запрашивающего пользователя и что время ожидания для приложений CGI составляет 20 минут.
AppCmd.exe
appcmd.exe set config "Default Web Site" -section:system.webServer/cgi /createCGIWithNewConsole:"True" /commit:apphost
appcmd.exe set config "Default Web Site" -section:system.webServer/cgi /createProcessAsUser:"False" /commit:apphost
appcmd.exe set config "Default Web Site" -section:system.webServer/cgi /timeout:"00:20:00" /commit:apphost
Примечание
При использовании AppCmd.exe для настройки этих параметров для параметра apphost
фиксации необходимо задать значение . Это зафиксирует параметры конфигурации в соответствующем разделе расположения в файле ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection cgiSection = config.GetSection("system.webServer/cgi", "Default Web Site");
cgiSection["createCGIWithNewConsole"] = true;
cgiSection["createProcessAsUser"] = false;
cgiSection["timeout"] = TimeSpan.Parse("00:20:00");
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim cgiSection As ConfigurationSection = config.GetSection("system.webServer/cgi", "Default Web Site")
cgiSection("createCGIWithNewConsole") = True
cgiSection("createProcessAsUser") = False
cgiSection("timeout") = TimeSpan.Parse("00:20:00")
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var cgiSection = adminManager.GetAdminSection("system.webServer/cgi", "MACHINE/WEBROOT/APPHOST/Default Web Site");
cgiSection.Properties.Item("createCGIWithNewConsole").Value = true;
cgiSection.Properties.Item("createProcessAsUser").Value = false;
cgiSection.Properties.Item("timeout").Value = "00:20:00";
adminManager.CommitChanges();
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set cgiSection = adminManager.GetAdminSection("system.webServer/cgi", "MACHINE/WEBROOT/APPHOST/Default Web Site")
cgiSection.Properties.Item("createCGIWithNewConsole").Value = True
cgiSection.Properties.Item("createProcessAsUser").Value = False
cgiSection.Properties.Item("timeout").Value = "00:20:00"
adminManager.CommitChanges()