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

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

각 예제에서 vs_enterprise.exe, vs_professional.exe, 및 vs_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
  

엽데이트

• 명령줄을 통해 Visual Studio 인스턴스를 업데이트합니다. 대화형 프롬프트가 표시되지 않고, 진행률이 표시됩니다. 클라이언트 또는 레이아웃에서 찾은 부트스트래퍼를 사용하여 두 단계로 이러한 일련의 명령을 실행할 수 있습니다. 첫 번째 명령은 클라이언트에 설치 관리자를 업데이트하고, 두 번째 명령은 Visual Studio 제품을 업데이트합니다. 설치 관리자를 업데이트하려면 관리자 권한이 필요하므로 관리자 권한 명령 프롬프트에서 이러한 명령을 실행해야 합니다. 다음 예제에서는 레이아웃에서 상록 부트스트래퍼를 사용하여 클라이언트 업데이트를 시뮬레이트합니다.

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

또는 클라이언트의 설치 관리자를 사용하여 한 단계에서 Visual Studio 인스턴스를 업데이트할 수도 있습니다. 표준 사용자에게 적절한 권한이 부여된 경우 설치 관리자를 사용하여 업데이트 명령을 프로그래밍 방식으로 실행할 수 있지만 사용 --passive 하거나 --quiet 전환할 수는 없습니다. 설치 관리자가 있는 이 동일한 디렉터리에서 프로그래밍 방식으로 설치 관리자를 시작할 수 없습니다.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

--wait 사용

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

매개 --wait 변수는 부트스트래퍼에서만 지원됩니다.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

다음 명령은 PowerShell 스크립트 명령 --wait 과 함께 사용하는 Start-Process예제입니다.

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode 

또는

 $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 구성)와 영어 팩만 포함하는 레이아웃을 만듭니다. Visual Studio의 네트워크 설치 만들기 페이지에서 더 많은 레이아웃 만들기 예제를 찾을 수 있습니다.

  vs_professional.exe --layout "C:\VS" ^
  --lang en-US ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  

--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가 업데이트를 찾는 위치를 구성할 수 있습니다. --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 (또는 레이아웃의 기반이 무엇이든)

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

• 이 --channelUri 는 사용자 지정 레이아웃의 'channelmanifest.json' 파일을 가리켜야 합니다.
• 관리자는 클라이언트의 레지스트리 설정을 구성하여 업데이트 설정 UI에 사용자 지정 레이아웃 "프라이빗 채널"이 표시되는 방식을 구성할 수 있습니다.

--remove 사용

• 기본 설치된 Visual Studio 인스턴스에서 프로파일링 도구 구성 요소를 제거합니다. 이 예제에서는 클라이언트 컴퓨터에 이미 설치된 설치 관리자를 사용합니다. 적절한 권한을 갖고 있는 표준 사용자는 설치 관리자를 사용하여 수정 명령을 프로그래밍 방식으로 실행할 수 있지만 사용하거나 --passive 전환할 --quiet 수는 없습니다. 설치 관리자가 있는 이 동일한 디렉터리에서 프로그래밍 방식으로 설치 관리자를 시작할 수 없습니다.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
  --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
  --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
  --passive
  

이 --layout와 동일한 명령에서는 --remove 사용할 수 없습니다. 다른 말로 하면, 레이아웃에서 구성 요소를 제거할 수 없습니다.

--removeOos 사용

이 최신 설치 관리자를 사용하여 설치를 수정하고 기본 설치된 Visual Studio 인스턴스에서 지원되지 않음 상태로 전환된 모든 구성 요소를 제거합니다. 이 예제에서는 클라이언트 컴퓨터에 이미 설치된 설치 관리자를 사용하여 removeOos 설정을 구성합니다. 표준 사용자에게 적절한 권한이 부여된 경우 설치 관리자를 사용하여 수정 명령을 프로그래밍 방식으로 실행할 수 있지만 사용 --passive 하거나 --quiet 전환할 수는 없습니다. 설치 관리자가 있는 동일한 디렉토리에서 프로그래밍 방식으로 설치 관리자를 시작할 수 없습니다.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

• 업데이트 설정을 조정하여 제품이 업데이트될 때마다 지원되지 않음 상태로 전환된 모든 구성 요소를 영구적으로 제거합니다.

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --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\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
  

• 내보내기를 사용하여 사용자 지정 선택 사항을 처음부터 저장합니다. 이 예제에서는 클라이언트 컴퓨터에 이미 설치된 설치 관리자를 사용합니다.

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

--Config 사용

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

  vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
  

• --config를 사용하여 기존 설치에 워크로드 및 구성 요소를 추가합니다. 이 예제에서는 클라이언트 컴퓨터에 이미 설치된 설치 관리자를 사용합니다. 적절한 권한을 갖고 있는 표준 사용자는 설치 관리자를 사용하여 수정 명령을 프로그래밍 방식으로 실행할 수 있지만 사용하거나 --passive 전환할 --quiet 수는 없습니다. 설치 관리자가 있는 동일한 디렉토리에서 프로그래밍 방식으로 설치 관리자를 시작할 수 없습니다.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
  

• --config를 사용하여 레이아웃의 내용을 구성합니다.

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

winget 사용

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

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

파일을 사용하고 winget configure 전달 .yaml 하여 기존 Visual Studio 설치를 수정할 수도 있습니다. 이 방법은 여기에 설명된Visual Studio PowerShell DSC 공급자를 사용합니다.

지원 또는 문제 해결

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

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

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

관련 콘텐츠

• Visual Studio 관리자 가이드
• 명령줄 매개 변수를 사용하여 Visual Studio 설치
• Visual Studio의 네트워크 설치 만들기
• Visual Studio 작업 및 구성 요소 ID