명령줄 매개 변수를 사용하여 Visual Studio 설치, 업데이트, 관리

프로그래밍 방식으로 또는 명령 프롬프트에서 Visual Studio를 설치할 때 여러 명령줄 매개 변수를 사용하여 설치가 다음 작업을 수행하도록 제어하거나 사용자 지정할 수 있습니다.

• 특정 옵션 및 동작이 미리 선택된 상태로 클라이언트에서 설치를 시작합니다.
• 설치 또는 업데이트 프로세스를 자동화합니다.
• 클라이언트 머신을 설치하거나 업데이트하기 위한 제품 파일의 네트워크 레이아웃을 만들거나 유지 관리합니다.

다음의 명령줄 동사 및 매개 변수는 다음에 나와있는 실행 파일 또는 프로그램과 함께 사용할 수 있습니다.

• 다운로드 프로세스와 초기 설치를 시작하는 작은(~1MB) 파일(예: vs_enterprise.exe)인 설치 부트스트래퍼입니다.
• 컴퓨터에 이미 설치되어 있고 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe 폴더에 있는 Visual Studio 설치 관리자입니다. 설치 관리자가 있는 다른 디렉터리에서 프로그래밍 방식으로 설치 관리자를 시작해야 합니다. 설치 관리자는 일반적으로 업데이트 또는 수정 명령에 사용됩니다.
• winget의 --override 스위치를 사용하는 winget 명령을 사용합니다.
• Microsoft 업데이트 카탈로그에서 다운로드할 수 있는 관리자 업데이트 패키지를 사용하면 네트워크 레이아웃을 프로그래밍 방식으로 업데이트할 수 있습니다. 자세한 정보는 레이아웃 업데이트 또는 수정 문서에서 확인할 수 있습니다.

이러한 각 상황에서는 모든 명령이나 매개 변수가 작동하지 않으며 특별한 주의 사항이나 예외가 문서화되어 있습니다. 또한 일부 시나리오에서는 이전에 설명한 모든 실행 파일에 대한 액세스 권한이 없을 수도 있습니다. 예를 들어, 클라이언트 컴퓨터에는 Visual Studio가 레이아웃을 통해 설치된 경우에만 프로그래밍 방식으로 실행할 수 있는 설치 관리자가 있을 수 있습니다.

설치, 업데이트, 수정, 복구, 제거, 내보내기 명령 및 명령줄 매개 변수

Visual Studio 부트스트래퍼 또는 설치 관리자를 프로그래밍 방식으로 호출하여 제품을 설치하거나 레이아웃을 유지 관리하는 경우

• 첫 번째 매개 변수는 수행할 오퍼레이션을 설명하는 명령(동사)입니다.
• 모두 두 개의 대시(--)로 접두사가 지정된 후속 선택적 명령줄 매개 변수는 해당 오퍼레이션이 수행되는 방식을 추가로 정의합니다.

모든 Visual Studio 명령줄 매개 변수는 대/소문자를 구분하지 않으며, 명령줄 매개 변수 예제 페이지에서 추가 예제를 확인할 수 있습니다.

구문 예제: vs_enterprise.exe [command] <optional parameters>...

레이아웃 명령 및 명령줄 매개 변수

레이아웃 만들기나 업데이트처럼 모든 레이아웃 관리 오퍼레이션에서는 부트스트래퍼 exe를 사용하여 실행되며 명령이 기본 설치(비어 있음)라고 가정합니다. 모든 레이아웃 관리 오퍼레이션은 --layout 초기 필수 매개 변수와 함께 시작해야 합니다. 다음 표에는 명령줄을 사용하여 레이아웃을 만들거나 업데이트하는 데 사용할 수 있는 그 밖의 매개 변수가 설명되어 있습니다.

ModifySettings 명령 및 명령줄 매개 변수

클라이언트 컴퓨터의 설치 관리자 또는 부트스트래퍼를 사용하고 modifySettings 명령 및 원하는 업데이트 채널을 전달하여 업데이트 설정을 수정하고 Visual Studio의 지정된 인스턴스에 대한 업데이트 원본 위치를 프로그래밍 방식으로 구성할 수 있습니다.

구문 예제:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\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

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

관리자 업데이트 명령 및 명령줄 매개 변수

Microsoft 업데이트 카탈로그에서 관리자 업데이트를 다운로드하여 클라이언트 설치 또는 레이아웃을 업데이트하는 데 사용할 수 있습니다.

레이아웃 업데이트

레이아웃을 특정 버전의 Visual Studio로 업데이트하는 경우 레이아웃을 호스팅하는 컴퓨터에 관리자 업데이트를 다운로드하고 해당 컴퓨터에서 명령 프롬프트를 열고 다음과 같은 명령을 실행하면 됩니다.

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

클라이언트 업데이트

클라이언트에서 클라이언트 머신의 설치 디렉터리로 관리자 업데이트를 다운로드하는 경우 해당 파일을 두 번 클릭하기만 하면 업데이트가 적용됩니다. 명령 창을 열고 아래의 몇 가지 매개 변수를 전달하여 기본 동작을 변경할 수도 있습니다.

SCCM에서 관리자 업데이트 구성

Microsoft Endpoint Manager(SCCM)를 통해 관리자 업데이트를 배포하는 경우 아래 매개 변수를 사용하여 동작을 조정하도록 패키지를 수정할 수 있습니다. 클라이언트 머신의 구성 파일을 통해 매개 변수를 제어할 수도 있습니다. 자세한 내용은 관리자 업데이트를 구성하는 방법을 참조하세요.

레이아웃 동사가 지정되지 않는 한 모든 관리자 업데이트 매개 변수는 기본적으로 “update” 컨텍스트에서 실행됩니다.

매개 변수를 관리자 업데이트에 전달하는 구문 예제:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

채널 제거 명령 및 명령줄 매개 변수

업데이트할 수 있는 채널은 클라이언트에 캐시되어 시간이 지남에 따라 복잡해질 수 있습니다. Visual Studio 설치 관리자를 가져오고, 사용 가능 탭으로 전환하고, 제품 카드의 오른쪽 위 모서리에 있는 X를 클릭하여 수동으로 업데이트 채널을 제거할 수 있습니다. removeChannel 명령을 사용하여 프로그래밍 방식으로 채널(예: 이전 레이아웃 위치)을 제거할 수 있습니다. 클라이언트 컴퓨터에서 프로그래밍 방식으로 vswhere를 실행하여 클라이언트 컴퓨터에 캐시되는 채널을 확인할 수 있습니다.

구문 예제:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

winget을 사용하여 Visual Studio 설치 또는 수정

이 Windows 패키지 관리자 "winget" 도구를 사용하여 winget에서 관리하는 다른 패키지와 함께 컴퓨터에 Visual Studio를 프로그래밍 방식으로 설치, 수정하거나 업데이트할 수 있습니다.

기본적으로 winget은 Visual Studio 코어 워크로드만 설치합니다.

winget install --id Microsoft.VisualStudio.2022.Community

그러나 설치를 사용자 지정하고 초기 설치 중에 획득할 추가 워크로드 및 구성 요소를 지정하려는 경우 Winget의 --override 명령과 함께 Winget의 install 스위치를 사용하고 추가할 워크로드 및 구성 요소가 포함된 내보낸 vsconfig 파일을 전달할 수 있습니다.

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

물론 다음과 같이 초기 설치 중에 구성 요소를 직접 포함할 수도 있습니다.

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

컴퓨터에 이미 Visual Studio가 설치되어 있는 경우 configure, yaml 파일 및 .vsconfig 파일과 함께 Winget의 명령을 사용하여 기존 Visual Studio 설치에 구성 요소를 추가할 수 있습니다. Winget의 configure 명령은 기본적으로 Visual Studio "수정" 작업 역할을 합니다. WinGet 구성 파일을 작성하여 winget 구성을 만드는 방법을 알아봅니다.

--override 스위치나 Visual Studio DSC 공급자를 Winget의 upgrade 명령과 함께 사용할 수 없습니다. upgrade는 기본적으로 Visual Studio "업데이트" 작업 역할을 하고 이미 선택한 구성 요소의 최신 버전을 설치하기 때문입니다. 업데이트/업그레이드를 통해 구성 요소를 추가할 수 없습니다. winget의 configure를 사용하여 구성 요소를 추가해야 합니다.

Visual Studio 설치 관리자 작업에는 현재 관리자 권한이 필요하므로 winget은 명령을 완료하는 데 필요한 경우 권한을 상승하라는 메시지를 표시합니다. 또한 현재 winget을 사용하여 여러 버전(즉, 다른 SKU) 또는 동일한 SKU의 여러 인스턴스를 클라이언트 컴퓨터에 동시에 설치할 수 없습니다. 마지막으로 구성 요소를 추가하거나 최신 버전으로 업그레이드하도록 구성(수정)하려는 경우 Visual Studio를 닫아야 합니다.

작업 ID 및 구성 요소 ID 목록

Visual Studio 제품별로 정렬된 워크로드 및 구성 요소 ID 목록은 Visual Studio 워크로드 및 구성 요소 ID 페이지를 참조하세요.

언어 로캘 목록

오류 코드

작업 결과에 따라 %ERRORLEVEL% 환경 변수는 다음 값 중 하나로 설정됩니다.

각 작업은 %TEMP% 디렉터리에 설치 진행률을 나타내는 여러 로그 파일을 생성합니다. 폴더를 날짜별로 정렬하고 부트스트래퍼, 설치 관리자 앱 및 설치 엔진 각각에 대해 dd_bootstrapper, dd_client 및 dd_setup으로 시작하는 파일을 찾습니다.

지원 또는 문제 해결

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

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

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

관련 콘텐츠

• Visual Studio 설치에 대한 명령줄 매개 변수 예
• Visual Studio의 오프라인 설치 만들기
• 지시 파일을 사용하여 Visual Studio 설치 자동화
• Visual Studio 작업 및 구성 요소 ID