Visual Studio 2017 설치 및 업그레이드 문제 해결Troubleshooting Visual Studio 2017 installation and upgrade issues

증상Symptoms

Visual Studio 2017을 설치 또는 업데이트할 때 작업이 실패합니다.When you try to install or update Visual Studio 2017, the operation fails.

해결 방법Workaround

이 문제를 해결하려면 아래 단계를 수행합니다.To work around this issue, follow these steps.

1단계 - 이 문제가 알려진 문제인지 확인Step 1 - Check whether this problem is a known issue

Microsoft에서 수정을 진행하고 있는 Visual Studio 설치 관리자에 관련된 몇 가지 알려진 문제가 있습니다.There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. 문제에 대한 해결 방법이 있는지 확인하려면 릴리스 정보의 알려진 문제 섹션을 확인하세요.To see if there's a workaround for your problem, check the Known Issues section of our release notes.

2단계 - 개발자 커뮤니티에서 확인Step 2 - Check with the developer community

Visual Studio 개발자 커뮤니티를 사용하여 오류 메시지를 검색합니다.Search on your error message with the Visual Studio Developer Community. 커뮤니티의 다른 멤버가 문제에 대한 해결책을 문서화했을 수 있습니다.Other members of the community may have documented a solution to your problem.

3단계 - Visual Studio 설치 관리자 디렉터리를 삭제하여 업그레이드 문제 해결Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems

Visual Studio 설치 관리자 부트스트래퍼는 나머지 Visual Studio 설치 관리자를 설치하는 최소한의 간단한 실행 파일입니다.The Visual Studio Installer bootstrapper is a minimal light-weight executable that installs the rest of the Visual Studio Installer. Visual Studio 설치 관리자 파일을 삭제하고 부트스트래퍼를 다시 실행하면 몇 가지 업데이트 실패가 해결될 수 있습니다.Deleting Visual Studio Installer files and then rerunning the bootstrapper might solve some update failures.

참고

다음 작업을 수행하여 Visual Studio 설치 관리자 파일을 다시 설치하고 설치 메타데이터를 다시 설정합니다.Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.

  1. Visual Studio 설치 관리자를 닫습니다.Close the Visual Studio Installer.
  2. Visual Studio 설치 관리자 디렉터리를 삭제합니다.Delete the Visual Studio Installer directory. 일반적으로 디렉터리는 C:\Program Files (x86)\Microsoft Visual Studio\Installer입니다.Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Visual Studio 설치 관리자 부트스트래퍼를 실행합니다.Run the Visual Studio Installer bootstrapper. Downloads 폴더에서 vs_[Visual Studio edition]__*.exe 패턴을 따르는 파일 이름을 사용하는 부트스트래퍼를 찾을 수 있습니다.You may find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe pattern. 해당 응용 프로그램을 찾을 수 없으면 Visual Studio 다운로드 페이지로 이동하고 해당 버전의 Visual Studio에 대한 다운로드를 클릭하여 부트스트래퍼를 다운로드할 수 있습니다.If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. 실행 파일을 실행하여 설치 메타데이터를 다시 설정합니다.Run the executable to reset your installation metadata.
  4. Visual Studio를 다시 설치하거나 업데이트해 보세요.Try to install or update Visual Studio again. 설치 관리자가 계속 실패하면 다음 단계로 이동합니다.If the Installer continues to fail, go to the next step.

4단계 - 문제 보고Step 4 - Report a problem

경우에 따라 손상된 파일에 관련된 문제인 경우 문제를 사례별로 확인해야 할 수 있습니다.In some situations, such as those related to corrupted files, the problems may have to be looked at on a case-by-case basis:

  1. 설치 로그를 수집합니다.Collect your setup logs. 자세한 내용은 Visual Studio 설치 로그를 가져오는 방법을 참조하세요.See How to get the Visual Studio installation logs for details.
  2. Visual Studio 설치 관리자를 열고 문제 보고를 클릭하여 Visual Studio 피드백 도구를 엽니다.Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. [피드백 제공] 단추를 탭하여 피드백 도구를 열 수 있음You can tab to the Provide Feedback button to open the feedback tool
  3. 문제 보고서의 제목을 지정하고 관련 세부 정보를 제공합니다.Give your problem report a title, and provide relevant details. 다음을 클릭하여 첨부 파일 섹션으로 이동하고 생성된 로그 파일을 첨부합니다. 일반적으로 파일은 %TEMP%\vslogs.zip에 있습니다.Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at %TEMP%\vslogs.zip).
  4. 다음을 클릭하여 문제 보고서를 검토하고 제출을 클릭합니다.Click Next to review your problem report, and then click Submit.

5단계 - InstallCleanup.exe를 실행하여 설치 파일 제거Step 5 - Run InstallCleanup.exe to remove installation files

마지막 수단으로 Visual Studio를 제거하여 모든 설치 파일 및 제품 정보를 제거합니다.As a last resort, you can remove Visual Studio to remove all installation files and product information.

  1. Visual Studio 제거의 지침을 따릅니다.Follow the instructions in Remove Visual Studio.
  2. 3단계 - Visual Studio 설치 관리자 디렉터리를 삭제하여 업그레이드 문제 해결에 설명된 부트스트래퍼를 다시 실행하세요.Rerun the bootstrapper that's described in Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems.
  3. Visual Studio를 다시 설치하거나 업데이트해 보세요.Try to install or update Visual Studio again.

6단계-문의(선택 사항)Step 6 - Contact us (optional)

문제 해결 단계가 도움이 되지 않는 경우 라이브 채팅을 통해 설치 지원을 문의할 수 있습니다(영어만 가능).If none of the other steps allow you to successfully install, you can contact us by live chat for installation assistance (English only). 자세한 내용은 Visual Studio 지원 페이지를 참조하세요.For details, see the Visual Studio support page.

오프라인 설치 관리자 문제를 해결하는 방법How to troubleshoot an offline installer

다음 표에서는 로컬 레이아웃에서 설치할 경우 알려진 문제 및 도움이 되는 몇 가지 해결 방법을 보여 줍니다.Here is a table of known issues and some workarounds when installing from a local layout that might help.

문제Issue 항목Item 솔루션Solution
사용자에게 파일에 액세스할 수 있는 권한이 없습니다.Users do not have access to files. 권한(ACL)permissions (ACLs) 오프라인 설치를 공유하기 전에 먼저 다른 사용자에게 읽기 액세스 권한을 부여하도록 권한(ACL)을 조정해야 합니다.Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.
새 작업, 구성 요소 또는 언어가 설치되지 않습니다.New workloads, components, or languages fail to install. --layout 부분 레이아웃에서 설치하고 해당 부분 레이아웃에서 이전에 다운로드하지 않은 워크로드, 구성 요소 또는 언어를 선택하는 경우 인터넷에 액세스할 수 있는지 확인합니다.Make sure that you have internet access if you install from a partial layout and select workloads, components, or languages that were not downloaded previously in that partial layout.

Visual Studio 설치 로그를 가져오는 방법How to get the Visual Studio installation logs

대부분의 설치 문제 해결에는 설치 로그가 필요합니다.Setup logs are needed to troubleshoot most installation issues. Visual Studio 설치 관리자에서 문제 보고를 사용하여 문제를 제출하는 경우 이러한 로그는 보고서에 자동으로 포함됩니다.When you submit an issue by using Report a Problem in the Visual Studio Installer, these logs are automatically included in your report.

Microsoft 지원에 문의하는 경우 Microsoft Visual Studio 및.NET Framework 로그 컬렉션 도구를 사용하여 이러한 설치 로그를 제공해야 할 수 있습니다.If you contact Microsoft Support, you may need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. 로그 컬렉션 도구는 .NET Framework, Windows SDK 및 SQL Server를 포함하여 Visual Studio 2017에 의해 설치된 모든 구성 요소에서 설치 로그를 수집합니다.The log collection tool collects setup logs from all components installed by Visual Studio 2017, including .NET Framework, Windows SDK, and SQL Server. 또한 컴퓨터 정보, Windows Installer 인벤토리는 물론 Visual Studio 설치 관리자, Windows Installer 및 시스템 복원에 대한 Windows 이벤트 로그 정보도 수집합니다.It also collects computer information, a Windows Installer inventory, and Windows event log information for Visual Studio Installer, Windows Installer, and System Restore.

로그를 수집하려면To collect the logs:

  1. 도구를 다운로드합니다.Download the tool.
  2. 관리자 명령 프롬프트를 엽니다.Open an administrative command prompt.
  3. 도구를 저장한 디렉터리에서 Collect.exe를 실행합니다.Run Collect.exe from the directory where you saved the tool.
  4. %TEMP% 디렉터리에서 결과 vslogs.zip 파일을 찾습니다(예: C:\Users\YourName\AppData\Local\Temp\vslogs.zip).Find the resulting vslogs.zip file in your %TEMP% directory, for example, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

참고

이 도구는 실패한 설치가 실행되었던 동일한 사용자 계정으로 실행되어야 합니다.The tool must be run under the same user account that the failed installation was run under. 다른 사용자 계정에서 이 도구를 실행하는 경우 –user:<name> 옵션을 설정하여 실패한 설치가 실행된 사용자 계정을 지정합니다.If you are running the tool from a different user account, set the –user:<name> option to specify the user account under which the failed installation was run. 추가 옵션 및 사용법 정보를 보려면 관리자 명령 프롬프트에서 Collect.exe -?를 실행합니다.Run Collect.exe -? from an administrator command prompt for additional options and usage information.

추가 지원 옵션More support options

문제 해결 단계가 도움이 되지 않는 경우 라이브 채팅을 통해 설치 지원을 문의할 수 있습니다(영어만 가능).If none of the other steps allow you to successfully install, you can contact us by live chat for installation assistance (English only). 자세한 내용은 Visual Studio 지원 페이지를 참조하세요.For details, see the Visual Studio support page.

몇 가지 추가 옵션은 다음과 같습니다.Here are a few more options:

참고 항목See also