다음을 통해 공유


최소 오프라인 레이아웃을 사용하여 Visual Studio 업데이트

인터넷에 연결되지 않은 컴퓨터의 경우 최소 레이아웃을 만드는 것이 오프라인 Visual Studio 인스턴스를 업데이트하는 가장 쉽고 빠른 방법입니다.

최소 레이아웃 도구는 팀의 요구에 맞게 조정된 레이아웃을 생성합니다. 엔터프라이즈 관리자는 이 도구를 사용하여 Visual Studio 2017을 비롯한 대부분의 Visual Studio 버전에 대한 업데이트 레이아웃을 만들 수 있습니다. 전체 Visual Studio 레이아웃과 달리 최소 레이아웃은 업데이트된 패키지만 포함하므로 항상 더 작고 빠르게 생성하고 배포할 수 있습니다. 원하는 언어, 워크로드 및 구성 요소만 지정하여 업데이트 레이아웃의 크기를 더욱 최소화할 수 있습니다.

최소 레이아웃을 생성하는 방법

중요하다

이러한 지침에서는 이전에 레이아웃을 만들고 사용했다고 가정합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 Visual Studio 페이지의 네트워크 기반 설치 업데이트 페이지를 참조하세요.

Visual Studio 수명 주기에 대한 자세한 내용은 Visual Studio 제품 수명 주기 및 서비스 페이지를 참조하세요.

이 도구는 Visual Studio 2017(15.9) 이상에 대한 업데이트 레이아웃을 만듭니다. Visual Studio 인스턴스를 업데이트하기 위해 네트워크/오프라인 컴퓨터에 레이아웃을 배포할 수 있습니다. 특정 릴리스의 모든 패키지는 정상 레이아웃 생성동안 다운로드됩니다. Visual Studio 인스턴스에서 복구, 제거 및 기타 표준 작업을 수행하려면 일반 레이아웃 만들기가 필요합니다. 최소 레이아웃은 업데이트된 패키지만 다운로드하므로 오프라인 머신에 더 작고 쉽게 복사할 수 있습니다.

최소 레이아웃 도구 설치

  1. 먼저 여기에서있는 최소 레이아웃 도구를 다운로드합니다. 메시지가 표시되면 저장 을 선택하고, 그 다음 실행을 선택합니다.

    최소 레이아웃 도구를 저장

  2. 사용자 계정 컨트롤 프롬프트에 동의하려면 을 클릭합니다.

    사용자 계정 제어 수락

  3. C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout에 최소 레이아웃 도구가 설치됩니다.

최소 레이아웃 도구를 사용하는 방법

MinimalLayout.exe 다음 명령과 옵션을 사용하여 레이아웃을 생성합니다. 도구를 실행하려면 하나 이상의 명령이 필요합니다. 도구를 실행하는 방법은 다음과 같습니다.

MinimalLayout.exe [command] <options>...

명령어

  • 미리 보기: 이 명령을 사용하여 다운로드할 패키지 수와 이 레이아웃을 만드는 데 사용되는 총 공간을 미리 볼 수 있습니다.

  • 생성: 이 명령을 사용하여 Visual Studio를 업데이트하기 위한 최소 레이아웃을 생성합니다.

  • 다시 생성: 이 명령을 사용하여 기존 최소 레이아웃 응답 파일을 사용하여 레이아웃을 다시 생성합니다. 모든 최소 레이아웃은 원래 최소 레이아웃 입력 매개 변수를 포함하는 MinimalLayout.json 응답 파일을 생성합니다. 다시 생성 명령과 MinimalLayout.json 응답 파일을 사용하여 최소 레이아웃을 다시 생성할 수 있습니다. 이는 이전 최소 레이아웃의 응답 파일을 기반으로 새 Visual Studio 업데이트에 대한 최소 레이아웃을 만들려는 경우에 유용합니다.

    이 명령의 경우 이미 생성된 레이아웃의 MinimalLayout.json 파일 경로가 필요합니다.

    MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
    
  • 확인: 이 명령을 사용하여 레이아웃 폴더가 손상되었는지 확인합니다.

  • 수정: 레이아웃 폴더에서 누락된 패키지를 바꾸는 등 손상된 레이아웃 폴더를 수정하려면 이 명령을 사용합니다.

옵션

옵션 묘사 필수/선택 사항 예시
--목표위치 <방향> 최소 오프라인 레이아웃을 만들 디렉터리를 지정합니다. 필수 --targetLocation c:\VSLayout\
--baseVersion <버전> 이 버전부터 최소 오프라인 레이아웃이 생성됩니다. 필수 --baseVersion 16.4.0
--targetVersion <버전> 이 버전까지 최소 오프라인 레이아웃이 생성됩니다. 필수 --targetVersion 16.4.4
--언어들 최소 오프라인 레이아웃에 포함할 언어를 지정합니다. 여러 값을 공백으로 구분하여 지정할 수 있습니다. 필수 --언어들 en-US fr-FR
--productIds <하나 이상의 제품 ID> 최소 오프라인 레이아웃이 생성될 제품의 ID이며 쉼표로 구분됩니다.
  • Microsoft.VisualStudio.Product.Enterprise
  • Microsoft.VisualStudio.Product.Professional
  • Microsoft.VisualStudio.Product.BuildTools
  • Microsoft.VisualStudio.Product.TestAgent
  • Microsoft.VisualStudio.Product.TestController
  • Microsoft.VisualStudio.Product.TeamExplorer
필수 --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional
--파일 경로 이미 만든 레이아웃에서 MinimalLayout.json 파일의 파일 경로입니다. 이 옵션은 Regenerate 명령에서만 사용됩니다. 다시 생성 명령에 필요 --filePath C:\VSLayout\minimalLayout.js켜기

Regenerate 명령은 --filePath만 옵션으로 사용합니다.
--<하나 이상의 워크로드 또는 구성 요소 ID> 추가 추가할 하나 이상의 워크로드 또는 구성 요소 ID를 지정합니다. --includeRecommended 및/또는를 사용하여 전역적으로 추가 구성 요소를 추가할 수 있습니다.
–-includeOptional (선택 사항 포함) 여러 워크로드 또는 구성 요소 ID를 공백으로 구분하여 지정할 수 있습니다.
선택적 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended 설치된 워크로드에 권장되는 구성 요소를 포함하지만 선택적 구성 요소는 포함하지 않습니다. 선택적 특정 워크로드의 경우:
--추가 Microsoft.VisualStudio.Workload. 관리데스크탑; 추천 포함

모든 워크로드에 적용하려면 : --includeRecommended
--옵션 포함 모든 설치된 워크로드에 대해 권장 구성 요소를 포함한 선택적 구성 요소를 제공합니다. 선택적 특정 워크로드의 경우:
--add Microsoft.VisualStudio.Workload. ManagedDesktop; includeOptional

모든 워크로드에 적용하려면: --includeOptional

최소 레이아웃 생성

중요하다

이러한 지침에서는 이전에 네트워크 설치 레이아웃을 만들었다고 가정합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 Visual Studio 페이지의 네트워크 설치 만들기를 참조하세요.

지정된 버전 범위에 대해 생성 명령을 사용하여 으로 최소 레이아웃을 만드세요. productId, 언어 및 필요한 특정 워크로드도 알아야 합니다. 이 최소 레이아웃은 기본 버전에서 대상 버전까지 Visual Studio 인스턴스를 업데이트합니다.

레이아웃을 만들기 전에 다운로드의 총 크기와 미리 보기 명령을 사용하여 포함된 패키지 수를 확인할 수 있습니다. 이 명령은 생성 명령과 동일한 옵션을 사용하며 세부 정보는 콘솔에 기록됩니다.

최소 레이아웃을 미리 보기, 생성 및 다시 생성하는 방법에 대한 몇 가지 예제를 살펴보겠습니다.

  • 먼저 Visual Studio Enterprise 버전 16.4.0~ 16.4.4 영어용 레이아웃을 미리 보는 방법의 예는 다음과 같습니다.

    MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • 하나의 워크로드를 사용하여 동일한 레이아웃을 생성하는 방법은 다음과 같습니다.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
    
  • 또한 기존 응답 파일을 사용하여 최소 오프라인 레이아웃을 다시 생성하는 방법은 다음과 같습니다.

    MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
    

사용하여 명령을 생성하는 몇 가지 다른 예는 다음과 같습니다.

  • 다음은 추가 워크로드를 추가하고 권장 패키지만 포함하는 방법입니다.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
    
  • 여러 제품을 지원하는 최소 오프라인 레이아웃을 생성할 수도 있습니다.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • 마지막으로, 최소한의 레이아웃에 여러 언어를 포함하는 방법은 다음과 같습니다.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
    

최소 레이아웃을 유지하는 방법

생성된 후 최소 레이아웃을 유지하려면 명령을 사용하여 확인하고 명령을 사용하여 수정합니다. 확인 명령은 최소 레이아웃에 손상되었거나 누락된 패키지가 있는지 확인합니다. verify 명령을 실행한 후 문제가 발생하는 경우 수정 명령을 사용하여 누락되거나 손상된 패키지를 수정합니다.

  • 레이아웃에 손상되거나 누락된 패키지가 있는지 확인하는 방법은 다음과 같습니다.

    MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US
    
  • 해당 레이아웃을 수정하는 방법은 다음과 같습니다.

    MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
    

메모

이 레이아웃은 Visual Studio 설치를 복구하는 데 사용할 수 없습니다. Visual Studio의 기존 인스턴스를 복구하려면 Visual Studio 복구을 참조하세요.

최소한의 오프라인 레이아웃을 사용하여 Visual Studio의 기존 설치를 업데이트하는 방법

최소 레이아웃을 생성한 후 전체 최소 레이아웃 폴더를 클라이언트 컴퓨터에 복사할 수 있습니다. 이 작업은 컴퓨터가 원래 위치에 있는 최소 레이아웃 폴더에 액세스할 수 없는 경우에 필요합니다.

폴더로 이동하여 부트스트래퍼 애플리케이션 이름을 식별합니다. 부트스트래퍼 애플리케이션의 이름은 최소 레이아웃을 생성하는 동안 지정된 ProductId 값에 따라 달라집니다. 일반적인 예제는 아래 표를 참조하세요.

"ProductId" 값 애플리케이션 이름
Microsoft.VisualStudio.Product.Enterprise vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools vs_buildtools.exe

업데이트는 두 단계로 Visual Studio 인스턴스에 적용됩니다. 먼저 Visual Studio 설치 관리자를 업데이트한 다음 Visual Studio를 업데이트합니다.

  1. Visual Studio 설치 관리자 업데이트

    다음 명령을 실행하여 필요한 경우 올바른 부트스트래퍼 애플리케이션 이름으로 vs_enterprise.exe 대체합니다.

    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Visual Studio 애플리케이션 업데이트

    Visual Studio를 업데이트하려면 업데이트하려는 Visual Studio 인스턴스의 installPath를 지정해야 합니다. Visual Studio의 여러 인스턴스가 설치된 경우 각각을 별도로 업데이트해야 합니다. 최소 레이아웃에 없는 구성 요소의 설치를 방지하려면 업데이트 명령을 사용하여 –noWeb 옵션을 지정하는 것이 좋습니다. 이렇게 하면 Visual Studio를 사용할 수 없는 상태로 두지 않습니다.

    다음 명령을 실행하여 installPath 명령줄 매개 변수를 적절하게 대체합니다. 올바른 부트스트래퍼 애플리케이션 이름도 사용해야 합니다.

    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise"
    
  1. Visual Studio 설치 관리자 업데이트

    다음 명령을 실행하여 필요한 경우 올바른 부트스트래퍼 애플리케이션 이름으로 vs_enterprise.exe 대체합니다.

    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Visual Studio 애플리케이션 업데이트

    Visual Studio를 업데이트하려면 업데이트하려는 Visual Studio 인스턴스의 installPath를 지정해야 합니다. Visual Studio의 여러 인스턴스가 설치된 경우 각각을 별도로 업데이트해야 합니다. 최소 레이아웃에 없는 구성 요소의 설치를 방지하려면 업데이트 명령을 사용하여 –noWeb 옵션을 지정하는 것이 좋습니다. 이렇게 하면 Visual Studio를 사용할 수 없는 상태로 두지 않습니다.

    다음 명령을 실행하여 installPath 명령줄 매개 변수를 적절하게 대체합니다. 올바른 부트스트래퍼 애플리케이션 이름도 사용해야 합니다.

    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
    

지원 또는 문제 해결

때로는 상황이 잘못 될 수 있습니다. Visual Studio 설치가 실패하는 경우 단계별 지침은 Visual Studio 설치 및 업그레이드 문제 해결 참조하세요.

다음은 몇 가지 추가 지원 옵션입니다.

  • 설치 관련 문제에는 설치 채팅(영어 전용) 지원 옵션을 사용합니다.
  • Visual Studio 설치 관리자와 Visual Studio IDE 모두에 표시되는 문제 보고 도구를 사용하여 제품 문제를 보고합니다. Visual Studio가 설치되어 있지 않은 IT 관리자라면 IT 관리자 피드백을 제출할 수 있습니다.
  • 기능을 제안하고, 제품 문제를 추적하고, 답변을 찾으려면 Visual Studio 개발자 커뮤니티를 방문하세요.