Visual Studio 2017 Community

### Overview

Free, full-featured and extensible tool for students, open-source and individual developers.

To find out what's new or to see the known issues, see the [Visual Studio 2017 Release Notes](https://www.visualstudio.com/en-us/news/releasenotes/vs2017-relnotes).

[System requirements](https://www.visualstudio.com/en-us/productinfo/vs2017-system-requirements-vs)

### Customizations and Optional features

By default, the package installs only the bare minimum required (the Core Editor workload). The easiest way to add more development features is to use the workload packages listed in the Release Notes section.

All package parameters are passed to the Visual Studio installer, enabling full customization of the installation. The possible parameters are [described here](https://docs.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2017). The package passes `--norestart --wait` by default, and `--quiet`, unless `--passive` is specified in the package parameters.

After installing the package, more features can also be added by launching the Visual Studio Installer application from the Start Menu.

The language of the installed software can be controlled using the package parameter `--locale language`.

The list of languages is [presented here](https://docs.microsoft.com/en-us/visualstudio/install/use-command-line-parameters-to-install-visual-studio?view=vs-2017#list-of-language-locales). By default, the operating system display language is used.

#### Full installation

This command will install Visual Studio with all available workloads and optional components, display progress during the installation and specify the English language regardless of operating system settings:

choco install visualstudio2017community --package-parameters "--allWorkloads --includeRecommended --includeOptional --passive --locale en-US"

[More package parameter examples](https://github.com/jberezanski/ChocolateyPackages/blob/master/chocolatey-visualstudio.extension/EXAMPLES.md)

### Notes

A reboot may be required after (or even _before_) installing/uninstalling this package.

If control over reboots is required, it is advisable to install the dependencies (esp. dotnet4.6.2 or later) first, perform a reboot if necessary, and then install this package.

Some parameters, including `--allWorkloads`, `--includeRecommended` and `--includeOptional`, are only valid during the initial installation of Visual Studio and may cause failures if used during upgrade. For reliability, it is recommended to avoid using these parameters and install workloads using the workload packages listed in the Release Notes section.