CGI <cgi>

아티클
07/19/2023

개요

요소는 <cgi> IIS(인터넷 정보 서비스) 7용 CGI(Common Gateway Interface) 애플리케이션에 대한 기본 설정을 구성합니다. 이러한 설정은 CGI 프로세스를 시작할 때 IIS 7에서 사용할 환경을 정의합니다. 예를 들어 createCGIWithNewConsole 및 createProcessAsUser 특성은 IIS 7이 CGI 애플리케이션을 시작하는 방법을 지정하고 시간 제한 특성은 프로세스를 종료하기 전에 IIS에서 CGI 애플리케이션을 실행할 기간을 지정합니다.

CGI는 경우에 따라 레거시 애플리케이션 환경으로 간주됩니다. 별도의 프로세스로 CGI 애플리케이션을 시작하는 것과 관련된 처리 오버헤드로 인해 HTTP 모듈, ISAPI 확장, ASP/ASP.NET 및 FastCGI와 같은 기술은 애플리케이션 개발을 위해 CGI보다 선호됩니다.

참고

CGI 환경은 기본적으로 설치되지 않습니다. 그러나 CGI 환경을 설치하면 FastCGI 애플리케이션을 사용하는 데 필요한 기능도 설치됩니다. IIS 7에서 FastCGI를 사용하는 방법에 대한 자세한 내용은 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>` 특성은 CREATEProcessAsUser, CreateCGIWithNewConsole 및 CGITimeout 등의 메타베이스 속성에 따라 IIS 6.0을 대체합니다.

설치 프로그램

요소는 <cgi> IIS 7 이상의 기본 설치에 포함되지 않습니다. CGI 환경을 사용하려면 먼저 CGI 역할 서비스를 설치해야 합니다. 설치 프로세스는 및 <modules> 요소 모두 <globalModules> 에 CGI(Common Gateway Interface) 역할 서비스를 등록합니다.

Windows Server 2012 또는 Windows Server 2012 R2

작업 표시줄에서 서버 관리자를 클릭합니다.
서버 관리자관리 메뉴를 클릭한 다음 역할 및 기능 추가를 클릭합니다.
역할 및 기능 추가 마법사에서 다음을 클릭합니다. 설치 유형을 선택하고 다음을 클릭합니다. 대상 서버를 선택하고 다음을 클릭합니다.
서버 역할 페이지에서 웹 서버(IIS)를 확장하고 웹 서버를 확장하고 애플리케이션 개발을 확장한 다음 CGI를 선택합니다. 다음을 클릭합니다.
.
기능 선택 페이지에서 다음을 클릭합니다.
설치 선택 확인 페이지에서 설치를 클릭합니다.
Results(결과) 페이지에서 Close(닫기)를 클릭합니다.

Windows 8 또는 Windows 8.1

시작 화면에서 포인터를 왼쪽 아래 모서리로 이동하고 시작 단추를 마우스 오른쪽 단추로 클릭한 다음 제어판 클릭합니다.
제어판프로그램 및 기능을 클릭한 다음 Windows 기능 켜기 또는 끄기를 클릭합니다.
인터넷 정보 서비스를 확장하고, World Wide Web Services를 확장하고, 애플리케이션 개발 기능을 확장한 다음, CGI를 선택합니다.
확인을 클릭합니다.
닫기를 클릭합니다.

Windows Server 2008 또는 Windows Server 2008 R2

작업 표시줄에서 시작을 클릭하고 관리 도구를 가리킨 다음 서버 관리자 클릭합니다.
서버 관리자 계층 구조 창에서 역할을 확장한 다음 웹 서버(IIS)를 클릭합니다.
웹 서버(IIS) 창에서 Role Services 섹션으로 스크롤한 다음 역할 서비스 추가를 클릭합니다.
역할 서비스 추가 마법사의 역할 서비스 선택 페이지에서 CGI를 선택하고 다음을 클릭합니다.
설치 선택 확인 페이지에서 설치를 클릭합니다.
Results(결과) 페이지에서 Close(닫기)를 클릭합니다.

Windows Vista 또는 Windows 7

작업 표시줄에서 시작을 클릭한 다음 제어판 클릭합니다.
제어판프로그램 및 기능을 클릭한 다음 Windows 기능 켜기 또는 끄기를 클릭합니다.
인터넷 정보 서비스를 확장한 다음 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 창에서 필요한 설정을 구성한 다음 작업 창에서 적용을 클릭합니다.

구성

특성

attribute	Description
`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 사용하여 이러한 설정을 구성할 때 commit 매개 변수 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()

다음을 통해 공유