Microsoft .NET Framework 3.0 배포 추가정보

Microsoft Corporation

2006 년 7 월

목차

개요
소개
설치 요건
   소프트웨어 요건
   하드웨어 요건
.NET Framework 3.0 재반포 가능 패키지 입수방법
Visual Studio 2005 설치 프로젝트에 의한 .NET Framework 3.0 재배포
사용자에 의한 .NET Framework 3.0 의 수동 설치
응용 프로그램 설치에 재반포 가능 패키지 포함
Web 응용 프로그램을 위한 .NET Framework 3.0 의 재배포
Microsoft .NET Framework 3.0 검색
   레지스트리 키 확인
   Internet Explorer 사용자 에이전트 문자열 확인
.NET Framework 3.0 재반포 가능 패키지의 명령줄 옵션
.NET Framework 3.0 재배포 가능 패키지의 오류 코드

개요

주   이 문서는 잠정판이며, 제품 출시후 내용이 변경될 가능성이 있습니다.

이 기사에서는 .NET Framework 3.0 재배포 가능 패키지 Dotnetfx3.exe를 사용하여 Microsoft .NET Framework 3.0을 배포 하는 방법을 설명합니다.

주   이 문서는 Microsoft .NET Framework 3.0 프리 릴리스판 전용입니다. Components사용 허락 계약서에 설명되어 있듯이, Components는 평가 목적으로만 제공됩니다. 따라서 이 문서의 배포에 관한 시나리오에 포함된 내용, Components 각 부분을 사용 또는 배포할 권리가 사용자에게 부여되는 것은 아닙니다. 사용자의 Components 사용은 Components사용 허락 계약에 근거합니다. 사용 권리와 조건은 Components 사용 허락 계약서를 참조하세요.

소개

.NET Framework 3.0 에서의 IA64 는 Microsoft Windows Server 코드명 "Longhorn" 에서만 지원됩니다.  Longhorn 에는 이미 .NET Framework 3.0 이 포함되어 있습니다. 따라서 재배포 가능 패키지는 불필요합니다.

.NET Framework 3.0 재배포 가능 패키지는 독립 실행형 실행 가능 파일로서 입수할 수도 있습니다. 파일명은 설치 대상의 플랫폼의 종류에 따라 다릅니다. 32 비트 플랫폼의 파일명은 Dotnetfx3.exe, 64 비트 플랫폼의 파일명은 Dotnetfx3_x64.exe 입니다. Dotnet3setup.exe 라는 작은 사이즈의 재배포 가능 패키지를 배포 할 수도 있습니다. 이 재배포 가능 패키지에서는 설치 안에 필요한 구성요소가 다운로드 됩니다.

주   .NET Framework 3.0 으로의 IA64 는 Microsoft Windows Server 코드네임 "Longhorn" 만으로 지원 되고 있습니다. Longhorn 에는 이미 .NET Framework 3.0 이 포함되어 있습니다. 따라서, 재반포 가능 패키지는 불필요합니다.

재배포 가능 패키지는 수동으로 기동 및 설치 하는 일도 .NET Framework 3.0 응용 프로그램의 설치 프로그램의 일부로서 기동 및 설치 할 수도 있습니다.

주   .NET Framework 3.0을 설치 하려면 관리자 권한이 필요합니다.

설치 요건

여기에서는 Microsoft .NET Framework 3.0 재배포 가능 패키지의 설치 전에 컴퓨터의 소프트웨어 및 하드웨어 요건에 대해 설명합니다. 최소 요건이 충족되지 않으면 Dotnetfx3.exe 재배포 가능 패키지 설치가 중지됩니다.

소프트웨어 요건

Microsoft .NET Framework 3.0을 설치 하려면 몇 가지 운영 체제가 설치되어 있어야 합니다.

• Microsoft Windows XP Home 또는 Microsoft Windows XP Professional,  Service Pack 2 이상
• Microsoft Windows Server 2003 패밀리, Service Pack 1 이상

Microsoft Windows Vista (IA64 플랫폼 제외) 및 Microsoft Windows Server 코드명 "Longhorn" IA64 에디션에서는 .NET Framework 3.0 이 운영 체제의 기능을 포함합니다.

하드웨어 요건

다음의 표는 .NET Framework 3.0을 실행하기 위한 하드웨어 요건은 다음과 같습니다.

.NET Framework 3.0 재반포 가능 패키지 입수방법

Microsoft .NET Framework 3.0 재반포 가능 패키지는 Microsoft Vista다운로드 센터 (영어) 또는Microsoft Windows Update Web 사이트로부터 다운로드 할 수 있습니다.

주  Microsoft Windows Update 사이트에서는 .NET Framework 3.0 정식판만을 제공하며, 베타판은 제공하지 않습니다.

사용자에게 인터넷에서 Microsoft .NET Framework 3.0을 다운로드 하여 설치 하도록 요구하는 경우는 재배포 가능 패키지를 자사 네트워크에 공개하지 말고,  사용자가 직접 Microsoft Vista 다운로드 센터 (영어) 또는Microsoft Windows Update Web 사이트로부터 다운로드 하도록 해 주세요.

Visual Studio 2005 설치 프로젝트에 의한 .NET Framework 3.0 재배포

Visual Studio 2005로 작성되어 .NET Framework 3.0을 필요로 하는 응용 프로그램을 배포 하는 경우, 응용 프로그램을 컴퓨터에 설치 하기 전에 .NET Framework 3.0을 설치해야 합니다. .NET Framework 3.0은 Visual Studio 2005 설치 프로젝트로 작성되는 설치 실행 가능 파일에 포함할 수 있습니다. 이 방법이 실용적이지 않은 경우는 .NET Framework 3.0을 수동으로 설치할 수 있습니다.

응용 프로그램과 함께 Microsoft .NET Framework 3.0을 설치 하여 Visual Studio 2005 설치 프로젝트를 구성하면, .NET Framework 3.0 은 응용 프로그램과 함께 패키지화됩니다. 응용 프로그램 설치 조건에 의해 .NET Framework 3.0 이 설치 되어 있는지 확인하여 필요에 따라 응용 프로그램의 설치 전에 .NET Framework 3.0 이 설치 됩니다. Microsoft .NET Framework 3.0 에 의해 .NET Framework 2.0 이 설치 되고 있는지 확인됩니다. 설치 되어 있지 않은 경우는 .NET Framework 2.0을 설치 하도록 요구하는 프롬프트가 표시됩니다.

응용 프로그램의 설치 프로세스에 .NET Framework 3.0 짜려면, 설치 프로젝트를 작성하는 컴퓨터에 옵션의 Visual Studio Extensions for .NET Framework 3.0 이 설치되어 있어야 합니다.

Visual Studio Extensions for .NET Framework 3.0 이 설치 되어 있는지 확인하려면

1. Windows 컨트롤 패널로 [프로그램의 추가와 삭제] 를 클릭합니다.
2. [프로그램의 추가와 삭제] 대화 상자의 [현재 설치 되고 있는 프로그램] 목록에 [Microsoft Visual Studio 2005 Extensions for .NET Framework 3.0] 이 있는지 확인합니다.

목록에 Visual Studio 2005 Extensions for .NET Framework 3.0 이 표시되지 않은 경우는 .NET Framework 3.0 개발툴의 일부로서 확장 패키지를 다운로드 하여 설치 할 수 있습니다. .NET Framework 3.0 개발툴은 마이크로소프트 다운로드 센터의 「Microsoft Visual Studio 코드네임 "Orcas" 커뮤니티 기술 프리뷰 ? .NET Framework 3.0 개발툴 (영어)」페이지에서 다운받을 수 있습니다.

컴퓨터에 Visual Studio Extensions for .NET Framework 3.0 이 설치 되어 있는지 확인되면, .NET Framework 3.0을 포함한 설치 프로젝트를 작성할 수 있습니다.

설치 프로젝트에 .NET Framework 3.0 을 포함하려면

1. Visual Studio 2005를 다음의 순서를 실행하고 새로운 설치 프로젝트를 작성합니다. 
   1. [파일] 메뉴에서 [신규 작성]을 선택하여 [프로젝트]를 클릭합니다.
   2. [그 외의 프로젝트 종류] 에서 [설치와 배치]를 선택합니다.
   3. 프로젝트 이름을 쓰고, [OK]를 클릭합니다.
2. 프로젝트 출력, 머지 모듈, 파일 및 어셈블리를 추가합니다.
3. 솔루션 탐색기로 프로젝트명의 오른쪽 클릭하여 [속성]을 클릭합니다. [속성 페이지] 대화 상자가 표시됩니다.
4. [필수 구성요소]를 클릭합니다.
5. [필수 구성요소를 설치 하는 설치 프로그램을 작성하는] 체크 박스를 온으로 합니다.
6. 목록에서 Microsoft .NET Framework 3.0을 찾아 설치 대상 플랫폼에 적절한 버전을 선택합니다.
7. 필수 구성요소의 제공 장소를 지정합니다.

   .NET Framework 3.0 의 장소에는 Windows Vista 다운로드 사이트 또는 자사 사이트를 지정할 수 있습니다.
   URL 로 응용 프로그램의 배포 CD를 지정할 수도 있습니다.

8. [OK] 를 클릭합니다.

사용자에 의한 .NET Framework 3.0 수동 설치

응용 프로그램과 함께 .NET Framework 3.0을 자동적으로 설치 하는 것이 실용적이지 않은 경우가 있습니다. 이 경우, 사용자 각자 .NET Framework 3.0을 설치할 수 있습니다. 「.NET Framework 3.0 재반포 가능 패키지의 입수방법」에 기술되어 있듯이, 재배포 가능 패키지는 다양한 방법으로 입수할 수 있습니다. 다만, 응용 프로그램의 사용자 중에 재배포 가능 패키지의 입수 및 설치 방법을 모르는 경우는 응용 프로그램의 설치 프로세스와 같이 .NET Framework 3.0 입수 및 설치 방법에 따라 설치합니다.

응용 프로그램 설치에 재반포 가능 패키지 포함

Visual Studio 설치 프로젝트를 작성하지 않은 사용자에 대해 .NET Framework 3.0의 수동 설치를 요구하지 않는 경우는 .NET Framework 3.0의 설치 프로세스를 작성하는 응용 프로그램 설치의 일부로서 넣을 수 있습니다. .NET Framework 3.0 설치 프로세스를 포함하려면, 재배포 가능 패키지를 명령줄로부터 실행하여 다음의 자동 설치 명령줄 옵션을 사용합니다.

/q /norestart

Web 응용 프로그램 .NET Framework 3.0 재배포

..NET Framework 3.0 기능을 기본으로 하는 Web 기본 응용 프로그램에서는 사용자의 컴퓨터에의 .NET Framework 3.0 다운로드 및 설치가 필요합니다. 사용자의 컴퓨터에 .NET Framework 3.0 이 설치 되어 있는지는 브라우저 헤더의 사용자 에이전트 문자열을 쿼리 하는 것으로 특정할 수 있습니다. 적절한 버전의 .NET Framework 가 설치 되지 않은 경우, 사용자가 .NET Framework 3.0 패키지를 설치할 수 있도록 .NET Framework 3.0 다운로드 센터를 알려주시면 됩니다.

Microsoft .NET Framework 3.0 검색

.NET Framework 3.0 이 설치 되고 있는지 레지스트리 키를 확인하여 Internet Explorer 의 사용자 에이전트 문자열을 쿼리 하는 것으로 특정할 수 있습니다.

레지스트리 키 확인

.NET Framework 3.0 설치 관리자는 설치에 성공하면 레지스트리 키를 씁니다. .NET Framework 3.0 이 설치 되어 있는지 다음 표에 나타난 레지스트리 키를 확인하여 알 수 있습니다.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings
\5.0\User Agent\Post Platform

Internet Explorer 사용자 에이전트 문자열 확인

.NET Framework 3.0 이 컴퓨터에 설치 되면, 브라우저 헤더로 리포트되는 사용자 에이전트 문자열에 .NET Framework 3.0 버전 번호가 포함됩니다. 다음의 예는 .NET Framework 3.0 이 설치 되어 있는지 검색 하여 리포트하는 JavaScript 샘플 페이지입니다.

주   이 샘플 페이지에는 Internet Explorer 가 필요합니다.

<HTML>
  <HEAD>
    <TITLE>Test for .NET Framework 3.0</TITLE>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset= utf-8" />
    <SCRIPT LANGUAGE="JavaScript">
    <!--
    var NETFX3RuntimeVersion = "3.0.50727";
    
    function window::onload()
    {
      if (HasRuntimeVersion(NETFX3RuntimeVersion))
      {
result.innerText = "This machine has the correct version of the .NET 
Framework 3.0 runtime: " + NETFX3RuntimeVersion + "."  + "\n\nThis 
machine's userAgent string is: " + navigator.userAgent + ".";
      } 
      else
      {
        document.write("The .NET Framework version 3.0 is not installed on this computer.<br/>"
+ "<a href='http://msdn.microsoft.com/windowsvista/default.aspx'>"
+ "Click here to get</a> .NET Framework 3.0 now.");      }
    }
    
    //
    // Retrieve the version from the user agent string and compare with specified version.
    //
    function HasRuntimeVersion(versionToCheck)
    {
      var userAgentString = navigator.userAgent.match(/.NET Framework 3.0 RunTime [0-9.]+/g);

      if (userAgentString != null)
      {
        var i;

        for (i = 0; i < userAgentString.length; ++i)
        {
          if (CompareVersions(GetVersion(versionToCheck), GetVersion(userAgentString[i])) <= 0)
            return true;
        }
      }

      return false;
    }

    //
    // Extract the numeric part of the version string.
    //
    function GetVersion(versionString)
    {
      var numericString = versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);
      return numericString.slice(1);
    }

    //
    // Compare the version strings by converting them to numeric format.
    //
    function CompareVersions(version1, version2)
    {
      for (i = 0; i < version1.length; ++i)
      {
        var number1 = new Number(version1[i]);
        var number2 = new Number(version2[i]);

        if (number1 < number2)
          return -1;

        if (number1 > number2)
          return 1;
      }

      return 0;
    }
    
    -->
    </SCRIPT>
  </HEAD>
  
  <BODY>
    <div id="result" />
  </BODY>
</HTML>

문자열 " .NET Framework 3.0" 이 발견되면 다음의 메시지가 표시됩니다.

This machine has the correct version of the .NET Framework 3.0: 3.0.50727.
This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 6.0; 
Windows NT 5.1; SV1; .NET CLR 1.1.4322; .NET CLR 2.0.50727; .NET CLR 
3.0.50727).

발견되지 않는 경우는 다음의 메시지가 표시됩니다.

The .NET Framework version 3.0 is not installed on this computer.
Click here to get the .NET Framework 3.0 now.

.NET Framework 3.0 재반포 가능 패키지의 명령줄 옵션

다음의 표는 .NET Framework 3.0 재배포 가능 패키지 설치 프로그램 (Dotnetfx3.exe, Dotnetfx3_x64.exe 또는 Dotnet3setup.exe)을 명령줄로부터 실행할 때에 사용 가능한 옵션을 나타냅니다.

/q

/quiet

/qb

/passive

/uninstall

/remove

/f

/nopatch

/norollback

/norestart

/?

.NET Framework 3.0 재배포 가능 패키지의 오류 코드

다음의 표는 .NET Framework 3.0 재배포 가능 패키지 설치 프로그램 (Dotnetfx3.exe, Dotnetfx3_x64.exe, 또는 Dotnet3setup.exe)에 의해서 반환되는 오류 코드입니다. 오류 코드는 모든 버전의 설치 관리자에서 동일합니다.

ERROR_SUCCESS

ERROR_INSTALL_USEREXIT

ERROR_INSTALL_FAILURE

ERROR_UNKNOWN_PRODUCT

ERROR_PATCH_PACKAGE_INVALID

ERROR_INVALID_COMMAND_LINE

ERROR_SUCCESS_REBOOT_INITIATED

ERROR_PATCH_PACKAGE_REJECTED

ERROR_SUCCESS_REBOOT_REQUIRED