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

  1. На панели задач щелкните Диспетчер сервера.
  2. В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
  3. В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
  4. На странице Роли сервера разверните узлы Веб-сервер (IIS),Веб-сервер, Разработка приложений, а затем выберите CGI. Щелкните Далее.
    Снимок экрана: страница .
  5. На странице Выбор компонентов нажмите кнопку Далее.
  6. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  7. На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

  1. На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите панель управления.
  2. В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узлы Службы IIS, Веб-службы, Функции разработки приложений, а затем выберите CGI.
    Снимок экрана: дерево навигации
  4. Нажмите кнопку ОК.
  5. Щелкните Закрыть.

Windows Server 2008 или Windows Server 2008 R2

  1. На панели задач нажмите кнопку Пуск, выберите Администрирование, а затем диспетчер сервера.
  2. В области иерархии диспетчер сервера разверните узел Роли и выберите Веб-сервер (IIS).
  3. На панели Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
  4. На странице Выбор служб ролеймастера добавления служб ролей выберите CGI и нажмите кнопку Далее.
    Снимок экрана: дерево навигации мастера добавления служб ролей. Выделена и выделена функция C G I.
  5. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  6. На странице Результаты нажмите кнопку Закрыть.

Windows Vista или Windows 7

  1. На панели задач нажмите кнопку Пуск, а затем панель управления.
  2. В панель управления выберите Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узел Службы IIS, выберите CGI и нажмите кнопку ОК.
    Снимок экрана: дерево навигации служб IIS. Расширены функции разработки приложений. Выделена и выделена функция C G I.

Инструкции

Настройка параметров CGI для сайта

  1. Откройте диспетчер служб 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.

  2. В области Подключения разверните имя сервера, узел Сайты, а затем перейдите к веб-сайту или веб-приложению, которые требуется настроить.

  3. На домашней панели сайта или приложения дважды щелкните CGI.
    Снимок экрана: панель

  4. На панели CGI настройте необходимые параметры и нажмите кнопку Применить на панели Действия .
    Снимок экрана: панель C G I. В поле Отображение выбраны понятные имена. Отображаются категории

Конфигурация

Атрибуты

Атрибут Описание
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()