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사용하여 다음 명령이 실행되기 전에 초기 명령이 완료될 때까지 기다립니다. 일괄 처리 파일의 경우%ERRORLEVEL%환경 변수는 명령줄 매개 변수를 사용하여 Visual Studio 페이지를 설치하는 데 설명된 대로 명령의 반환 값을 포함합니다. 일부 명령 유틸리티는 완료될 때까지 기다렸다가 설치 관리자의 반환 값을 가져오기 위해 다른 매개 변수가 필요합니다.
--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()
- 첫 번째
--waitVisual 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 버전에서 사용할 수 있는 모든 워크로드 및 구성 요소의 대화형 설치를 시작합니다.
vs_enterprise.exe --all
--includeRecommended 옵션 사용
visual Studio Community 버전이 이미 설치된 컴퓨터에 애칭을 사용하여 Visual Studio Professional의 두 번째 인스턴스를 설치하고 Node.js 개발을 지원합니다.
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
--remove동일한 명령에서는 --layout 사용할 수 없습니다. 즉, 레이아웃에서 구성 요소를 제거할 수 없습니다.
--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의 --override 명령과 함께 winget의 install 스위치를 사용하고 다음과 같은 내보낸 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 모두에 표시되는 문제 보고 도구를 사용하여 제품 문제를 보고합니다. IT 관리자이고 Visual Studio가 설치되어 있지 않은 경우 IT 관리자 피드백을 제출할 수 있습니다.
- 기능을 제안하고, 제품 문제를 추적하고, Visual Studio 개발자 커뮤니티답변을 찾습니다.
관련 콘텐츠
- Visual Studio 관리자 가이드
- 명령줄 매개 변수를 사용하여 Visual Studio 설치
- Visual Studio 네트워크 설치 만들기
- Visual Studio 워크로드 및 구성 요소 ID