명령줄 매개 변수를 사용하여 Visual Studio 2017 설치Use command-line parameters to install Visual Studio 2017

명령 프롬프트에서 Visual Studio 2017를 설치할 때 다양한 명령줄 매개 변수를 사용하여 설치를 제어하거나 사용자 지정할 수 있습니다.When you install Visual Studio 2017 from a command prompt, you can use a variety of command-line parameters to control or customize the installation. 명령줄에서 다음 작업을 수행할 수 있습니다.From the command line, you can perform the following actions:

  • 특정 옵션이 미리 선택된 상태로 설치를 시작합니다.Start the install with certain options preselected.
  • 설치 프로세스를 자동화합니다.Automate the installation process.
  • 나중에 사용할 설치 파일의 캐시(레이아웃)를 만듭니다.Create a cache (layout) of the installation files for later use.

명령줄 옵션은 다운로드 프로세스를 시작하는 작은(약 1MB) 파일인 설치 부트스트래퍼와 함께 사용됩니다.The command-line options are used in conjunction with the setup bootstrapper, which is the small (approximately 1MB) file that initiates the download process. 부트스트래퍼는 Visual Studio 사이트에서 다운로드할 때 첫 번째로 실행되는 실행 파일입니다.The bootstrapper is the first executable that is launched when you download from the Visual Studio site. 다음 링크를 사용하여 설치 중인 제품 버전에 대한 최신 릴리스 부트스트래퍼에 직접 연결된 링크를 가져옵니다.Use the following links to get a direct link to the latest release bootstrapper for the product edition that you're installing:

명령줄 매개 변수 목록List of command-line parameters

Visual Studio 명령줄 매개 변수는 대/소문자를 구분하지 않습니다.Visual Studio command-line parameters are case-insensitive.

구문: vs_enterprise.exe [command] <options>...Syntax: vs_enterprise.exe [command] <options>...

(설치 중인 제품 버전에 적합하게 vs_enterprise.exe를 바꿉니다.)(Replace vs_enterprise.exe as appropriate for the product edition you're installing.)

명령줄을 사용하여 Visual Studio 2017을 설치하는 방법에 대한 자세한 예제는 명령줄 매개 변수 예제 페이지를 참조하세요.For more examples of how to use the command line to install Visual Studio 2017, see the Command-line parameter examples page.)

명령Command 설명Description
(비어 있음)(blank) 제품을 설치합니다.Installs the product.
modify 설치된 제품을 수정합니다.Modifies an installed product.
update 설치된 제품을 업데이트합니다.Updates an installed product.
repair 설치된 제품을 복구합니다.Repairs an installed product.
uninstall 설치된 제품을 제거합니다.Uninstalls an installed product.
설치 옵션Install option 설명Description
--installPath <dir> 작업할 인스턴스에 대한 설치 디렉터리입니다.The installation directory for the instance to act upon. 설치 명령의 경우 이 디렉터리는 선택 사항이고 인스턴스가 설치될 위치입니다.For the install command, this is Optional and is where the instance will be installed. 다른 명령의 경우 이 디렉터리는 필수이고 이전에 설치한 인스턴스가 설치된 위치입니다.For other commands, this is Required and is where the previously installed instance was installed.
--addProductLang <language-locale> 선택 사항: 설치 또는 수정 작업을 하는 동안 제품에 설치되는 UI 언어 팩을 결정합니다.Optional: During an install or modify operation, this determines the UI language packs that are installed to the product. 여러 언어 팩을 추가하려면 명령줄에 여러 번 나타날 수 있습니다.It can appear multiple times on the command line to add multiple language packs. 없는 경우 설치에 컴퓨터 로캘이 사용됩니다.If not present, the installation uses the machine locale. 자세한 내용은 이 페이지의 언어 로캘 목록 섹션을 참조하세요.For more information, see the List of language locales section on this page.
--removeProductLang <language-locale> 선택 사항: 설치 또는 수정 작업을 하는 동안 제품에서 제거할 UI 언어 팩을 결정합니다.Optional: During an install or modify operation, this determines the UI language packs that are to be removed from the product. 여러 언어 팩을 추가하려면 명령줄에 여러 번 나타날 수 있습니다.It can appear multiple times on the command line to add multiple language packs. 자세한 내용은 이 페이지의 언어 로캘 목록 섹션을 참조하세요.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> 선택 사항: 추가할 하나 이상의 작업 또는 구성 요소 ID입니다.Optional: One or more workload or component IDs to add. 아티팩트의 필수 구성 요소가 설치되지만 권장 또는 선택적 구성 요소는 설치되지 않습니다.The required components of the artifact are installed, but not the recommended or optional components. --includeRecommended 및/또는 --includeOptional을 사용하여 추가 구성 요소를 전체적으로 제어할 수 있습니다.You can control additional components globally using --includeRecommended and/or --includeOptional. 여러 워크로드 또는 구성 요소를 포함하려면 --add 명령(예:--add Workload1 --add Workload2)을 반복합니다.To include multiple workloads or components, repeat the --add command (for example, --add Workload1 --add Workload2). 더 세부적으로 제어하기 위해 ;includeRecommended 또는 ;includeOptional을 ID에 추가할 수 있습니다(예: --add Workload1;includeRecommended 또는 --add Workload2;includeRecommended;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeRecommended;includeOptional). 자세한 내용은 작업 및 구성 요소 ID 페이지를 참조하세요.For more information, see the Workload and component IDs page. 필요에 따라 이 옵션을 반복할 수 있습니다.You can repeat this option as necessary.
--remove <one or more workload or component IDs> 선택 사항: 제거할 하나 이상의 작업 또는 구성 요소 ID입니다.Optional: One or more workload or component IDs to remove. 자세한 내용은 작업 및 구성 요소 ID 페이지를 참조하세요.For more information, see our Workload and component IDs page. 필요에 따라 이 옵션을 반복할 수 있습니다.You can repeat this option as necessary.
--in <path> 선택 사항: 응답 파일의 URI 또는 경로입니다.Optional: The URI or path to a response file.
--all 선택 사항: 제품에 대한 모든 작업 및 구성 요소를 설치할지의 여부입니다.Optional: Whether to install all workloads and components for a product.
--allWorkloads 선택 사항: 모든 워크로드 및 구성 요소를 설치하고, 권장 또는 선택적 구성 요소는 설치하지 않습니다.Optional: Installs all workloads and components, no recommended or optional components.
--includeRecommended 선택 사항: 설치된 모든 작업에 대한 권장 구성 요소를 포함하지만, 선택적 구성 요소는 포함하지 않습니다.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. 워크로드는 --allWorkloads 또는 --add를 사용하여 지정됩니다.The workloads are specified either with --allWorkloads or --add.
--includeOptional 선택 사항: 설치된 모든 작업에 대한 선택적 구성 요소를 포함하지만, 권장 구성 요소는 포함하지 않습니다.Optional: Includes the optional components for any workloads that are installed, but not the recommended components. 워크로드는 --allWorkloads 또는 --add를 사용하여 지정됩니다.The workloads are specified either with --allWorkloads or --add.
--quiet, -q 선택 사항: 설치를 수행하는 동안 사용자 인터페이스를 표시하지 않습니다.Optional: Do not display any user interface while performing the installation.
--passive, -p 선택 사항: 사용자 인터페이스를 표시하지만 사용자 조작을 요청하지 않습니다.Optional: Display the user interface, but do not request any interaction from the user.
--norestart 선택 사항: 이 옵션이 있는 경우 --passive 또는 --quiet가 포함된 명령은 컴퓨터를 자동으로 다시 시작하지 않습니다(필요한 경우).Optional: If present, commands with --passive or --quiet will not automatically restart the machine (if necessary). --passive--quiet가 지정되지 않은 경우에는 무시됩니다.This is ignored if neither --passive nor --quiet are specified.
--nickname <name> 선택 사항: 설치된 제품에 할당할 애칭을 정의합니다.Optional: This defines the nickname to assign to an installed product. 애칭은 10자를 초과할 수 없습니다.The nickname cannot be longer than 10 characters.
--productKey 선택 사항: 설치된 제품에 사용할 제품 키를 정의합니다.Optional: This defines the product key to use for an installed product. 제품 키는 xxxxx-xxxxx-xxxxx-xxxxx-xxxxx 또는 xxxxxxxxxxxxxxxxxxxxxxxxx 형식의 영숫자 25자로 구성됩니다.It is composed of 25 alphanumeric characters either in the format xxxxx-xxxxx-xxxxx-xxxxx-xxxxx or xxxxxxxxxxxxxxxxxxxxxxxxx.
--help, --?, -h, -? 이 페이지의 오프라인 버전을 표시합니다.Display an offline version of this page.

참고: 여러 워크로드와 구성 요소를 지정할 경우 각 항목에 대해 --add 또는 --remove 명령줄 스위치를 반복해야 합니다.Note: When specifying multiple workloads and components, you must repeat the --add or --remove command-line switch for each item.

레이아웃 옵션Layout options 설명Description
--layout <dir> 오프라인 설치 캐시를 만들 디렉터리를 지정합니다.Specifies a directory to create an offline install cache. 자세한 내용은 Visual Studio의 네트워크 기반 설치 만들기를 참조하세요.For more information, see Create a network-based installation of Visual Studio.
--lang <one or more language-locales> 선택 사항: --layout과 함께 사용하여 지정된 언어의 리소스 패키지와 함께 오프라인 설치 캐시를 준비합니다.Optional: Used with --layout to prepare an offline install cache with resource packages with the specified language(s). 자세한 내용은 이 페이지의 언어 로캘 목록 섹션을 참조하세요.For more information, see the List of language locales section on this page.
--add <one or more workload or component IDs> 선택 사항: 추가할 하나 이상의 작업 또는 구성 요소 ID입니다.Optional: One or more workload or component IDs to add. 아티팩트의 필수 구성 요소가 설치되지만 권장 또는 선택적 구성 요소는 설치되지 않습니다.The required components of the artifact are installed, but not the recommended or optional components. --includeRecommended 및/또는 --includeOptional을 사용하여 추가 구성 요소를 전체적으로 제어할 수 있습니다.You can control additional components globally using --includeRecommended and/or --includeOptional. 더 세부적으로 제어하기 위해 ;includeRecommended 또는 ;includeOptional을 ID에 추가할 수 있습니다(예: --add Workload1;includeRecommended 또는 --add Workload2;includeOptional).For finer-grained control, you can append ;includeRecommended or ;includeOptional to the ID (for example, --add Workload1;includeRecommended or --add Workload2;includeOptional). 자세한 내용은 작업 및 구성 요소 ID 페이지를 참조하세요.For more information, see the Workload and component IDs page.
참고: --add를 사용하면 지정된 워크로드 및 구성 요소와 해당 종속성이 다운로드됩니다.Note: If --add is used, only the specified workloads and components and their dependencies are downloaded. --add가 지정되지 않으면 모든 워크로드 및 구성 요소가 레이아웃에 다운로드됩니다.If --add is not specified, all workloads and components are downloaded to the layout.
--includeRecommended 선택 사항: 설치된 모든 작업에 대한 권장 구성 요소를 포함하지만, 선택적 구성 요소는 포함하지 않습니다.Optional: Includes the recommended components for any workloads that are installed, but not the optional components. 워크로드는 --allWorkloads 또는 --add를 사용하여 지정됩니다.The workloads are specified either with --allWorkloads or --add.
--includeOptional 선택 사항: 레이아웃에 포함되는 모든 워크로드에 대한 권장 선택적 명령을 포함합니다.Optional: Includes the recommended and optional components for any workloads being included in the layout. 워크로드는 --add를 사용하여 지정됩니다.The workloads are specified with --add.
--keepLayoutVersion 15.3의 새로운 기능, 선택 사항: 레이아웃의 버전을 업데이트하지 않고 레이아웃에 변경 내용을 적용합니다.New in 15.3, optional: Apply changes to the layout without updating the version of the layout.
--verify 15.3의 새로운 기능, 선택 사항: 레이아웃의 콘텐츠를 확인합니다.New in 15.3, optional: Verify the contents of a layout. 손상되거나 누락된 파일이 모두 나열됩니다.Any corrupt or missing files are listed.
--fix 15.3의 새로운 기능, 선택 사항: 레이아웃의 콘텐츠를 확인합니다.New in 15.3, optional: Verify the contents of a layout. 손상되거나 누락된 파일이 있는 경우 다시 다운로드됩니다.If any files are found to be corrupt or missing, they are redownloaded. 레이아웃을 수정하려면 인터넷 액세스가 필요합니다.Internet access is required to fix a layout.
--clean <one or more paths to catalogs> 15.3의 새로운 기능, 선택 사항: 최신 버전으로 업데이트된 레이아웃에서 이전 버전의 구성 요소를 제거합니다.New in 15.3, optional: Removes old versions of components from a layout that has been updated to a newer version.
고급 설치 옵션Advanced install options 설명Description
--channelId <id> 선택 사항: 설치할 인스턴스의 채널 ID입니다.Optional: The ID of the channel for the instance to be installed. 설치 명령에 필요하며, --installPath가 지정된 경우 다른 명령에서는 무시됩니다.This is required for the install command, ignored for other commands if --installPath is specified.
--channelUri <uri> 선택 사항: 채널 매니페스트의 URI입니다.Optional: The URI of the channel manifest. 업데이트가 필요하지 않으면 --channelUri는 존재하지 않는 파일을 가리킬 수 있습니다.If updates are not desired, --channelUri can point to a non-existent file. 예를 들어 --channelUri C:\doesntExist.chman과 같습니다. 이 옵션은 install 명령에 사용할 수 있으며, 다른 명령에서는 무시됩니다.(for example, --channelUri C:\doesntExist.chman) This can be used for the install command; it is ignored for other commands.
--installChannelUri <uri> 선택 사항: 설치에 사용할 채널 매니페스트의 URI입니다.Optional: The URI of the channel manifest to use for the installation. --channelUri(--installChannelUri가 지정된 경우 지정해야 함)로 지정된 URI는 업데이트를 검색하는 데 사용됩니다.The URI specified by --channelUri (which must be specified when --installChannelUri is specified) is used to detect updates. 설치 명령에 사용할 수 있습니다. 다른 명령에서는 무시됩니다.This can be used for the install command; it is ignored for other commands.
--installCatalogUri <uri> 선택 사항: 설치에 사용할 카탈로그 매니페스트의 URI입니다.Optional: The URI of the catalog manifest to use for the installation. 지정된 경우 채널 관리자는 설치 채널 매니페스트의 URI를 사용하기 전에 이 URI에서 카탈로그 매니페스트를 다운로드하려고 합니다.If specified, the channel manager attempts to download the catalog manifest from this URI before using the URI in the install channel manifest. 이 매개 변수는 이미 다운로드한 제품 카탈로그를 사용하여 레이아웃 캐시가 생성되는 오프라인 설치를 지원하는 데 사용됩니다.This parameter is used to support offline install, where the layout cache will be created with the product catalog already downloaded. 설치 명령에 사용할 수 있습니다. 다른 명령에서는 무시됩니다.This can be used for the install command; it is ignored for other commands.
--productId <id> 선택 사항: 설치할 인스턴스에 대한 제품 ID입니다.Optional The ID of the product for the instance that will be installed. 이는 일반적인 설치 조건에서 미리 채워져 있습니다.This is prepopulated in normal installation conditions.
--wait 선택 사항: 프로세스에서 설치가 완료될 때까지 기다린 후에 종료 코드를 반환합니다.Optional: The process will wait until the install is completed before returning an exit code. 이 기능은 설치의 반환 코드를 처리하기 위해 설치가 완료할 때까지 기다려야 하는 설치를 자동화할 경우 유용합니다.This is useful when automating installations where one needs to wait for the install to finish to handle the return code from that install.
--locale <language-locale> 선택 사항: 설치 관리자의 사용자 인터페이스 표시 언어를 변경합니다.Optional: Change the display language of the user interface for the installer itself. 설정은 유지됩니다.Setting will be persisted. 자세한 내용은 이 페이지의 언어 로캘 목록 섹션을 참조하세요.For more information, see the List of language locales section on this page.
--cache 15.2의 새로운 기능, 선택 사항: 있는 경우 패키지가 이후 복구를 위해 설치된 후에도 유지됩니다.New in 15.2, optional: If present, packages will be kept after being installed for subsequent repairs. 이는 이후 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. 기본 정책은 패키지를 캐시하는 것입니다.The default policy is to cache packages. 제거 명령의 경우 무시됩니다.This is ignored for the uninstall command. 자세한 내용은 패키지 캐시를 사용하지 않도록 설정 또는 이동하는 방법을 참조하세요.Read how to disable or move the package cache for more information.
--nocache 15.2의 새로운 기능, 선택 사항: 패키지가 있는 경우 설치 또는 복구된 후에 삭제됩니다.New in 15.2, optional: If present, packages will be deleted after being installed or repaired. 필요한 경우에만 다시 다운로드되고 사용한 후 다시 삭제됩니다.They will be downloaded again only if needed and deleted again after use. 이는 이후 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다.This overrides the global policy setting to be used for subsequent installs, repairs, or modifications. 기본 정책은 패키지를 캐시하는 것입니다.The default policy is to cache packages. 제거 명령의 경우 무시됩니다.This is ignored for the uninstall command. 자세한 내용은 패키지 캐시를 사용하지 않도록 설정 또는 이동하는 방법을 참조하세요.Read how to disable or move the package cache for more information.
--noUpdateInstaller 15.2의 새로운 기능, 선택 사항: 있는 경우 quiet가 지정되었으면 설치 프로그램이 자기 자신을 업데이트하지 않습니다.New in 15.2, optional: If present, prevents the installer from updating itself when quiet is specified. quiet와 함께 noUpdateInstaller가 지정되었는데 설치 프로그램 업데이트가 필요한 경우 설치 프로그램에서 명령을 실패로 처리하고 0이 아닌 종료 코드를 반환합니다.The installer will fail the command and return a non-zero exit code if noUpdateInstaller is specified with quiet when an installer update is required.
--noWeb 15.3의 새로운 기능, 선택 사항: 설치 프로그램이 이제 설치하는 콘텐츠를 인터넷에서 다운로드합니다.New in 15.3, optional: Setup now downloads any content that it is installing from the Internet. 설치되는 모든 콘텐츠를 오프라인 레이아웃에서 사용할 수 있어야 합니다.All content that is being installed must be available in an offline layout. 레이아웃에 콘텐츠에 없으면 설치에 실패합니다.If the layout is missing content, setup fails. 자세한 내용은 네트워크 설치에서 배포를 참조하세요.For more information, see Deploying from a network installation.
--path <name>=<path> 15.7의 새로운 기능, 선택 사항: 설치에 대해 사용자 지정 설치 경로를 지정하는 데 사용합니다.New in 15.7, optional: Used to specify custom install paths for the installation. 지원되는 경로 이름은 공유, 캐시 및 설치입니다.Supported path names are shared, cache, and install.
--path cache=<path> 15.7의 새로운 기능, 선택 사항: 설치 파일을 다운로드하는 데 사용자가 지정한 위치를 사용합니다.New in 15.7, optional: Uses the location you specify to download installation files. 이 위치는 처음 Visual Studio를 설치할 때만 설정할 수 있습니다.This location can only be set the first time that Visual Studio is installed. 예: --path cache="C:\VS\cache"Example: --path cache="C:\VS\cache"
--path shared=<path> 15.7의 새로운 기능, 선택 사항: Visual Studio 병렬 설치를 위한 공유 파일을 포함합니다.New in 15.7, optional: Contains shared files for side-by-side Visual Studio installations. 일부 도구 및 SDK가 이 드라이브의 위치에 설치되지만 나머지는 이 설정을 재정의하고 다른 드라이브에 설치될 수 있습니다.Some tools and SDKs install to a location on this drive, while some others might override this setting and install to another drive. 예: --path shared="C:\VS\shared"Example: --path shared="C:\VS\shared"

중요: 이는 Visual Studio를 설치 처음으로 설치할 때 한 번만 설정하면 됩니다.Important: This can be set only once and on the first time that Visual Studio is installed.
--path install=<path> 15.7의 새로운 기능, 선택 사항: –-installPath에 해당합니다.New in 15.7, optional: Equivalent to –-installPath. 특히 --installPath "C:\VS"--path install="C:\VS"는 같습니다.Specifically, --installPath "C:\VS" and --path install="C:\VS" are equivalent. 이 중 하나만 한 번에 사용할 수 있습니다.Only one of these can be used at a time.

작업 ID 및 구성 요소 ID 목록List of workload IDs and component IDs

Visual Studio 제품별로 정렬된 워크로드 및 구성 요소 ID 목록은 Visual Studio 2017 워크로드 및 구성 요소 ID 페이지를 참조하세요.For a list of workload and component IDs sorted by Visual Studio product, see the Visual Studio 2017 Workload and Component IDs page.

언어 로캘 목록List of language locales

언어 로캘Language-locale 언어Language
Cs-czCs-cz 체코어Czech
De-deDe-de 독일어German
En-usEn-us 영어English
Es-esEs-es 스페인어Spanish
Fr-frFr-fr 프랑스어French
It-itIt-it 이탈리아어Italian
Ja-jpJa-jp 일본어Japanese
Ko-krKo-kr 한국어Korean
Pl-plPl-pl 폴란드어Polish
Pt-brPt-br 포르투갈어 - 브라질Portuguese - Brazil
Ru-ruRu-ru 러시아어Russian
Tr-trTr-tr 터키어Turkish
Zh-cnZh-cn 중국어 - 간체Chinese - Simplified
Zh-twZh-tw 중국어 - 번체Chinese - Traditional

오류 코드Error codes

작업 결과에 따라 %ERRORLEVEL% 환경 변수는 다음 값 중 하나로 설정됩니다.Depending on the result of the operation, the %ERRORLEVEL% environment variable is set to one of the following values:

Value 결과Result
00 작업이 완료되었습니다.Operation completed successfully
16021602 작업이 취소되었습니다.Operation was canceled
30103010 작업이 완료되었지만, 사용하려면 다시 부팅해야 합니다.Operation completed successfully, but install requires reboot before it can be used
50045004 작업이 취소되었습니다.Operation was canceled
50075007 작업이 차단되었습니다. 컴퓨터가 요구 사항에 맞지 않습니다.Operation was blocked - the computer does not meet the requirements
기타Other 오류 조건 발생 - 자세한 내용은 로그를 확인하세요.Failure condition occurred - check the logs for more information

각 작업은 %TEMP% 디렉터리에 설치 진행률을 나타내는 여러 로그 파일을 생성합니다.Each operation generates several log files in the %TEMP% directory that indicate the progress of the installation. 폴더를 날짜별로 정렬하고 부트스트래퍼, 설치 관리자 앱 및 설치 엔진 각각에 대해 dd_bootstrapper, dd_clientdd_setup으로 시작하는 파일을 찾습니다.Sort the folder by date and look for files that begin with dd_bootstrapper, dd_client, and dd_setup for the bootstrapper, the installer app, and the setup engine, respectively.

지원 받기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