ASP.NET IIS 등록 도구(Aspnet_regiis.exe)

여러 버전의 .NET Framework가 한 대의 컴퓨터에서 side-by-side 방식으로 실행되는 경우 ASP.NET 응용 프로그램에 매핑된 ASP.NET ISAPI 버전에 따라 응용 프로그램에 사용되는 CLR(공용 언어 런타임) 버전이 결정됩니다. 관리자 또는 설치 프로그램은 ASP.NET IIS 등록 도구(Aspnet_regiis.exe)를 사용하여 해당 도구와 관련된 ASP.NET ISAPI 버전을 가리키도록 ASP.NET 응용 프로그램의 스크립트 맵을 쉽게 업데이트할 수 있습니다. 또한 이 도구를 사용하면 설치된 모든 ASP.NET 버전의 상태를 표시하고, 도구와 연관된 ASP.NET 버전을 등록하고, 클라이언트 스크립트 디렉터리를 만들고, 기타 구성 작업을 수행할 수 있습니다.

참고

.NET Framework와 함께 제공되는 IIS 등록 도구에는 표준 시스템용과 64비트 시스템용으로 두 가지가 있습니다. 64비트 시스템용 도구는 Windows 폴더에서 Microsoft.NET 디렉터리의 Framework64 디렉터리에 있습니다. 예를 들어, C:\WINDOWS\Microsoft.NET\Framework64\v2.0.50727에 IIS 등록 도구가 있습니다.

aspnet_regiis [options]

옵션

---

설명

---

한 대의 컴퓨터에 여러 ASP.NET 버전이 설치되어 있을 경우 ASP.NET이 side-by-side 방식으로 실행된다고 말합니다. 이러한 설치에서 IIS(인터넷 정보 서비스)는 어떤 버전의 ASP.NET ISAPI(aspnet_isapi.dll)가 ASP.NET 응용 프로그램의 페이지를 처리할지 알아야 합니다. ASP.NET 응용 프로그램과 연관된 ASP.NET ISAPI 버전에 따라 응용 프로그램에 사용되는 CLR 버전이 결정됩니다. ASP.NET 응용 프로그램은 IIS의 스크립트 맵을 사용하여 ASP.NET ISAPI 버전과 연관됩니다. ASP.NET 응용 프로그램의 구성 프로세스를 단순화하기 위해 각 ASP.NET 버전에는 링크된 Aspnet_regiis.exe 버전이 제공되어 있습니다.

참고

각 .NET Framework 버전에는 고유한 Aspnet_regiis.exe 버전이 포함되어 있습니다. 도구의 각 버전은 연관된 .NET Framework 버전에만 적용되므로 적절한 버전의 도구를 사용하여 ASP.NET 응용 프로그램을 구성해야 합니다.

ASP.NET IIS 등록 도구는 연관된 .NET Framework 버전에 ASP.NET 응용 프로그램을 다시 매핑할 때 주로 -s 또는 -sn 옵션과 함께 사용됩니다. 지정한 루트 경로 및 모든 하위 디렉터리에서 응용 프로그램을 업데이트하려면 -s 옵션을 사용합니다. 하위 디렉터리의 응용 프로그램을 업데이트하지 않으려면 -sn 옵션을 사용합니다. 컴퓨터에 있는 기존 ASP.NET 응용 프로그램의 스크립트 맵을 한 번에 모두 업데이트하려면 -r 옵션을 사용합니다.

참고

path 매개 변수는 실제 경로가 아니라 응용 프로그램의 루트 경로를 참조합니다. 예를 들어,W3SVC/1/ROOT/SampleApp1과 같습니다.

반대로, -k 또는 -kn 옵션을 사용하고 응용 프로그램의 루트 경로를 지정하면 ASP.NET IIS 등록 도구를 사용하여 응용 프로그램에서 임의의 ASP.NET 버전에 대한 스크립트 맵을 제거할 수 있습니다. 지정한 루트 경로가 부모 루트 경로에서 스크립트 맵을 상속하는 경우에는 -k 및 -kn 옵션이 효과가 없습니다.

또한 링크된 ASP.NET 버전을 설치 및 제거하는 경우에도 ASP.NET IIS 등록 도구를 사용할 수 있습니다. ASP.NET을 설치하고 기존 ASP.NET 응용 프로그램의 스크립트 맵을 모두 업데이트하려면 -i 옵션을 사용합니다. 스크립트 맵을 업데이트하지 않고 ASP.NET을 설치하려면 -ir 옵션을 사용합니다. 이 도구와 연관된 ASP.NET 버전을 제거하려면 -u 옵션을 사용합니다. 컴퓨터에서 모든 ASP.NET 버전을 제거하려면 -ua 옵션을 사용합니다.

ASP.NET IIS 등록 도구를 사용하여 ASP.NET에 대한 정보를 볼 수도 있습니다. 컴퓨터에 설치되어 있는 모든 ASP.NET 버전의 상태 및 설치 경로를 표시하려면 -lv 옵션을 사용합니다. ASP.NET이 매핑되어 있는 모든 IIS 메타베이스 키에 대한 경로를 보려면 -lk 옵션을 사용합니다.

Aspnet_regiis.exe를 사용하여 클라이언트측 유효성 검사 등의 클라이언트측 스크립트를 설치 및 제거할 수 있습니다. 이 도구와 연관된 ASP.NET 버전에 대한 클라이언트측 스크립트를 각 IIS 사이트 디렉터리의 Aspnet_client 하위 디렉터리에 설치하려면 -c 옵션을 사용합니다. 이 도구와 연관된 ASP.NET 버전에 대해서만 클라이언트측 스크립트를 제거하려면 -e 옵션을 사용합니다. 설치된 모든 ASP.NET 버전에 대해 클라이언트측 스크립트를 제거하려면 -ea 옵션을 사용합니다.

ASP.NET의 side-by-side 실행에 대한 자세한 내용은 ASP.NET의 Side-by-Side 지원을 참조하십시오. 스크립트 맵 및 응용 프로그램 루트 경로에 대한 자세한 내용은http://www.microsoft.com/WindowsServer2003/iis/default.mspx에서 IIS에 대한 설명을 참조하십시오./div>

예제

---

다음 명령은 이 도구와 연관된 ASP.NET 버전을 가리키는 스크립트 맵을 SampleApp1 응용 프로그램과 모든 하위 응용 프로그램에 설치합니다./div>

aspnet_regiis -s W3SVC/1/ROOT/SampleApp1

다음 명령은 SampleApp1 응용 프로그램의 스크립트 맵만 업데이트하며 하위 디렉터리의 응용 프로그램에는 영향을 주지 않습니다.

aspnet_regiis -sn W3SVC/1/ROOT/SampleApp1

다음 명령은 ASP.NET IIS 등록 도구와 연관된 ASP.NET 버전을 설치하고 모든 기존 ASP.NET 응용 프로그램의 스크립트 맵을 업데이트합니다. 현재 이전 ASP.NET버전에 매핑되어 있는 응용 프로그램만 영향을 받습니다.

aspnet_regiis -i

다음 명령은 이 도구와 연관된 ASP.NET 버전을 설치하지만 기존 ASP.NET 응용 프로그램의 스크립트 맵은 업데이트하지 않습니다.

aspnet_regiis -ir

다음 명령은 컴퓨터에 설치된 모든 ASP.NET 버전의 상태 및 설치 경로를 표시합니다.

aspnet_regiis -lv

 참고 사이트