설치 구성 파일을 사용하여 Visual Studio 설치를 구성할 수 있습니다. 이렇게 하려면 Visual Studio 설치 관리자를 사용하여 워크로드, 구성 요소 및 Marketplace 확장 정보를 .vsconfig 파일로 내보냅니다. .vsconfig 파일이 있으면 수동으로 더 구체화하고 추가 항목을 추가하거나 제거할 수 있습니다. .vsconfig 파일의 구조 및 구문은 vsconfig 파일 형식 섹션에서 설명합니다.
구성 파일을 새 또는 기존 Visual Studio 설치로 가져오고, 레이아웃 또는 오프라인 설치를 만들거나 수정하고, 솔루션 디렉터리 또는 리포지토리에 배치하고, 누락된 구성 요소의 설치를 트리거하고, 다른 사용자와 공유할 수도 있습니다.
Visual Studio 설치 관리자를 사용하여 구성 내보내기
이전에 설치된 Visual Studio 인스턴스에서 설치 구성 파일을 내보낼 수 있습니다.
메모
Visual Studio 2022 버전 17.10 Preview부터 인스턴스 전체 컨텍스트에서 로드된 Visual Studio Marketplace 확장.vsconfig 파일로 내보낼 수 있습니다.
export 기능이 네트워크 공유에서 로드된 확장 또는 사용자 컨텍스트에 로드된 확장과 같은 다른 유형의 확장을 내보낼 수 있도록 하려면 알려주세요.
Visual Studio 설치 관리자 UI 사용
시작 메뉴에서 Visual Studio 설치 관리자를 엽니다.
제품 카드에서 추가 단추를 선택한 다음 내보내기 구성선택합니다.
.vsconfig 파일을 저장할 위치를 찾거나 입력한 다음 세부 사항 검토선택하십시오.
선택 항목이 정확한지 확인한 다음 내보내기를 선택합니다.
프로그래밍 방식으로 구성 파일 내보내기
export 동사를 사용하여 프로그래밍 방식으로 특정 Visual Studio 인스턴스의 구성 파일을 내보낼 수 있습니다. 자세한 내용은 명령줄 매개 변수를 사용하여 Visual Studio설치, 업데이트 및 관리합니다.
Visual Studio 설치 관리자를 사용하여 구성 가져오기
설치 구성 파일을 이전에 설치된 Visual Studio 인스턴스로 가져오거나 이를 사용하여 Visual Studio의 새 설치를 초기화할 수 있습니다. 구성 파일을 Visual Studio로 가져오면 아직 설치되지 않은 구성 파일에 나열된 모든 항목이 설치됩니다.
Visual Studio 설치 관리자 UI 사용
설치 구성 파일을 가져올 준비가 되면 다음 단계를 수행합니다.
Visual Studio 설치 관리자를 열고 Visual Studio를 닫습니다. 대부분의 설치 관리자 작업을 수행하려면 Visual Studio 제품 자체가 닫혀 있어야 합니다.
설치된 탭 또는 사용 가능한 탭에서 Visual Studio 제품 카드에서 기타>가져오기 구성 선택합니다.
가져올 .vsconfig 파일을 찾은 다음 검토 세부 정보선택합니다.
선택 항목이 정확한지 확인한 다음 수정할선택합니다.
프로그래밍 방식으로 구성 파일을 사용하여 기존 설치에 구성 요소 추가
--config 매개 변수를 사용하여 기존 설치를 초기화하거나 수정하고 구성 요소를 추가할 수 있습니다. 다음 예제에서는 클라이언트 컴퓨터의 설치 관리자를 사용하여 기존 설치를 modify.
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions
메모
.vsconfig 파일을 사용하여 기존 설치에 구성 요소를 추가하려면 modify 및 를 사용하고update는 사용하지 않아야 합니다.
update 명령은 설치된 기존 구성 요소를 최신 버전으로 업데이트합니다. 다양한 설치 관리자 작업에 대한 자세한 내용은 명령줄에서 Visual Studio 설치 설명서를 참조하세요.
구성 파일을 사용하여 레이아웃 내용 초기화
원하는 Visual Studio 버전 및 버전에 해당하는 올바른 부트스트래퍼를 사용하여 관리자 명령 프롬프트를 열고 다음 명령을 실행하여 --config 매개 변수를 사용하여 레이아웃의 내용을 구성합니다.
.vsconfig 파일을 사용하여 레이아웃을 초기화하고 설치하려면, 구성 파일을 사용하여 레이아웃의 콘텐츠를 초기화하는 방법에 대한 자세한 내용을 참조하십시오.
vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US
구성 파일을 사용하여 누락된 구성 요소 자동 설치
.vsconfig 파일을 솔루션 루트 디렉터리에 저장한 다음 솔루션을 열면 Visual Studio에서 누락된 구성 요소를 자동으로 검색하고 설치하라는 메시지를 표시합니다.
메모
.vsconfig 파일에 확장 프로그램이 포함된 경우, 현재는 Visual Studio Marketplace 에서 호스트되는 확장 프로그램만 자동으로 누락됨 감지 및 설치를 트리거합니다. Marketplace가 아닌 위치에서 설치된 확장자를 이 논리에 포함하려면, 여기에서 귀하의 시나리오에 대한 세부 정보를제공해 주세요.
솔루션 탐색기에서 바로.vsconfig파일을 생성할 수 있습니다.
솔루션 파일을 마우스 오른쪽 단추로 클릭합니다.
선택>설치 구성 파일추가합니다.
.vsconfig 파일을 저장할 위치를 확인한 다음 세부 정보 검토선택합니다.
원하는 워크로드 및 구성 요소가 있는지 확인한 다음 내보내기을 선택합니다.
또한 .vsconfig 파일을 재귀적으로 Visual Studio 설치 구성을 찾아서 모두 병합하는 오픈 소스 유틸리티를 만들었습니다. 이 유틸리티에 대한 자세한 내용은 GitHub VSConfigFinder를 참조하세요.
vsconfig 파일 형식
.vsconfig 파일은 구성 요소 섹션과 선택적으로 확장 섹션을 포함하는 json 파일 형식입니다. 구성 요소 섹션에는 워크로드 및 구성 요소가 포함되어 있으며 다음과 같이 표시됩니다.
{
"version": "1.0",
"components": [
"Microsoft.VisualStudio.Component.CoreEditor",
"Microsoft.VisualStudio.Workload.CoreEditor",
"Microsoft.VisualStudio.Component.NuGet"
]
}
확장
Visual Studio 2022 버전 17.9 부터, .vsconfig 파일에서 확장을 지정하고 Visual Studio 설치 관리자를 사용하여 모든 사용자가 사용할 수 있도록 컴퓨터 전체에 로드할 수 있습니다. Visual Studio 2022 버전 17.10 미리 보기부터 Visual Studio 설치 관리자를 사용하여 이전에 설명한 대로 인스턴스 전체 컨텍스트에서 로드된 .vsconfig 파일에 Visual Studio Marketplace 확장을export 수 있습니다.
구성 파일의 확장 지원과 관련된 몇 가지 알려진 주의 사항이 있습니다.
- 구성 파일을 통해 로드된 확장은 인스턴스 전체에 설치되므로 관리자 권한이 있거나 설치하려면 AllowStandardUserControl 정책을 통해 설치 관리자를 제어할 수 있어야 합니다. 이전에 Visual Studio 확장 관리자에서 설치한 모든 확장에는 인스턴스 너비가 아닌 사용자별로 설치되는 기능이 있었으며 사용자가 설치할 관리자 권한이 필요하지 않았습니다.
- Visual Studio 설치 관리자는 현재 특정 유형의 확장(예:
*.vsix패키지에 포함된 확장 또는 복잡한 않은 확장)만 가져올 수 있도록 지원합니다. 구성 파일을 통해 제대로 로드되지 않는 확장명이 있는 경우 새 개발자 커뮤니티 제안통해 알려주세요. - Visual Studio Marketplace에서 호스트되는 확장만, 솔루션 디렉터리에 .vsconfig 파일이 있을 경우, 자동 누락 감지 및 설치를 트리거합니다. Marketplace가 아닌 위치에서 설치된 확장을 포함하도록 이 논리를 원하는 경우 여기에서 시나리오에 대한 세부 정보를 제공하세요.
-
.vsconfig 파일을 프로그램 방식으로 사용하여 확장을 추가하는 경우, 서명되지 않은 가
--passive또는--quiet컨텍스트에서 로드될 수 있도록--allowUnsignedExtensions매개 변수를 사용해야 합니다. 레이아웃에서 설치하는 경우, 비슷한 효과를 얻기 위해"allowUnsignedExtensions" : true파일의response.json구문을 추가할 수 있습니다.
모든 인스턴스 전체 확장은 예약된 작업을 통해 하루에 한 번 자동으로 업데이트됩니다. 자세한 내용은 자동 확장 업데이트참조하세요.
확장자를 포함하는 .vsconfig 파일 형식은 다음과 같습니다.
{
"version": "1.0",
"components": [
// Whatever components you want to install come here, in quotes, separated by commas.
// You can use the installer to select the components you want to install and then export them,
// Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
// This array should not be null! If you don't want to install any component, just leave the array empty.
],
"extensions": [
// The extensions you want to install are specified in this section, in quotes, separated by commas.
// Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
// The extensions must be in a *.vsix package
// Make sure that the extensions you specify are designed to work with that version of Visual Studio.
// examples below
"https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit", //unsigned extension
"https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer", //signed extension
"c:\\mylocaldrive\\someextension.vsix",
"\\\\server\\share\\myextension.vsix",
"https://myweb/anotherextension.vsix"
]
}
지원 또는 문제 해결
때로는 상황이 잘못 될 수 있습니다. Visual Studio 설치가 실패하는 경우 단계별 지침은 Visual Studio 설치 및 업그레이드 문제 해결 참조하세요.
다음은 몇 가지 추가 지원 옵션입니다.
- 설치 관련 문제에는 설치 채팅(영어 전용) 지원 옵션을 사용합니다.
- Visual Studio 설치 관리자와 Visual Studio IDE 모두에 표시되는 문제 보고 도구를 사용하여 제품 문제를 보고합니다. IT 관리자이고 Visual Studio가 설치되어 있지 않은 경우 IT 관리자 피드백을 제출할 수 있습니다.
- 기능을 제안하고, 제품 문제를 추적하고, Visual Studio 개발자 커뮤니티답변을 찾습니다.
관련 콘텐츠
- .vsconfig 사용하여 조직 전체에서 Visual Studio 구성
- Visual Studio 네트워크 설치 만들기
- 레이아웃에서 설치된 Visual Studio 클라이언트를 업데이트
- 네트워크 기반 Visual Studio 배포에 대한 업데이트 제어
- 엔터프라이즈 배포를 위한 정책 구성