Skip to content

Commit ff9eaec

Browse files
sevend2sevend2
authored
Merge pull request #7738 from sevend2/InternalToPublic
AB#2556: Visual Studio - Convert internal TSGs into public facing
2 parents 86f8b73 + 6f789d1 commit ff9eaec

10 files changed

Lines changed: 306 additions & 0 deletions

‎support/developer/visualstudio/installation/installation-stops-package-10-windows-10-21h2.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Visual Studio Installation Stops on Windows 10 21H2
3+
description: Helps resolve an error that occurs when you install Visual Studio using the online installer on a Windows 10, version 21H2 machine.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# Visual Studio installation stops during package 10 on Windows 10, version 21H2
10+
11+
## Symptoms
12+
13+
When you install Visual Studio on a Windows 10, version 21H2 machine, it stops during the installation of package 10, and you see the following message in the event viewer for **setup.exe**:
14+
15+
```output
16+
Log Name: Application
17+
Source: Application Hang
18+
Event ID: 1002
19+
Task Category: Hanging Events
20+
Level: Error
21+
Keywords: Classic
22+
User: N/A
23+
Description: The program setup.exe version 3.4.2246.31370 stopped interacting with Windows and was closed. To see if more information about the problem is available, check the problem history in the Security and Maintenance control panel.
24+
Event Xml: <Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event"> <System> <Provider Name="Application Hang"/> <EventID Qualifiers="0">1002</EventID>
25+
```
26+
27+
This issue can also occur if the Visual Studio Installer is corrupt or fails to launch.
28+
29+
## Resolution
30+
31+
To resolve the issue, follow these steps:
32+
33+
1. Uninstall the Visual Studio Installer application.
34+
1. Delete the folder and its contents located at **C:\Program Files (x86)\Microsoft Visual Studio\Installer**.
35+
1. Go to the [Visual Studio page](https://visualstudio.microsoft.com/vs/) and download the edition that you're using.
36+
1. Run the Visual Studio setup as an administrator.

‎support/developer/visualstudio/installation/installation-vs-2022-license-key-shows-invalid.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: License Key Is Invalid When Installing Visual Studio
3+
description: Helps resolve an issue where the license key shows as invalid even though the license key is mentioned in the package when installing Visual Studio.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# The license key is invalid when installing Visual Studio
10+
11+
## Symptoms
12+
13+
When you install Visual Studio with the parameter `--productKey` like `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX`, the license key shows as invalid, and the installer repeatedly asks for the license key, even though you use the license key mentioned in the package.
14+
15+
## Resolution
16+
17+
According to [Use command-line parameters to install, update, and manage Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio), the `--productkey` parameter only supports 25 alphanumeric characters in the format of `XXXXXXXXXXXXXXXXXXXXXXXXX`.
18+
19+
| Parameter | Description |
20+
|-----------------|-------------------------------------------------------------|
21+
| `--productKey` | **Optional**: During an install command, this parameter defines the product key to use for an installed product. It's composed of 25 alphanumeric characters in the format of `XXXXXXXXXXXXXXXXXXXXXXXXX`.|
22+
23+
To solve the issue, remove the dashes in `XXXXX-XXXXX-XXXXX-XXXXX-XXXXX` from the parameter `--productKey`. Here's an example:
24+
25+
```powershell
26+
$RetVal = Execute-Process -Path "$dirFiles\vs_Professional.exe" -Parameters "--add Microsoft.VisualStudio.Workload.Data --add Microsoft.VisualStudio.Workload.DataScience --add Microsoft.VisualStudio.Workload.ManagedDesktop --locale en-US --quiet --wait --norestart --productKey XXXXXXXXXXXXXXXXXXXXXXXXX" -PassThru
27+
```

‎support/developer/visualstudio/installation/maui-template-missing-vs-2022-professional.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: .NET Multi-Platform App UI Template Is Missing
3+
description: Helps resolve an error that occurs after you install the .NET Multi-platform App UI workload.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# The .NET Multi-platform App UI template is missing in Visual Studio
10+
11+
## Symptoms
12+
13+
The .NET Multi-platform App UI (MAUI) template is missing in Visual Studio even after installing the .NET MAUI workload.
14+
15+
## Cause
16+
17+
The .NET MAUI template isn't installed.
18+
19+
## Resolution
20+
21+
To install the MAUI template, follow these steps:
22+
23+
1. Open the Command Prompt.
24+
1. Run the command `dotnet workload install maui` to install the MAUI workload if it's not installed. This command installs the necessary components and dependencies for MAUI development.
25+
1. After the MAUI workload is installed, run the command `dotnet new --install Microsoft.Maui.Templates` to install the MAUI templates. This command fetches and installs the latest templates for creating MAUI projects.
26+
27+
Once the templates are installed, you can see the .NET MAUI template available in Visual Studio when creating a new project.
28+
29+
For more information on installing .NET MAUI workload in Visual Studio and building .NET MAUI apps, see [Installation](/dotnet/maui/get-started/installation) and [Build your first app](/dotnet/maui/get-started/first-app).

‎support/developer/visualstudio/installation/media/offline-installation-windows-app-sdk-extension/windows-app-sdk-extension-vs-2022-fail.png‎

12.8 KB
Loading

‎support/developer/visualstudio/installation/offline-installation-windows-app-sdk-extension.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Offline Installation of Windows App SDK C# Extension Fails
3+
description: Helps resolve an error that occurs when you install the Windows App SDK C# extension for Visual Studio offline.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Offline Install
7+
---
8+
# Offline installation of the Windows App SDK C# extension for Visual Studio fails
9+
10+
_Applies to:_&nbsp; Visual Studio 2022
11+
12+
## Symptoms
13+
14+
When you install the Windows App SDK C# extension for Visual Studio offline, it fails with the following error message:
15+
16+
```output
17+
Install Failed
18+
The install of 'Windows App SDK C# VS2022 Templates' was not successful for all the selected products.
19+
For more information, click on the install log link at the bottom of the dialog.
20+
Windows App SDK C# VS2022 Templates
21+
One or more errors occurred.
22+
```
23+
24+
:::image type="content" source="media/offline-installation-windows-app-sdk-extension/windows-app-sdk-extension-vs-2022-fail.png" alt-text="Screenshot of the error message when you install the Windows App SDK C# extension for Visual Studio 2022 offline.":::
25+
26+
## Resolution
27+
28+
To perform an offline installation of the Windows App SDK extension for Visual Studio, run the following command line:
29+
30+
```cmd
31+
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\resources\app\ServiceHub\Services\Microsoft.VisualStudio.Setup.Service\VSIXInstaller.exe" /noextensionpack <path to the WindowsAppSDK VSIX>
32+
```
33+
34+
Replace `<path to the WindowsAppSDK VSIX>` with the actual file path of the Windows App SDK VSIX extension file. For more information, see [WinApp SDK Dev 17 Offline Install Failure](https://github.com/microsoft/WindowsAppSDK/issues/1846 ).
35+
36+
Additionally, you can use [Create your first WinUI 3 (Windows App SDK) project](/windows/apps/winui/winui3/create-your-first-winui3-app) to test a sample WinUI 3 project using the Windows App SDK.

‎support/developer/visualstudio/installation/python-development-workload-fails-install-vs-2022.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
---
2+
title: Python Development Workload Fails to Install in Visual Studio
3+
description: Helps resolve an issue where the Python development workload fails to install in Visual Studio.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# The Python development workload fails to install in Visual Studio
10+
11+
_Applies to:_&nbsp; Visual Studio 2022
12+
13+
## Symptoms
14+
15+
The Python development workload fails to install in Visual Studio. In addition, you see the following error message:
16+
17+
```output
18+
Package 'CPython39.Exe.x64,version=3.9.13, chip=x64' failed to download from 'https://go.microsoft.com/fwlink/?linkid=2222466'.
19+
Search URL
20+
https://aka.ms/VSSetupErrorReports?q=PackageId=CPython39.Exe.x64; PackageAction=DownloadPackage; ReturnCode=0x80096004
21+
Details
22+
WebClient download failed: Authenticode verification returned 0x800b0003 for path: python-3.9.13-amd64.exe.
23+
Bits download failed: Timeout reached for job VsBitsDownloadJob - -2114796084 whilst in state BG_JOB_STATE_CONNECTING WinInet download failed: Authenticode verification returned 0x800b0003 for path: python-3.9.13-amd64.exe.
24+
Impacted workloads
25+
Python development (Microsoft.VisualStudio.Workload.Python,version=17.5.33306.270)
26+
Impacted components
27+
Python 3 64-bit (3.9.13) (Component.CPython39.x64,version=3.9.13)
28+
```
29+
30+
## Cause
31+
32+
The Visual Studio Installer can't download the **python-3.9.13-amd64.exe** file from the URL `https://go.microsoft.com/fwlink/?linkid=2222466`.
33+
34+
## Resolution
35+
36+
To resolve the issue, ensure that the necessary domains and servers from which files are downloaded are added to the allowlist.
37+
38+
By adding the necessary domain URLs to the allowlist, you enable the Visual Studio Installer to download the required files and successfully install the Python development workload. For more information on the URLs to add to the allowlist and guidance on installing Visual Studio behind a firewall or proxy server, see [Install and use Visual Studio and Azure Services behind a firewall or proxy server](/visualstudio/install/install-and-use-visual-studio-behind-a-firewall-or-proxy-server).
39+
40+
Once you complete the allowlisting process, you can [install the Python development workload](/visualstudio/python/installing-python-support-in-visual-studio#download-and-install-the-python-workload) in Visual Studio without encountering any download failures.

‎support/developer/visualstudio/installation/set-up-vs-professional-2022-offline-machine.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Set Up Visual Studio on an Offline Machine
3+
description: Describes how to set up Visual Studio on an offline machine.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Offline Install
7+
ms.topic: how-to
8+
---
9+
# Set up Visual Studio on an offline machine
10+
11+
To set up Visual Studio on an offline machine, follow these steps:
12+
13+
1. Download the Visual Studio installer from the [Visual Studio page](https://visualstudio.microsoft.com/vs/).
14+
1. Create an offline installer using the following command line. In this example, **vs_professional.exe** is the Professional edition of Visual Studio, and **VS2022Offline** is the folder where you want to create the layout.
15+
16+
```cmd
17+
"vs_professional.exe" --LayOut "C:\Temp\VS2022Offline" --Lang en-US"
18+
```
19+
20+
1. After successfully creating the offline installer for Visual Studio, copy **C:\Temp\VS2022Offline** to the target offline machine.
21+
1. Once the **C:\Temp\VS2022Offline** folder is copied to the target offline machine, execute the following command line from an administrator command prompt:
22+
23+
```cmd
24+
"C:\Temp\VS2022Offline\vs_professional.exe" --noWeb --channelURI "C:\Temp\VS2022Offline\channelManifest.json"
25+
```
26+
For more information on the command-line parameters, see [Use command-line parameters to install, update, and manage Visual Studio](/visualstudio/install/use-command-line-parameters-to-install-visual-studio).
27+
28+
1. Follow the remaining instructions in the setup wizard to complete the installation.
29+
1. Once the installation is completed successfully, open any browser and browse to the [Microsoft 365 admin center](https://admin.microsoft.com/adminportal/home#/subscriptions/vlnew).
30+
1. Sign in with your Visual Studio subscription account.
31+
1. Navigate to the **Downloads and Keys** tab.
32+
1. Search for **Visual Studio Professional 2022** and select **Key**.
33+
1. Select the 25-digit volume license key and copy it.
34+
1. Launch the Visual Studio shortcut as an administrator.
35+
1. On the menu bar, select **Help** > **Register Product**.
36+
1. Select the **Unlock with a Product Key** link.
37+
1. Enter the 25-digit product key, and then select **Apply**.
38+
39+
## More information
40+
41+
[Create an offline installation package of Visual Studio for local installation](/visualstudio/install/create-an-offline-installation-of-visual-studio)

‎support/developer/visualstudio/installation/toc.yml‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,11 @@
11
- name: Setup, maintenance or uninstall
22
items:
3+
- name: .NET Multi-platform App UI template is missing
4+
href: ./maui-template-missing-vs-2022-professional.md
35
- name: Can't find Windows 10 developer tools
46
href: ./cant-find-win-10-developer-tools-vs-2015.md
7+
- name: Can't install Visual Studio using online installer
8+
href: ./unable-install-vs-2022-online-installer-windows-10-21h2.md
59
- name: Can't update Visual Studio using the Help menu
610
href: ./unable-update-using-help-menu.md
711
- name: Error - Please restart the computer and run setup again
@@ -24,8 +28,12 @@
2428
href: ./install-windows-sdk-silent-mode.md
2529
- name: Known issues when you install Release Management
2630
href: ./release-management-installation-issues.md
31+
- name: License key is invalid when installing Visual Studio
32+
href: ./installation-vs-2022-license-key-shows-invalid.md
2733
- name: Network or proxy errors
2834
href: ./troubleshoot-network-related-errors.md
35+
- name: Python development workload fails to install in Visual Studio
36+
href: ./python-development-workload-fails-install-vs-2022.md
2937
- name: Release Management component doesn't work
3038
href: ./other-release-management-component-no-work.md
3139
- name: Running Parallels on Mac may cause error 1606
@@ -42,8 +50,12 @@
4250
href: ./troubleshoot-installation-issues.md
4351
- name: Uninstall third-party applications in Visual Studio 2015
4452
href: ./secondary-installer-third-party-app.md
53+
- name: Visual Studio installation stops on Windows 10 21H2
54+
href: ./installation-stops-package-10-windows-10-21h2.md
4555
- name: Visual Studio 2015 and 2013 features doesn't work
4656
href: ./visual-studio-2015-2013-feature-not-work.md
57+
- name: Visual Studio online installation fails with error 1625
58+
href: ./visual-studio-2022-online-installation-fails-code-1625.md
4759
- name: Visual Studio requires the April 2014 update
4860
href: ./version-visual-studio-requires-april-2014-update.md
4961
- name: Visual Studio requires a newer version of Windows
@@ -62,6 +74,10 @@
6274
href: ./error-no-internet-connection.md
6375
- name: Error when testing or deploying a minimal layout
6476
href: ./error-test-deploy-minimal-layout.md
77+
- name: Offline installation of Windows App SDK C# extension fails
78+
href: ./offline-installation-windows-app-sdk-extension.md
79+
- name: Set up Visual Studio on an offline machine
80+
href: ./set-up-vs-professional-2022-offline-machine.md
6581
- name: Warnings about an untrusted certificate
6682
href: ./warnings-untrusted-certificate.md
6783
- name: We recommend you close Visual Studio now before setup continues

‎support/developer/visualstudio/installation/unable-install-vs-2022-online-installer-windows-10-21h2.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
title: System Configuration Error Using Online Installer
3+
description: Helps resolve a system configuration error that occurs when you install Visual Studio using the online installer on a Windows 10, version 21H2 machine.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# Unable to install Visual Studio using online installer on a Windows 10, version 21H2 machine
10+
11+
## Symptoms
12+
13+
When you install Visual Studio using the online installer on a Windows 10, version 21H2 machine, it fails with the following error message in the setup logs:
14+
15+
```output
16+
HttpWebRequest& webRequest, String& remoteAddress, CancellationToken cancellationToken)
17+
Download failed using WebClient engine. System.Configuration.ConfigurationErrorsException: Configuration system failed to initialize --->
18+
System.Configuration.ConfigurationErrorsException: Unrecognized element. (C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\machine.config line 141)
19+
```
20+
21+
## Cause
22+
23+
The error message indicates that there's a corrupt or incorrect setting in the **machine.config** file located at **C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\\**.
24+
25+
## Resolution
26+
27+
To solve the issue, follow these steps:
28+
29+
1. Open File Explorer and navigate to the path: **C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\\**.
30+
1. In the **Config** directory, locate the **machine.config** file.
31+
1. Rename the **machine.config** file to create a backup. You can rename it to **machine_bkp.config** or any other name of your choice.
32+
1. Still in the same directory, locate the **machine.config.default** file.
33+
1. Make a copy of the **machine.config.default** file.
34+
1. Rename the new copy of the file to **machine.config**. This file replaces the existing **machine.config** file with the default version.
35+
1. Restart your machine to ensure the changes take effect.
36+
37+
Renaming the **machine.config** file and replacing it with the default version resets the configuration to its original state, which can help resolve any corrupt or incorrect settings that might have caused the Visual Studio bootstrapper to fail during installation.
38+
39+
After restarting your machine, run the Visual Studio online installation again. The bootstrapper should now be able to launch successfully without encountering the `ConfigurationErrorsException` related to the **machine.config** file.

‎support/developer/visualstudio/installation/visual-studio-2022-online-installation-fails-code-1625.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
---
2+
title: Visual Studio Online Installation Fails with Error 1625
3+
description: Helps resolve the error 1625 that occurs when you install Visual Studio using the online installer.
4+
ms.date: 12/27/2024
5+
ms.reviewer: khgupta
6+
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7+
---
8+
9+
# Visual Studio online installation fails with the error code 1625
10+
11+
## Symptoms
12+
13+
When you install Visual Studio online, the process fails with the following error:
14+
15+
> Package 'Microsoft.VisualStudio.Devenv.MSI' fails to install, Return Code 1625.
16+
17+
## Cause
18+
19+
Error code 1625: This installation is prohibited by system policy.
20+
21+
The authorization level returned by the Software Restriction Policy is 0x0 (returned status 0x800b010c). `0x800b010c` usually means that a required certificate is revoked.
22+
23+
Installation isn't allowed under the Software Restriction Policy. Windows Installer can only install unrestricted items.
24+
25+
## Resolution
26+
27+
To resolve the error, follow these steps:
28+
29+
1. Open the **Control Panel** on your machine.
30+
1. Select **Network and Internet** > **Internet Options**.
31+
1. In the **Internet Options** window, select **Content**.
32+
1. Under the **Certificates** section, select **Certificates**.
33+
1. In the **Certificates** window, select **Untrusted Publishers**.
34+
1. Look for any revoked certificates in the list. If you find a revoked certificate, select it and select the **Remove** button to remove it from the list.
35+
1. After removing the revoked certificate, close the **Certificates** window and the **Internet Options** window.
36+
37+
Next, follow these steps to repair your Visual Studio installation using the Visual Studio Installer:
38+
39+
1. Launch the Visual Studio Installer on your machine.
40+
1. In the **Visual Studio Installer** window, locate your installed version of Visual Studio.
41+
1. Select the three dots (**...**) button next to the Visual Studio installation and select **Repair**.
42+
1. Follow the prompts to complete the repair process. The installer can repair your Visual Studio installation and resolve any issues related to the failed package installation.

0 commit comments

Comments
 (0)