Visual Studio 설치에 대한 명령줄 매개 변수 예

적용 대상:yesVisual Studio noMac용 Visual Studio noVisual Studio Code

명령줄 매개 변수를 사용하여 Visual Studio를 설치하는 방법을 보여 주기 위해 사용자의 요구에 맞게 사용자 지정할 수 있는 몇 가지 예를 제공합니다.

각 예에서 vs_enterprise.exe, vs_professional.exevs_community.exe는 다운로드 프로세스를 시작하는 작은(1MB 이하) 파일인 Visual Studio 부트스트래퍼의 해당 버전을 나타냅니다. 다른 버전을 사용하는 경우에는 적절한 부트스트래퍼 이름으로 대체합니다.

모든 명령에는 관리자 권한 상승이 필요하며 상승된 프롬프트에서 프로세스가 시작되지 않는 경우 사용자 계정 컨트롤 프롬프트가 표시됩니다.

명령줄의 끝에 ^ 문자를 사용하여 여러 줄을 하나의 명령으로 연결할 수 있습니다. 또는 이러한 줄을 한꺼번에 단일 행에 배치할 수도 있습니다. PowerShell에서 일치하는 항목은 억음 악센트(`) 문자입니다.

명령줄을 사용하여 설치할 수 있는 워크로드 및 구성 요소 목록은 Visual Studio 워크로드 및 구성 요소 ID 페이지를 참조하세요.

--installPath를 사용하여 설치

  • 대화형 프롬프트 없이 진행률이 표시되는 Visual Studio의 최소 인스턴스를 설치합니다.

    vs_enterprise.exe --installPath C:\minVS ^
    --add Microsoft.VisualStudio.Workload.CoreEditor ^
    --passive --norestart
    
  • 제품을 설치해야만 반환되는 프랑스어 언어 팩을 포함한 Visual Studio의 데스크톱 인스턴스를 자동으로 설치합니다.

    vs_enterprise.exe --installPath C:\desktopVS ^
    --addProductLang fr-FR ^
    --add Microsoft.VisualStudio.Workload.ManagedDesktop ^
    --includeRecommended --quiet --wait
    

2단계로 진행되는 업데이트

  • 명령줄을 통해 Visual Studio 인스턴스를 업데이트합니다. 대화형 프롬프트는 표시되지 않고, 진행률은 표시됩니다. 부트스트래퍼가 클라이언트 컴퓨터에 있는 경우에는 클라이언트에서 이 명령을 실행할 수 있습니다. 그렇지 않은 경우에는 레이아웃에서 이 명령을 실행해야 합니다. 첫 번째 명령은 설치 관리자를 업데이트하고, 두 번째 명령은 Visual Studio 제품을 업데이트합니다.

    vs_enterprise.exe --update --quiet --wait
    vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
    

    참고

    첫 번째 명령은 Visual Studio 설치 관리자를 업데이트하고 두 번째 명령은 Visual Studio 제품 비트를 업데이트합니다. 두 명령을 순서대로 실행하고 완료하는 것이 좋습니다. [사용자 계정 컨트롤] 대화 상자를 사용하지 않으려면 명령 프롬프트를 관리자 권한으로 실행합니다.

--wait 사용

  • Visual Studio 설치 관리자가 완료될 때까지 기다린 후에 다음 명령이 실행되도록 배치 파일 또는 스크립트에서 --wait를 사용합니다. 일괄 처리 파일의 경우 명령줄 매개 변수를 사용하여 Visual Studio 설치 페이지에 나오는 대로 %ERRORLEVEL% 환경 변수가 명령의 반환 값을 포함합니다. 일부 명령 유틸리티는 추가 매개 변수가 있어야 완료될 때까지 기다리고 설치 관리자의 반환 값을 가져올 수 있습니다. 다음 명령은 PowerShell 스크립트 명령 ‘Start-Process’와 함께 사용되는 추가 매개 변수에 대한 예제입니다.

    start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
    echo %errorlevel%
    
    $process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
    Write-Output $process.ExitCode 
    

    or

      $startInfo = New-Object System.Diagnostics.ProcessStartInfo
      $startInfo.FileName = "vs_enterprise.exe"
      $startInfo.Arguments = "--all --quiet --wait"
      $process = New-Object System.Diagnostics.Process
      $process.StartInfo = $startInfo
      $process.Start()
      $process.WaitForExit()
    
  • 첫 번째 ‘--wait’는 Visual Studio 설치 관리자에서 사용되며, 두 번째 ‘-Wait’는 ‘Start-Process’에서 완료될 때까지 기다리는 데 사용됩니다. ‘-PassThru’ 매개 변수는 ‘Start-Process’에서 해당 반환 값의 설치 관리자 종료 코드를 사용하는 데 필요합니다.

--layout을 사용하여 네트워크 레이아웃 또는 로컬 캐시 만들기

  • Visual Studio 핵심 편집기(최소한의 Visual Studio 구성)와 영어 팩만 포함하는 레이아웃을 만듭니다.

    vs_professional.exe --layout C:\VS ^
    --lang en-US ^
    --add Microsoft.VisualStudio.Workload.CoreEditor
    
  • 권장되는 모든 구성 요소(영어만)와 함께 .NET 데스크톱 및 .NET 웹 워크로드를 포함하는 레이아웃을 만듭니다.

    vs_professional.exe --layout C:\VS ^
    --lang en-US ^
    --add Microsoft.VisualStudio.Workload.NetWeb ^
    --add Microsoft.VisualStudio.Workload.ManagedDesktop ^
    --includeRecommended
    
  • --config를 사용하여 레이아웃의 내용을 구성합니다.

    vs_enterprise.exe --layout C:\layout --config "C:\myconfig.vsconfig" --useLatestInstaller
    

--all을 사용하여 전체 제품 받기

  • Visual Studio Enterprise Edition에서 사용할 수 있는 모든 워크로드 및 구성 요소의 대화형 설치를 시작합니다.

    vs_enterprise.exe --all
    

--includeRecommended 사용

  • Node.js 개발 지원을 통해 Visual Studio Community 버전이 이미 설치된 컴퓨터에 별칭을 사용하여 Visual Studio Professional의 두 번째 인스턴스를 설치합니다.

    vs_professional.exe --installPath C:\VSforNode ^
    --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
    

--channelURI 사용

Visual Studio 2022 이상 설치 관리자를 사용하여 Visual Studio가 업데이트를 찾는 위치를 구성할 수 있습니다. --channelURI를 업데이트 채널 또는 업데이트의 원본 위치라고도 합니다. 다음 표에서는 channelId 및 channelURI에 대한 예제 값과 그 의미에 대해 설명합니다.

채널 이름 --channelURI --channelId
Visual Studio 2022 현재 채널 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Visual Studio 2022 17.0 LTSC 채널 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Visual Studio 2022 미리 보기 채널 https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Visual Studio 2019 릴리스 채널 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Visual Studio 2017 릴리스 채널 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
사용자 지정 레이아웃 - 비공개 채널 \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (또는 레이아웃의 기반이 무엇이든)

사용자 지정 레이아웃을 업데이트 채널로 사용하도록 선택하는 경우 다음 지침을 알고 있어야 합니다.

--remove 사용

  • 기본 설치된 Visual Studio 인스턴스에서 프로파일링 도구 구성 요소를 제거합니다.

    vs_enterprise.exe modify ^
    --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
    --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
    --passive
    

--removeOos 사용

참고

이 명령을 사용하려면 VS 2022 버전 17.4 이상 설치 관리자를 사용해야 합니다. 클라이언트 컴퓨터에 최신 설치 관리자를 가져오는 방법은 여기의 지침을 따르세요.

  • 설치를 수정하고 기본 설치된 Visual Studio 인스턴스에서 지원되지 않음 상태로 전환된 모든 구성 요소를 제거합니다.

    vs_enterprise.exe modify ^
    --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
    --removeOos true ^
    --passive
    
  • 업데이트 설정을 조정하여 제품이 업데이트될 때마다 지원되지 않음 상태로 전환된 모든 구성 요소를 영구적으로 제거합니다.

    vs_enterprise.exe modifySettings ^
    --channelURI https://aka.ms/vs/17/release.LTSC.17.0/channel ^
    --productID Microsoft.VisualStudio.Product.Enterprise ^
    --newChannelURI \\layoutserver\share\path\channelmanifest.json ^
    --removeOos true ^
    --quiet  
    

--path 사용

  • 설치, 캐시 및 공유 경로를 사용합니다.

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • 설치 및 캐시 경로만 사용합니다.

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • 설치 및 공유 경로만 사용합니다.

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • 설치 경로만 사용합니다.

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

내보내기 사용

  • 내보내기를 사용하여 설치에서 선택 항목을 저장합니다.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vs_installer.exe" export --installPath "C:\VS" --config "C:\.vsconfig"
    
  • 내보내기를 사용하여 사용자 지정 선택을 처음부터 저장합니다.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\vs_installer.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\.vsconfig"
    

--Config 사용

  • --config를 사용하여 이전에 저장된 설치 구성 파일에서 워크로드 및 구성 요소를 설치합니다.

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
    
  • --config를 사용하여 워크로드 및 구성 요소를 기존 설치에 추가합니다.

    vs_enterprise.exe modify --installPath "C:\VS" --config "C:\my.vsconfig"
    
  • --config를 사용하여 레이아웃의 내용을 구성합니다.

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig" --useLatestInstaller
    

winget 사용

Windows 패키지 관리자 "winget" 도구를 사용하여 winget에서 관리하는 다른 패키지와 함께 컴퓨터에 Visual Studio를 프로그래밍 방식으로 설치하거나 업데이트합니다. 설치를 사용자 지정하고 추가 워크로드 및 구성 요소를 지정하려면 winget의 명령과 함께 winget install--override 스위치를 사용하고 다음과 같이 내보낸 vsconfig 파일을 전달할 수 있습니다.

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

지원 또는 문제 해결

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

몇 가지 추가 지원 옵션은 다음과 같습니다.

  • 설치 관련 문제를 위한 설치 채팅(영어만 가능) 지원 옵션이 제공됩니다.
  • Visual Studio 설치 관리자와 Visual Studio IDE에 모두 표시되는 문제 보고 도구를 통해 Microsoft에 제품 문제를 보고합니다. IT 관리자이고 Visual Studio가 설치되어 있지 않은 경우 여기에서 IT 관리자 피드백을 제출할 수 있습니다.
  • Visual Studio 개발자 커뮤니티에서 기능을 제안하고, 제품 문제를 추적하고, 답변을 찾습니다.

참조