Visual Studio 2019 Build Tools

### Overview

The Visual Studio Build Tools allows you to build native and managed MSBuild-based applications without requiring the Visual Studio IDE. There are options to install the Visual C++ compilers and libraries, MFC, ATL, and C++/CLI support.

To find out what's new or to see the known issues, see the [Visual Studio 2019 release notes](https://docs.microsoft.com/en-us/visualstudio/releases/2019/release-notes).

[System requirements](https://docs.microsoft.com/en-us/visualstudio/releases/2019/system-requirements)

### Customizations and Optional features

By default, the package installs only the bare minimum required (the MSBuild Tools 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-2019). 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-2019#list-of-language-locales). By default, the operating system display language is used.

#### Full installation

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

choco install visualstudio2019buildtools --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. dotnetfx 4.7.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.