Creating offline installer for Visual Studio, includeRecommended/includeOptional switches doesn't work

Using Create an offline installer for Visual Studio 2017, Use command-line parameters to install Visual Studio 2017 and Visual Studio Enterprise 2017 component directory I tired to create offline installer for Visual Studio 2017, Enterprise, first time I used following:

vs_enterprise.exe --layout --lang en-US --add Microsoft.VisualStudio.Workload.CoreEditor Microsoft.VisualStudio.Workload.NetCoreTools Microsoft.VisualStudio.Workload.NetCrossPlat Microsoft.VisualStudio.Workload.NetWeb Microsoft.VisualStudio.Workload.WebCrossPlat Microsoft.VisualStudio.Workload.Node and its worked and I could install VS successfully.

After that I tired to update created files and add Recommended/Optional Components to some workloads, so I followed mentioned article, article says by adding --includeRecommended (also --includeOptional) switch, installer will download Recommended (Optional) components too. so I added (for ex.) --includeRecommended switch like this:

vs_enterprise.exe --layout --lang en-US --includeRecommended --includeOptional --add Microsoft.VisualStudio.Workload.CoreEditor Microsoft.VisualStudio.Workload.NetCoreTools Microsoft.VisualStudio.Workload.NetCrossPlat Microsoft.VisualStudio.Workload.NetWeb Microsoft.VisualStudio.Workload.WebCrossPlat Microsoft.VisualStudio.Workload.Node, and doesn't work (the second cmd (that shows download progress) closed immediately), in summary, I tired following commands too, and non of them doesn't work neither:

• vs_enterprise.exe --layout --lang en-US --add Microsoft.VisualStudio.Workload.NetCoreTools --includeRecommended
• vs_enterprise.exe --layout --lang en-US --includeRecommended --add Microsoft.VisualStudio.Workload.NetCoreTools
• ... (I mean I changed order of all parameters, actually I tired all possible options)

Also I tired in new (empty) folder, but no success.

I googled, but I found nothing, only some example that already exists in http://learn.microsoft.com.

How should I use includeRecommended/includeOptional switches?

Update (2021-11-10)

Following solution works perfectly for Visual Studio 2022

Update

Here is the list of all available workloads (linked to their details) and usage sample:

• Workload ID
• Visual Studio core editor Microsoft.VisualStudio.Workload.CoreEditor
• Azure development Microsoft.VisualStudio.Workload.Azure
• Data storage and processing Microsoft.VisualStudio.Workload.Data
• Data science and analytical applications Microsoft.VisualStudio.Workload.DataScience
• .NET desktop development Microsoft.VisualStudio.Workload.ManagedDesktop
• Game development with Unity Microsoft.VisualStudio.Workload.ManagedGame
• Linux development with C++ Microsoft.VisualStudio.Workload.NativeCrossPlat
• Desktop development with C++ Microsoft.VisualStudio.Workload.NativeDesktop
• Game development with C++ Microsoft.VisualStudio.Workload.NativeGame
• Mobile development with C++ Microsoft.VisualStudio.Workload.NativeMobile
• .NET Core cross-platform development Microsoft.VisualStudio.Workload.NetCoreTools
• Mobile development with .NET Microsoft.VisualStudio.Workload.NetCrossPlat
• ASP.NET and web development Microsoft.VisualStudio.Workload.NetWeb
• Node.js development Microsoft.VisualStudio.Workload.Node
• Office/SharePoint development Microsoft.VisualStudio.Workload.Office
• Python development Microsoft.VisualStudio.Workload.Python
• Universal Windows Platform development Microsoft.VisualStudio.Workload.Universal
• Visual Studio extension development Microsoft.VisualStudio.Workload.VisualStudioExtension
• Unaffiliated components

Create an offline installer: Documentation for VS2019 / Documentation For VS2022

1. Download the Visual Studio bootstrapper (e.g: vs_enterprise.exe)
2. Create a local install cache

• e.g: D:\whatever\vs_enterprise.exe --layout d:\whatever --add Microsoft.VisualStudio.Workload.CoreEditor --add Microsoft.VisualStudio.Workload.NetCoreTools --lang en-US

3. Double click on vs_enterprise.exe to install Visual Studio from the local cache

If you want to update prev. created local cache, run vs_enterprise.exe --layout d:\whatever

Original Answer:

The installer had a bug about this issue & as the team said, the bug fixed in v15.1 (release date: 4/6/2017).

I could download Microsoft.VisualStudio.Workload.NetWeb workload with following command successfully. (1.79GB)

vs_enterprise.exe --layout --lang en-US --add Microsoft.VisualStudio.Workload.NetWeb --includeRecommended --includeOptional