Skip to content

Commit 38ac9b2

Browse files
authored
Merge pull request #207 from timsneath/patch-2
Update tools-for-managing-visual-studio-instances.md
2 parents ab91131 + a92be9a commit 38ac9b2

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

docs/install/tools-for-managing-visual-studio-instances.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,19 @@ translation.priority.mt:
3636
## Detecting existing Visual Studio instances
3737
We have made several tools available that will help you detect and manage installed Visual Studio instances on client machines:
3838

39-
* [VSWhere](https://github.com/microsoft/vswhere): a C++ executable that helps you find the location of core Visual Studio tools from an installed instance of Visual Studio.
39+
* [VSWhere](https://github.com/microsoft/vswhere): an executable built into Visual Studio or available for separate distribution that helps you find the location of all Visual Studio instances on a particular machine.
4040
* [VSSetup.PowerShell](https://github.com/microsoft/vssetup.powershell): PowerShell scripts that use the Setup Configuration API to identify installed instances of Visual Studio.
4141
* [VS-Setup-Samples](https://github.com/microsoft/vs-setup-samples): C# and C++ samples that demonstrate how to use the Setup Configuration API to query an existing installation.
4242

4343
In addition, the [Setup Configuration API](https://msdn.microsoft.com/en-us/library/microsoft.visualstudio.setup.configuration.aspx) provides interfaces for developers who want to build their own utilities for interrogating Visual Studio instances.
4444

45+
## Using vswhere.exe
46+
`vswhere.exe` is automatically included in Visual Studio 2017 version 15.2 or above, or you may download it from [the releases page](https://github.com/Microsoft/vswhere/releases). Use `vswhere -?` to get help information about the tool. As an example, this command shows all releases of Visual Studio, including old versions of the product and prereleases, and outputs the results in JSON format:
47+
48+
```cmd
49+
C:\Program Files (x86)\Microsoft Visual Studio\Installer> vswhere.exe -legacy -prerelease -format json
50+
```
51+
4552
>[!TIP]
4653
>For more information about Visual Studio 2017 installation, see [Heath Stewart's blog articles](https://blogs.msdn.microsoft.com/heaths/tag/vs2017/).
4754

0 commit comments

Comments
 (0)