지시 파일에서 설정을 정의하는 방법How to define settings in a response file

Visual Studio를 배포하는 관리자는 다음 예제와 같이 --in 매개 변수를 사용하여 지시 파일을 지정할 수 있습니다.Administrators who deploy Visual Studio can specify a response file by using the --in parameter, as in the following example:

vs_enterprise.exe --in customInstall.json

지시 파일은 명령줄 인수를 미러링하는 콘텐츠가 포함된 JSON 파일입니다.Response files are JSON files whose contents mirror the command-line arguments. 일반적으로 명령줄 매개 변수가 인수를 사용하지 않으면(예: --quiet, --passive 등) 지시 파일의 값은 true/false여야 합니다.In general, if a command-line parameter takes no arguments (for example, --quiet, --passive, etc.), the value in the response file should be true/false. 매개 변수가 인수를 사용하면(예: --installPath <dir>) 지시 파일의 값은 문자열이어야 합니다.If it takes an argument (for example, --installPath <dir>), the value in the response file should be a string. 매개 변수가 인수를 사용하고 명령줄에 두 번 이상 나타날 수 있으면(예: --add <id>) 값은 문자열 배열이어야 합니다.If it takes an argument and can appear on the command line more than once (for example, --add <id>), it should be an array of strings.

매개 변수가 여러 입력을 사용하는 경우(예: --add)를 제외하고 명령줄에 지정된 매개 변수는 지시 파일의 설정을 재정의합니다.Parameters that are specified on the command-line override settings from the response file, except when parameters take multiple inputs (for example, --add). 여러 입력을 사용하는 경우 명령줄에 지정한 입력이 지시 파일의 설정과 병합됩니다.When you have multiple inputs, the inputs supplied on the command line are merged with settings from the response file.

Visual Studio에 대한 기본 구성 설정Setting a default configuration for Visual Studio

--layout을 사용하여 네트워크 레이아웃 캐시를 만든 경우 초기 response.json 파일은 레이아웃에서 만들어집니다.If you created a network layout cache with the --layout, an initial response.json file is created in the layout. 부분 레이아웃을 만드는 경우 이 지시 파일에는 레이아웃에 포함된 워크로드 및 언어가 포함됩니다.If you create a partial layout, this response file includes the workloads and languages that were included in the layout. 이 레이아웃에서 설치를 실행하면 자동으로 response.json 파일이 사용되어 레이아웃에 포함된 워크로드 및 구성 요소가 선택됩니다.Running setup from this layout automatically uses this response.json file, which selects the workloads and components included in the layout. 그래도 사용자는 Visual Studio를 설치하기 전에 설치 UI에서 워크로드를 선택하거나 선택 취소할 수 있습니다.Users can still select or unselect any workloads in the setup UI before installing Visual Studio.

레이아웃을 만드는 관리자는 레이아웃의 response.json 파일을 수정하여 레이아웃에서 Visual Studio를 설치할 때 사용자에게 표시되는 기본 설정을 제어할 수 있습니다.Administrators who create a layout can modify the response.json file in the layout to control the default settings that their users see when they install Visual Studio from the layout. 예를 들어 관리자가 특정 워크로드 및 구성 요소가 기본적으로 설치되도록 하려면 해당 항목을 추가하도록 response.json 파일을 구성할 수 있습니다.For example, if an administrator wants specific workloads and components installed by default, they can configure the response.json file to add them.

Visual Studio 설치 프로그램을 레이아웃 폴더에서 실행하면 자동으로 레이아웃 폴더의 지시 파일을 사용합니다.When Visual Studio setup is run from a layout folder, it automatically uses the response file in the layout folder. --in 옵션을 사용할 필요가 없습니다.You don't have to use the --in option.

오프라인 레이아웃 폴더에 만들어진 response.json 파일을 업데이트하여 이 레이아웃에서 설치하는 사용자의 기본 설정을 정의할 수 있습니다.You can update the response.json file that is created in an offline layout folder to define the default setting for users who install from this layout.

경고

레이아웃이 만들어질 때 정의된 기존 속성은 그대로 유지해야 합니다.It's critical that you leave the existing properties that were defined when the layout was created.

레이아웃의 기본 response.json 파일은 다음 예제와 유사하며, 여기에 설치할 제품 및 채널에 대한 값이 더 포함됩니다.The base response.json file in a layout should look similar to the following example, except that it would include the value for the product and channel that you want to install:

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/15/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.15.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

레이아웃을 만들거나 업데이트하면 response.template.json 파일도 만들어집니다.When you create or update a layout, a response.template.json file is also created. 이 파일에는 사용할 수 있는 모든 워크로드, 구성 요소 및 언어 ID가 포함됩니다.This file contains all of the workload, component, and language IDs that can be used. 이 파일은 사용자 지정 설치에 포함할 수 있는 모든 항목에 대한 템플릿으로 제공됩니다.This file is provided as a template for what all could be included in a custom install. 관리자는 이 파일을 사용자 지정 지시 파일을 만들기 위한 기준으로 삼을 수 있습니다.Administrators can use this file as a starting point for a custom response file. 설치하지 않을 항목에 대한 ID를 제거하고 고유한 지시 파일로 저장하면 됩니다.Just remove the IDs for the things you do not want to install and save it in your own response file. response.template.json 파일의 경우 레이아웃이 업데이트되면 변경 내용이 손실되므로 사용자 지정하지 마세요.Do not customize the response.template.json file or your changes will be lost whenever the layout is updated.

레이아웃 지시 파일 콘텐츠의 예Example layout response file content

다음 예제에서는 6개의 일반 워크로드 및 구성 요소가 포함되고 영어 및 프랑스어 UI 언어가 모두 포함된 Visual Studio Enterprise를 설치합니다.The following example installs Visual Studio Enterprise with six common workloads and components, and with both English and French UI languages. 이 예제를 템플릿으로 사용할 수 있고, 이 경우 워크로드 및 구성 요소를 설치할 항목으로 변경하면 됩니다.You can use this example as a template; just change the workloads and components to those that you want to install:

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/15/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.15.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2017",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

지원 받기Get support

때로는 무엇인가 잘못될 수도 있습니다.Sometimes, things can go wrong. Visual Studio 설치에 실패하는 경우에는 Visual Studio 2017 설치 및 업그레이드 문제 해결 페이지를 참조하세요.If your Visual Studio installation fails, see the Troubleshooting Visual Studio 2017 installation and upgrade issues page. 문제 해결 단계가 도움이 되지 않는 경우 라이브 채팅을 통해 Microsoft에 설치 지원을 문의할 수 있습니다(영어만 가능).If none of the troubleshooting steps help, you can contact us by live chat for installation assistance (English only). 자세한 내용은 Visual Studio 지원 페이지를 참조하세요.For details, see the Visual Studio support page.

몇 가지 추가 지원 옵션은 다음과 같습니다.Here are a few more support options:

참고 항목See also