소개
Microsoft IIS Administration은 IIS 웹 서버를 원격으로 관리할 수 있는 REST API 기반 도구입니다. 마이크로소프트에서 개발하여 Windows Server 환경에서 웹 사이트, 애플리케이션 풀 및 보안 설정을 표준화된 HTTP 인터페이스를 통해 제어할 수 있게 합니다. 이 도구는 스크립트 기반 자동화와 여러 시스템의 통합 관리에 유용합니다.
상세정보
IIS 웹 서버 관리 API
웹 사이트, 애플리케이션 풀 및 서버 설정을 REST API 엔드포인트를 통해 생성, 수정 및 삭제할 수 있습니다. JSON 형식의 요청과 응답을 사용하여 표준화된 인터페이스를 제공합니다.
다양한 클라이언트 지원
PowerShell, cURL, Python, 자바스크립트 등 HTTP를 지원하는 거의 모든 프레임워크와 프로그래밍 언어에서 API를 호출하여 관리 작업을 수행할 수 있습니다.
원격 관리 지원
API 서비스가 대상 머신의 마이크로서비스로 실행되므로, 네트워크 포트를 열면 원격에서 웹 사이트 생성, 풀 모니터링 및 보안 설정을 처리할 수 있습니다.
기본 사용법/명령어
API를 사용하려면 다음 단계를 따릅니다:
- https://localhost:55539 로 접속하여 Access Keys에서 액세스 토큰을 생성합니다.
- 생성된 토큰을 모든 API 요청의 헤더에 “Access-Token: Bearer {token}” 형태로 포함합니다.
- API Explorer에서 웹 사이트를 조회하려면 /api/webserver/websites 엔드포인트로 GET 요청을 보냅니다.
PowerShell에서 액세스 토큰을 생성하는 예제입니다:
$accessToken = C:srcreposIIS.Administrationscriptsutilsutils.ps1 Generate-AccessToken -url “https://localhost:55539”
이런 경우에 유용합니다
웹 호스팅 환경에서 여러 IIS 서버를 한 곳에서 통합 관리해야 할 때 유용합니다. DevOps 파이프라인에 IIS 구성을 자동화하여 포함시키거나, 스크립트를 통해 대량의 웹 사이트를 생성하고 관리하는 작업에 적합합니다.
지원 환경·시스템 요구사항
64비트 Windows Server 2008 R2 이상에서 지원됩니다. .NET Core 프리뷰 빌드는 제거해야 하며, 설치된 이전 버전의 IIS Administration도 삭제해야 합니다.
최신 버전·업데이트
현재 버전은 2.2.0입니다. IIS 서비스와 별도로 배포되어 빠른 업데이트가 가능하며, Microsoft에서 지속적으로 개선되고 있습니다.
제한 사항·확인 사항
- 설치 후 IIS Manager에서 생성된 웹 사이트를 확인할 수 있습니다.
- 설치 오류 발생 시 수동으로 C:Program FilesIIS Administration 폴더와 “Microsoft IIS Administration” Windows 서비스를 제거해야 합니다.
- API 접근 권한이 필요하면 호스트 머신의 “IIS Administration API Owners” 사용자 그룹에 자신을 추가해야 합니다.
- 권한 문제가 지속되면 appsettings.json의 users/administrators 및 users/owners 섹션에 자신을 추가해야 합니다.
시스템 요구사항
사용 시 IIS가 설치된 Windows 환경이 필요하며, .NET Core 프리뷰 빌드는 제거해야 합니다.


