명령줄 매개 변수를 사용하여 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 2019 부트스트래퍼를 가져올 수 있습니다. 또는 특정 버전의 Visual Studio 2019를 원하는 경우 Visual Studio 2019 릴리스 페이지를 참조하세요. 이 페이지에는 선택한 Visual Studio 버전 및 버전의 고정 버전 부트스트래퍼에 대한 링크가 있습니다.
| 에디션 | 부트스트래퍼 |
|---|---|
| Visual Studio 2019 Enterprise 버전 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional 버전 16.11 | vs_professional.exe |
| Visual Studio 2019 빌드 도구 버전 16.11 | vs_buildtools.exe |
항상 최신 버전의 현재 채널을 설치하는 Visual Studio 2022용 최신 부트스트래퍼를 얻으려면 다음 표의 파일 중 하나를 다운로드합니다. 또는 Visual Studio 2022의 특정 버전 또는 특정 채널을 설치하려면 Visual Studio 2022 릴리스 기록 페이지를 참조하세요. 이 페이지에는 각 서비스 릴리스에 대한 고정 버전 부트스트래퍼에 대한 링크가 있습니다.
| 에디션 | 부트스트래퍼 |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Visual Studio 2022 커뮤니티 | vs_community.exe |
| Visual Studio 2022 빌드 도구 | vs_buildtools.exe |
팁
이전에 부트스트래퍼 파일을 다운로드하고 해당 버전을 확인하려는 경우 방법은 다음과 같습니다. Windows에서 파일 탐색기를 열고 부트스트래퍼 파일을 마우스 오른쪽 단추로 클릭하고 속성선택하고 세부 정보 탭을 선택한 다음 제품 버전 번호를 봅니다. 해당 숫자를 Visual Studio 릴리스와 일치하려면 Visual Studio 2019 릴리스 페이지의 맨 아래에 있는 표를 참조하세요.
팁
이전에 부트스트래퍼 파일을 다운로드하고 설치할 버전을 확인하려는 경우 방법은 다음과 같습니다. Windows에서 파일 탐색기를 열고 부트스트래퍼 파일을 마우스 오른쪽 단추로 클릭하고 속성 선택한 다음 세부 정보 탭을 선택합니다. 제품 버전 필드는 부트스트래퍼가 설치할 채널 및 버전 설명합니다. 버전 번호는 항상 "지정된 항목의 최신 서비스 버전"으로 읽혀야 하며 명시적으로 지정하지 않는 한 채널은 Current입니다. 따라서 제품 버전이 LTSC 17.0인 부트스트래퍼는 17.0 LTSC 채널에서 사용할 수 있는 최신 17.0.x 서비스 릴리스를 설치합니다. 최신 Visual Studio 2022를 현재 채널에 설치하기 위해, 제품 버전이 "Visual Studio 2022"로 명시된 부트스트래퍼입니다.
설치, 업데이트, 수정, 복구, 제거 및 내보내기 명령 및 명령줄 매개 변수
Visual Studio 부트스트래퍼 또는 설치 관리자를 프로그래밍 방식으로 호출하여 제품을 설치하거나 레이아웃을 유지 관리하는 경우:
- 첫 번째 매개 변수는 수행할 작업을 설명하는 명령(동사)입니다.
- 두 개의 대시(--)가 접두사로 추가된 후속 선택적 명령줄 매개 변수는 해당 작업이 수행되는 방식을 추가로 정의합니다.
모든 Visual Studio 명령줄 매개 변수는 대/소문자를 구분하지 않으며 명령줄 매개 변수 예제 페이지에서 더 많은 예제를 찾을 수 있습니다.
구문 예제: vs_enterprise.exe [command] <optional parameters>...
| 명령 | 설명 |
|---|---|
| (공백) | 기본 명령은 둘 다 제품을 설치하며 모든 레이아웃 유지 관리 작업에 사용됩니다. |
modify |
설치된 제품을 수정합니다. |
update |
설치된 제품을 업데이트합니다. |
updateall |
설치된 모든 제품을 순차적으로 업데이트합니다.
--quiet 및 --passive 매개 변수와 함께 작동합니다. |
repair |
설치된 제품을 복구합니다. |
uninstall |
설치된 제품을 제거합니다. |
export |
설치 구성을 *.vsconfig 파일로 내보냅니다. |
중요하다
여러 고유 워크로드 또는 구성 요소 또는 언어를 지정할 때 각 항목에 대해 --add 또는 --remove 명령줄 스위치를 반복해야 합니다.
| 매개 변수 | 설명 |
|---|---|
--installPath <dir> |
기본 설치 명령의 경우 이 매개 변수는 선택적 클라이언트 컴퓨터에 인스턴스가 설치되는 위치를 설명합니다. 업데이트 또는 수정과 같은 다른 명령의 경우 이 매개 변수는 필수 인스턴스의 설치 디렉터리를 나타냅니다. |
--productId <id> |
선택적: 수정되고 --channelId와 함께 사용되는 제품 인스턴스의 ID입니다.
productID "Microsoft.VisualStudio.Product.Enterprise"와 같습니다. |
--channelUri |
선택적: 업데이트 명령 중에 새 --channelUri 전달하여 업데이트 설정 위치를 변경할 수 있습니다. 구성 중인 Visual Studio 인스턴스가 명시적이 되도록 --installPath 매개 변수와 페어링하는 것이 좋습니다.
구문 예제를 --channelUri 참조하세요. |
--channelId <id> |
채널의 ID(예: VisualStudio.17.Release)입니다.
구문 예제를 --channelId에서 참조하세요.
channelId
--productID 또는 --installPath함께 작업을 수정하는 데 필요합니다. |
--add <one or more workload or component IDs> |
선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 추가할 하나 이상의 워크로드 또는 구성 요소 ID를 지정합니다. 아티팩트에서 필요한 구성 요소가 설치되어 있지만 권장 구성 요소나 선택적 구성 요소는 설치되지 않습니다.
--includeRecommended 및/또는 --includeOptional 매개 변수를 사용하여 다른 구성 요소를 전역적으로 제어할 수 있습니다. 여러 워크로드 또는 구성 요소를 포함하려면 --add 명령(예: --add Workload1 --add Workload2)을 반복합니다. 세분화된 컨트롤의 경우 ID(예: ;includeRecommended 또는 ;includeOptional)에 --add Workload1;includeRecommended 또는 --add Workload2;includeRecommended;includeOptional 추가할 수 있습니다. 자세한 내용은 워크로드 및 구성 요소 ID 페이지를 참조하세요. |
--all |
선택적: 설치 또는 수정 명령 중에 이 매개 변수를 사용하면 제품의 모든 워크로드 및 구성 요소가 설치됩니다. |
--allWorkloads |
선택적: 설치 또는 수정 명령 중에 이 매개 변수는 모든 워크로드 및 구성 요소를 설치하지만 권장 구성 요소나 선택적 구성 요소는 설치하지 않습니다. |
--includeRecommended |
선택적: 설치 또는 수정 명령 중에 이 매개 변수에는 설치된 모든 워크로드에 대한 권장 구성 요소가 포함됩니다. 선택적 구성 요소는 포함되지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다.
--includeRecommended 매개 변수를 사용하면 업데이트 설정 대화 상자를 사용하도록 설정하여 "업데이트 시 설치된 워크로드에 권장되는 구성 요소를 추가"할 수 있습니다. 이 설정을 변경하려면 업데이트 설정 사용자 지정 참조하세요. |
--includeOptional |
선택적: 설치 또는 수정 명령 중에 이 매개 변수에는 설치된 모든 워크로드에 대한 선택적 구성 요소가 포함됩니다. 권장 구성 요소는 포함되지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다. |
--addProductLang <language-locale> |
선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 제품과 함께 설치해야 하는 UI 언어 팩을 지정합니다. 설치가 없으면 컴퓨터 로캘에 해당하는 언어 팩을 사용합니다. 자세한 내용은 [언어 로캘 목록]을 참조하세요. |
--remove <one or more workload or component IDs> |
선택적: 수정 명령 중에 이 반복 가능한 매개 변수는 제거할 하나 이상의 워크로드 또는 구성 요소 ID를 지정합니다.
--add 매개 변수와 비슷하게 보완하고 동작합니다. |
| 이 페이지의 (#list-of-language-locales) 섹션입니다. | |
--removeProductLang <language-locale> |
선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 제품에서 제거해야 하는 UI 언어 팩을 결정합니다.
--addProductLang 매개 변수와 비슷하게 보완하고 동작합니다. |
--in <path> |
선택적: 구성 설정을 포함할 수 있는 응답 파일대한 URI 또는 경로입니다. |
--quiet |
선택적: 명령과 함께 사용되며, 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다. AllowStandardUserControl 정책 설정 방법에 관계없이 표준 사용자가 프로그래밍 방식으로 사용할 수 없습니다. |
--passive, -p |
선택적: 이 매개 변수를 사용하면 사용자 인터페이스가 비대화형 방식으로 표시됩니다. 이 매개 변수는 --quiet 매개 변수와 서로 배타적이며, 실제로 이를 무효화합니다. 또한 AllowStandardUserControl 정책 설정 방법에 관계없이 표준 사용자가 프로그래밍 방식으로 사용할 수 없습니다. |
--norestart |
선택적: 이 매개 변수는 --passive 또는 --quiet 매개 변수와 쌍으로 사용해야 합니다. 설치, 업데이트 또는 수정 명령을 실행하는 동안 --norestart 매개 변수를 추가하면 필요한 재부팅이 지연됩니다. |
--force |
선택적: 이 매개 변수는 Visual Studio 프로세스가 사용 중인 경우에도 Visual Studio를 강제로 닫습니다. Visual Studio를 강제로 닫으면 작업 손실이 발생할 수 있으므로 주의해서 사용합니다. |
--installWhileDownloading |
선택적: 설치, 업데이트 또는 수정 명령 중에 이 매개 변수를 사용하면 Visual Studio에서 제품을 병렬로 다운로드하고 설치할 수 있습니다. 기본 환경입니다. |
--downloadThenInstall |
선택적: 설치, 업데이트 또는 수정 명령을 실행하는 동안 이 매개 변수는 Visual Studio에서 파일을 설치하기 전에 모든 파일을 다운로드하도록 합니다.
--installWhileDownloading 매개 변수에서 상호 배타적입니다. |
--nickname <name> |
선택적: 설치 명령 중에 이 매개 변수는 설치된 제품에 할당할 애칭을 정의합니다. 애칭은 10자를 초과할 수 없습니다. |
--productKey |
선택적: 설치 명령 중에 이 매개 변수는 설치된 제품에 사용할 제품 키를 정의합니다. 제품 키는 xxxxxxxxxxxxxxxxxxxxxxxxx형식으로 25자의 영숫자로 구성됩니다. |
--removeOos true |
선택적: 설치, 업데이트 또는 수정 명령 중에, 이 매개 변수가 true 또는 false와 함께 제공되면 Visual Studio 설치 관리자에게 지원되지 않는 상태로 전환된 모든 설치된 구성 요소를 제거해야 하는지를 지시합니다. 이 동작은 단일 이벤트에 적용할 수 있습니다. 이 동작을 영구화하려면, 나중에 설명할 modifySettings 명령에 이 매개변수를 적용하거나, removeOOS 전역 정책을 과 함께 구성하십시오. 컴퓨터를 안전하게 유지하는 데 유용합니다. |
--config <path to *.vsconfig file> |
선택적: 설치 또는 수정 작업 중에 --config 매개 변수를 사용하여 구성 파일을 전달하여 이전에 저장된 설치 구성 파일을 기반으로 추가할 워크로드, 구성 요소 또는 확장을 지정할 수 있습니다. 이 작업은 가산적일 뿐입니다. 파일에 지정되지 않은 항목은 제거하지 않습니다. 또한 제품에 적용되지 않는 구성 파일에 지정된 항목은 추가되지 않습니다. 구성 파일의 정규화된 경로를 지정하는 것이 좋습니다. 내보내기 작업 중에 이 매개 변수는 설치 구성 파일을 저장할 위치를 결정합니다. |
--allowUnsignedExtensions |
선택적: 설치 또는 수정 작업이 --passive 파일을 사용하여 --quiet 또는 --config 컨텍스트에서 실행되는 동안 구성 파일에 확장이 지정된 경우 디지털 서명 없이 확장을 로드하기 위해 이 매개 변수가 필요합니다. |
--installerOnly |
선택적: 설치 또는 업데이트 작업 중에 이 매개 변수는 Visual Studio 설치 관리자에게 Visual Studio 제품이 아닌 자체(설치 관리자)만 설치하도록 지시합니다. 해당 기능은 --update 매개 변수와 동일하지만 더 직관적입니다. 클라이언트 머신을 준비하고 미리 구성할 때 사용됩니다. |
--help, --?, -h, -? |
이 페이지의 오프라인 버전을 표시합니다. |
레이아웃 명령 및 명령줄 매개 변수
레이아웃 만들기 또는 업데이트와 같은 모든 레이아웃 관리 작업은 부트스트래퍼 exe를 사용하여 실행되며 명령이 기본 설치(비어 있음)라고 가정합니다. 모든 레이아웃 관리 작업은 필요한 --layout 초기 매개 변수로 시작해야 합니다. 다음 표에서는 명령줄을 사용하여 레이아웃 만들거나 업데이트하는 사용할 수 있는 다른 매개 변수에 대해 설명합니다.
| 레이아웃 매개 변수 | 설명 |
|---|---|
--layout <dir> |
오프라인 설치 캐시를 만들거나 업데이트할 디렉터리를 지정합니다. 자세한 내용은 Visual Studio네트워크 기반 설치 만들기를 참조하세요. |
--lang <one or more language-locales> |
선택적: 지정된 언어를 하나 이상 사용하여 리소스 패키지가 있는 오프라인 설치 캐시를 준비하기 위해 --layout 함께 사용됩니다. 자세한 내용은 이 페이지의 언어 로캘 섹션을 참조하세요. |
--add <one or more workload or component IDs> |
선택적: 추가할 하나 이상의 워크로드 또는 구성 요소 ID입니다. 아티팩트에서 필요한 구성 요소가 설치되어 있지만 권장 구성 요소나 선택적 구성 요소는 설치되지 않습니다.
--includeRecommended 및/또는 --includeOptional사용하여 전역적으로 더 많은 구성 요소를 제어할 수 있습니다. 세분화된 컨트롤의 경우 ID(예: ;includeRecommended 또는 ;includeOptional)에 --add Workload1;includeRecommended 또는 --add Workload2;includeOptional 추가할 수 있습니다. 자세한 내용은 워크로드 및 구성 요소 ID 페이지를 참조하세요. 참고: --add 사용하는 경우 지정된 워크로드 및 구성 요소 및 해당 종속성만 다운로드됩니다.
--add 지정되지 않으면 모든 워크로드 및 구성 요소가 레이아웃에 다운로드됩니다. |
--includeRecommended |
선택적: 설치된 워크로드에 권장되는 구성 요소를 포함하지만 선택적 구성 요소는 포함하지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다. |
--includeOptional |
선택적: 레이아웃에 포함되는 모든 워크로드에 대해 권장되는 및 선택적 구성 요소를 포함합니다. 워크로드가 --add으로 특정됩니다. |
--wait |
선택적: 프로세스는 종료 코드를 반환하기 전에 설치가 완료될 때까지 기다립니다.
wait 설치가 완료되어 해당 설치의 반환 코드를 처리할 때까지 기다려야 하는 설치를 자동화할 때 유용합니다.
--wait 매개 변수는 부트스트래퍼에만 전달될 수 있습니다. 설치 관리자(setup.exe)는 이를 지원하지 않습니다. 레이아웃을 업데이트할 때 유용합니다.
에서더 많은 예제를 찾을 수 있습니다. |
--useLatestInstaller |
선택적: 2023년 4월 이전의 Visual Studio 부트스트래퍼에만 적용되는 레거시 기능입니다. 2023년 4월 이후에 제공된 모든 항목은 기본적으로 최신 설치 관리자를 사용합니다. 이 매개 변수가 있는 경우 최신 버전의 제품에 속하는 경우에도 Visual Studio 설치 관리자의 최신 버전이 레이아웃에 포함됩니다. 최신 버전에서 사용할 수 있는 새로운 기능 또는 버그 수정을 활용하려는 경우 최신 설치 관리자가 유용할 수 있습니다. 자세한 내용은 항상 최신 설치 관리자 설명서를 사용하도록 레이아웃 구성 참조하세요. |
--config <path to *.vsconfig file> |
선택적: 있는 경우 Visual Studio는 구성 파일 콘텐츠를 사용하여 레이아웃을 구성합니다. 구성 파일의 정규화된 경로를 지정해야 합니다. |
--noWeb |
선택적: 있는 경우 Visual Studio 설정은 레이아웃 디렉터리의 파일을 사용하여 Visual Studio를 설치하며 웹에서 패키지를 다운로드하지 않습니다. 사용자가 레이아웃에 없는 구성 요소를 설치하려고 하면 설치가 실패합니다. 내부 인트라넷 웹 사이트에서 호스트되는 레이아웃을 배포하려는 경우 이 매개 변수를 사용하지 마세요. 자세한 내용은 인터넷 액세스 없는 클라이언트에설치를 참조하세요. 중요: --noWeb 매개 변수는 클라이언트가 Microsoft 호스트된 서버에서 업데이트를 확인하도록 구성된 경우 인터넷에 연결된 클라이언트 컴퓨터의 Visual Studio 설치 관리자가 업데이트를 확인하는 것을 중지하지 않습니다. 이 경우 --noWeb 클라이언트가 제품 패키지를 다운로드하지 못하게 합니다. |
--verify |
선택적: 레이아웃의 내용을 확인합니다. 손상되었거나 누락된 모든 파일이 나열됩니다. |
--fix |
선택적: 레이아웃의 내용을 확인합니다. 파일이 손상되었거나 누락된 경우 다시 로드됩니다. 레이아웃을 수정하려면 인터넷 액세스가 필요합니다. |
--clean <one or more paths to catalogs> |
선택적: 최신 버전으로 업데이트된 레이아웃에서 이전 버전의 구성 요소를 제거합니다. |
| 고급 레이아웃 매개 변수 | 설명 |
|---|---|
--channelId <id> |
선택적: 설치할 인스턴스에 대한 채널의 ID로, VisualStudio.17.Release같이 표시됩니다. channelId는 설치 명령에 필요하며 --installPath 지정된 경우 다른 명령에 대해서는 무시됩니다.
구문의 --channelId예제를 참조하세요. |
--channelUri <uri> |
선택적: 채널 매니페스트의 URI입니다. 이 값은 업데이트 의 원본 위치를 관리하며, 초기 설정 값은 레이아웃의 response.json 파일 에으로 구성됩니다. 가능한 값은 --channelUri 구문 예제를 참조하세요. 업데이트를 원하지 않는 경우 --channelUri 존재하지 않는 파일(예: --channelUri C:\doesntExist.chman)을 가리킬 수 있습니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다. |
--installChannelUri <uri> |
선택적: 설치에 사용할 채널 매니페스트의 URI입니다.
--channelUri으로 지정된 URI는 --installChannelUri이 지정될 때 반드시 지정되어야 하며, 이 URI는 업데이트를 감지하는 데 사용됩니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다. |
--installCatalogUri <uri> |
선택적: 설치에 사용할 카탈로그 매니페스트의 URI입니다. 지정된 경우 채널 관리자는 설치 채널 매니페스트에서 URI를 사용하기 전에 이 URI에서 카탈로그 매니페스트를 다운로드하려고 시도합니다. 이 매개 변수는 레이아웃 캐시가 이미 다운로드된 제품 카탈로그를 사용하여 만들어진 오프라인 설치를 지원하는 데 사용됩니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다. |
--productId <id> |
선택적: 설치된 인스턴스에 대한 제품의 ID입니다. 이 매개 변수는 일반 설치 조건에서 미리 채워집니다.
productID "Microsoft.VisualStudio.Product.Enterprise"와 같습니다. |
--arch all |
선택적: 기본적으로 레이아웃은 x64 제품 이진 파일만 사용하여 만들어집니다. 레이아웃에 x64 이진 파일과 함께 적용 가능한 워크로드에 대한 ARM 이진 파일을 포함하려면 --arch all 또는 --arch * 매개 변수를 사용합니다. ARM 바이너리 파일만의 레이아웃을 만들기 위해 --arch arm64 사용 |
--keepLayoutVersion |
선택적: 레이아웃에 포함된 제품 버전을 업데이트하지 않고 레이아웃에 변경 내용을 적용합니다. |
--locale <language-locale> |
선택적: 설치 관리자 자체에 대한 사용자 인터페이스의 표시 언어를 변경합니다. 설정은 유지됩니다. 자세한 내용은 이 페이지의 언어 로캘 섹션을 참조하세요. |
--cache |
선택적: 존재하는 경우, 패키지는 설치된 후에도 후속 수리를 위해 보관됩니다. 이는 후속 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다. 기본 정책은 패키지를 캐시하는 것입니다. 제거 명령에 대해서는 무시됩니다. 자세한 내용은 패키지 캐시 사용하지 않도록 설정하거나 이동하는 방법을 읽어보세요. |
--nocache |
선택적: 있는 경우 패키지를 설치하거나 복구한 후 삭제됩니다. 필요한 경우에만 다시 다운로드되고 사용 후 다시 삭제됩니다. 이는 후속 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다. 기본 정책은 패키지를 캐시하는 것입니다. 제거 명령에 대해서는 무시됩니다. 자세한 내용은 패키지 캐시 사용하지 않도록 설정하거나 이동하는 방법을 읽어보세요. |
--noUpdateInstaller |
선택적: 있는 경우 조용한 모드가 지정될 때 설치 관리자가 자체적으로 업데이트되지 않도록 합니다. 설치 관리자 업데이트가 필요할 때 noUpdateInstaller를 quiet로 지정하면 설치 관리자가 명령에 실패하고 0이 아닌 종료 코드를 반환합니다. |
--path <name>=<path> |
선택적: 설치에 대한 사용자 지정 설치 경로를 지정하는 데 사용됩니다. 지원되는 경로 이름은 공유, 캐시 및 설치됩니다. |
--path cache=<path> |
선택적: 지정한 위치를 사용하여 설치 파일을 다운로드합니다. 이 위치는 Visual Studio가 처음 설치된 경우에만 설정할 수 있습니다. 예: --path cache="C:\VS\cache" |
--path shared=<path> |
선택적: 병렬 Visual Studio 설치를 위한 공유 파일을 포함합니다. 일부 도구 및 SDK는 이 드라이브의 위치에 설치되는 반면, 다른 도구와 SDK는 이 설정을 재정의하고 다른 드라이브에 설치할 수 있습니다. 예: --path shared="C:\VS\shared" 중요: Visual Studio가 처음 설치될 때 한 번만 설정할 수 있습니다. |
--path install=<path> |
선택적: –-installPath동일합니다. 특히 --installPath "C:\VS" 및 --path install="C:\VS" 동일합니다. 이러한 명령 중 하나만 한 번에 사용할 수 있습니다. |
ModifySettings 명령 및 명령줄 매개 변수
클라이언트 컴퓨터의 설치 관리자 또는 부트스트래퍼를 사용하고 modifySettings 명령 및 원하는 업데이트 채널을 전달하여 업데이트 설정을 수정하고 Visual Studio의 지정된 인스턴스에 대한 업데이트 원본 위치를 프로그래밍 방식으로 구성할 수 있습니다.
| 명령 | 설명 |
|---|---|
modifySettings |
Visual Studio의 특정 인스턴스의 업데이트 설정을 수정하는 데 사용되는 동사입니다. |
| modifySettings 매개 변수 | 설명 |
|---|---|
--installPath <dir> |
은(는) 어느 Visual Studio 인스턴스를 대상으로 작업할지를 지정할 때 사용할 것을 권장합니다. |
--newChannelUri |
필수: 채널 매니페스트의 URI입니다. 이 값은 업데이트 다음 원본 위치를 지정합니다. 가능한 값은 --channelUri 구문 예제를 참조하세요. 업데이트를 원하지 않는 경우 --channelUri 존재하지 않는 파일(예: --channelUri C:\doesntExist.chman)을 가리킬 수 있습니다. |
--channelUri |
이전 채널 매니페스트의 URI입니다. --installPath를 알 수 없는 경우 사용할 수 있습니다. 작동할 올바른 인스턴스를 식별하려면 productID와 함께 사용해야 합니다. |
--productId <id> |
--channelUri가 지정된 경우, 적절한 인스턴스를 식별하기 위해 반드시 사용되어야 합니다.
productID "Microsoft.VisualStudio.Product.Enterprise"와 같습니다. |
--includeRecommended |
선택적: modifySettings 명령 중에 이 매개 변수(true 또는 false라는 단어가 있어야 함)는 Visual Studio 설치 관리자에게 업데이트 설정 대화 상자에서 "업데이트 시 설치된 워크로드에 대한 권장 구성 요소 추가" 기능을 사용하지 않도록 설정합니다. |
--quiet |
선택적: 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다. 표준 사용자는 프로그래밍 방식으로 사용할 수 없습니다. |
--removeOos true |
선택적: modifySettings 명령 중에 이 매개 변수(true 또는 false라는 단어가 있어야 함)는 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
롤백 명령 및 명령줄 매개 변수
Visual Studio 2022부터 클라이언트 컴퓨터의 설치 관리자를 사용하고 설치 경로 인스턴스와 함께 롤백 명령을 전달하여 프로그래밍 방식으로 업데이트 롤백할 있습니다.
| 명령 | 설명 |
|---|---|
rollback |
Visual Studio의 특정 인스턴스를 이전에 설치된 업데이트로 롤백하는 명령입니다. 이 명령은 DisableRollback 사용하도록 설정된 경우 작동하지 않습니다. |
| 롤백 매개 변수 | 설명 |
|---|---|
--installPath <dir> |
은(는) 어느 Visual Studio 인스턴스를 대상으로 작업할지를 지정할 때 사용할 것을 권장합니다. |
구문 예제:
"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에서 관리자 업데이트 구성
SCCM(Microsoft Endpoint Manager)을 통해 관리자 업데이트를 배포하는 경우 아래 매개 변수를 사용하여 동작을 조정하도록 패키지를 수정할 수 있습니다. 클라이언트 컴퓨터의 구성 파일을 통해 매개 변수를 제어할 수도 있습니다. 자세한 내용은 관리자 업데이트 구성하기 위한 메서드를 참조하세요.
레이아웃 동사를 지정하지 않는 한 모든 관리자 업데이트 매개 변수는 "update" 컨텍스트에서 기본적으로 실행됩니다.
| 관리자 업데이트 매개 변수 | 설명 |
|---|---|
--installerUpdateArgs [optional parameters] |
이 매개 변수는 관리자 업데이트 시나리오와 관련된 특정 매개 변수의 "통과 배열"로 작동합니다. 이 용도로 사용하도록 설정된 선택적 매개 변수는 다음과 같습니다. --quiet: 관리자 업데이트의 기본 환경이며 완전성을 위해 여기에 나열됩니다. --passive: 이 매개 변수는 --quiet 매개 변수를 재정의합니다. 그러면 UI가 비대화형 방식으로 표시됩니다. --norestart: 이 매개 변수는 --quiet 또는 --passive 함께 사용해야 하며 필요한 재부팅이 지연됩니다. --noWeb: 이 매개 변수는 Visual Studio가 인터넷에서 제품 업데이트를 확인하지 못하게 합니다. --force: 이 매개 변수는 Visual Studio를 사용 중인 경우에도 Visual Studio를 강제로 닫습니다. 이 매개 변수는 작업 손실이 발생할 수 있으므로 주의해서 사용합니다. 이 매개 변수는 관리자 업데이트가 사용자 컨텍스트에서 실행되는 경우에만 사용해야 합니다. 시스템 컨텍스트에서 관리자 업데이트가 실행되면 무시됩니다. --installWhileDownloading: 이 매개 변수를 사용하면 Visual Studio에서 제품을 병렬로 다운로드하고 설치할 수 있습니다. 관리자 업데이트의 기본 환경이며 완전성을 위해 여기에 나열됩니다. --keepWindowsUpdateOn: 이 매개 변수를 사용하면 설치 관리자가 클라이언트에서 Windows 업데이트 에이전트를 끌 수 없습니다. 카탈로그에서 SCCM으로 관리자 업데이트를 가져오는 경우 이 매개 변수를 사용해야 합니다. SCCM 패키지 시간 제한을 기본 10분보다 길게 설정해야 할 수도 있습니다. SCCM 배포 유형을 필수로 변경하면 이 매개 변수가 필요하지 않습니다.--downloadThenInstall: 이 매개 변수는 Visual Studio에서 파일을 설치하기 전에 모든 파일을 다운로드하도록 강제합니다.
--installWhileDownloading 매개 변수에서 상호 배타적입니다. |
--checkPendingReboot |
컴퓨터에 보류 중인 재부팅이 있는 경우, 그것을 유발한 응용 프로그램에 상관없이 업데이트가 중단됩니다. 기본값은 보류 중인 재부팅을 확인하지 않는 것입니다. |
관리자 업데이트에 매개 변수를 전달하는 구문 예제:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
채널 명령 및 명령줄 매개 변수 제거
업데이트할 수 있는 채널은 클라이언트에 캐시되며 시간이 지남에 따라 복잡해질 수 있습니다. Visual Studio 설치 관리자를 실행하여 사용 가능한 탭으로 전환한 후, 제품 카드 오른쪽 위의 X 를 클릭하여 업데이트 채널을 제거할 수 있습니다.
removeChannel 명령을 사용하여 프로그래밍 방식으로 채널(예: 이전 레이아웃 위치)을 제거할 수 있습니다. 클라이언트 컴퓨터에서 프로그래밍 방식으로 vswhere 실행하여 클라이언트 머신에 캐시되는 채널을 확인할 수 있습니다.
| 명령 | 설명 |
|---|---|
removeChannel |
클라이언트 컴퓨터에서 채널을 제거하는 명령입니다. |
| removeChannel 매개 변수 | 설명 |
|---|---|
--channelUri |
필수 이전 채널 매니페스트의 URI입니다. |
--quiet |
선택적 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다. |
--passive |
선택 사항 이 매개변수는 --quiet 매개변수를 대체합니다. 그러면 UI가 비대화형 방식으로 표시됩니다. |
구문 예제:
"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 "수정" 작업 역할을 합니다.
윈겟 구성 파일을 작성하는 방법을 참조하여 윈겟 구성을 만드는 방법을 알아봅니다.
--override 기본적으로 Visual Studio "업데이트" 작업으로 작동하고 이미 선택한 최신 버전의 구성 요소를 설치하기 때문에 upgrade 스위치 또는 Visual Studio DSC 공급자를 winget의 upgrade 명령과 함께 사용할 수 없습니다. 업데이트/업그레이드를 통해 구성 요소를 추가할 수 없습니다. winget의 configure 사용하여 구성 요소를 추가해야 합니다.
Visual Studio 설치 관리자 작업에는 현재 관리자 권한이 필요하므로 winget은 명령을 완료하는 데 필요한 경우 권한을 상승하라는 메시지를 표시합니다. 또한 현재 winget을 사용하여 여러 버전(즉, 다른 SKU) 또는 동일한 SKU의 여러 인스턴스를 클라이언트 컴퓨터에 동시에 설치할 수 없습니다. 마지막으로 구성 요소를 추가하거나 최신 버전으로 업그레이드하도록 구성(수정)하려는 경우 Visual Studio를 닫아야 합니다.
워크로드 ID 및 구성 요소 ID 목록
Visual Studio 제품별로 정렬된 워크로드 및 구성 요소 ID 목록은 Visual Studio 워크로드 및 구성 요소 ID 페이지를 참조하세요.
언어 지역 설정 목록
| 언어-지역 | 언어 |
|---|---|
| Cs-cz | 체코어 |
| De-de | 독일어 |
| En-us | 영어 |
| Es-es | 스페인어 |
| 프랑스어(프랑스) | 프랑스어 |
| It-it | 이탈리아어 |
| Ja-jp | 일본어 |
| Ko-kr | 한국어 |
| Pl-pl | 폴란드어 |
| Pt-br | 포르투갈어 - 브라질 |
| Ru-ru | 러시아어 |
| Tr-tr | 터키어 |
| Zh-cn | 중국어 - 간체 |
| Zh-tw | 중국어 - 번체 |
오류 코드
작업 결과에 따라 %ERRORLEVEL% 환경 변수는 다음 값 중 하나로 설정됩니다.
| 값 | 결과 |
|---|---|
| 0 | 작업이 성공적으로 완료되었습니다. |
| 740 | 권한 상승 필요 |
| 1001 | Visual Studio 설치 관리자 프로세스가 실행 중입니다. |
| 1003 | Visual Studio 사용 중 |
| 1602 | 작업이 취소되었습니다. |
| 1618 | 실행 중인 다른 설치 |
| 1641 | 작업이 성공적으로 완료되고 다시 부팅이 시작되었습니다. |
| 3010 | 작업이 성공적으로 완료되었지만 설치를 사용하려면 다시 부팅해야 합니다. |
| 5003 | 부트스트래퍼에서 설치 관리자를 다운로드하지 못했습니다. |
| 5004 | 작업이 취소되었습니다. |
| 5005 | 부트스트래퍼 명령줄 구문 분석 오류 |
| 5007 | 작업이 차단되었습니다. 컴퓨터가 요구 사항을 충족하지 않음 |
| 8001 | Arm 컴퓨터 검사 실패 |
| 8002 | 백그라운드 다운로드 사전 검사 실패 |
| 8003 | 지원이 중단된 선택적 오류 |
| 8004 | 대상 디렉터리 실패 |
| 8005 | 원본 페이로드 오류 확인 |
| 8006 | 실행 중인 Visual Studio 프로세스 |
| 8010 | 운영 체제는 지원되지 않습니다. 시스템 요구 사항 참조하세요. |
| -1073720687 | 연결 실패 |
| -1073741510 | Microsoft Visual Studio 설치 관리자가 종료되었습니다(사용자 또는 외부 프로세스에 의해). |
| 다른 (예: -1, 1, 1603) |
오류 조건이 발생했습니다. 자세한 내용은 로그를 확인하세요. |
각 작업은 %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