You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Troubleshoot Visual Studio 2017 or Later Install Errors
3
-
description: Learn how to troubleshoot and resolve Visual Studio installation failures, including online and offline setup issues, with clear, actionable steps.
2
+
title: Troubleshoot Visual Studio 2017 or Later Installation Errors
3
+
description: Learn how to troubleshoot and resolve Visual Studio installation failures, including online and offline setup issues.
4
4
ms.date: 12/30/2025
5
5
ms.reviewer: khgupta, v-shaywood
6
6
ms.custom: sap:Installation\Setup, maintenance, or uninstall
7
7
---
8
8
9
-
# Unable to install Visual Studio 2017 or later versions
9
+
# Installation fails for Visual Studio 2017 or later
10
10
11
11
_Applies to:_ Visual Studio 2017 and later versions
12
12
13
-
When you try to install Visual Studio 2017 or a later version, you might encounter a problem where the installation wizard unexpectedly closes or returns an error message that indicates it couldn't download some installation files. This article provides a solution that resolves these installation problems and enables you to successfully install Visual Studio.
13
+
When you try to install Microsoft Visual Studio 2017 or a later version, the installation wizard unexpectedly closes or indicates that it can't download some installation files. This article resolves these problems and enables you to successfully install Visual Studio.
14
14
15
15
## Symptoms
16
16
17
-
The symptoms of this problem depend on whether you're attempting an [online install](/visualstudio/install/install-visual-studio) or an [offline install](/visualstudio/install/create-an-offline-installation-of-visual-studio).
17
+
The symptoms of this problem depend on whether you're trying an [online installation](/visualstudio/install/install-visual-studio) or an [offline installation](/visualstudio/install/create-an-offline-installation-of-visual-studio).
18
18
19
-
### Online install
19
+
### Online installation
20
20
21
-
When you attempt an _online install_ of Visual Studio 2017 or a later version, the installation wizard shows the following message dialog:
21
+
When you try an _online installati9on_ of Visual Studio 2017 or a later version, the installation wizard displays the following message:
22
22
23
23
> Before you get started, we need to set up a few things so that you can configure your installation.
24
24
25
-
:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-set-up-things.png" alt-text="Screenshot of the Visual Studio installation wizard with a message that the installer needs to set up a few things so that you can configure your installation":::
25
+
:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-set-up-things.png" alt-text="Visual Studio installation wizard message about configuring the installation.":::
26
26
27
-
After you select **Continue** in the message dialog, the installation wizard closes and the install stops.
27
+
After you select **Continue** in the message dialog box, the installation wizard closes and the installation stops.
28
28
29
-
### Offline install
29
+
### Offline installation
30
30
31
-
When you attempt an _offline install_ of Visual Studio 2017 or a later version on a device with no or limited internet access, the installation wizard shows the following error dialog:
31
+
When you try an _offline installation_ of Visual Studio 2017 or a later version on a device that has limited or no internet access, the installation wizard displays the following error message:
32
32
33
33
> Unable to download installation files. Check your internet connection and try again.
34
34
35
-
:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-download-error.png" alt-text="Screenshot of the Visual Studio installation wizard with an error message that the installer was unable to download installation files":::
35
+
:::image type="content" source="./media/install-failure-2017-later-versions/install-wizard-download-error.png" alt-text="Visual Studio installation wizard error message that states that the installer can't download installation files.":::
36
36
37
-
If your device has event logging enabled for the [CryptoAPI (CAPI2)](/windows/win32/seccrypto/cryptography--cryptoapi--and-capicom), you also see the following error in the CAPI2 [Event Viewer](/host-integration-server/core/windows-event-viewer1) logs (Event ID 30):
37
+
If your device has event logging enabled for the [CryptoAPI (CAPI2)](/windows/win32/seccrypto/cryptography--cryptoapi--and-capicom), you also see the following error message in the CAPI2 [Event Viewer](/host-integration-server/core/windows-event-viewer1) logs (Event ID 30):
38
38
39
-
:::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-capi2-errors.png" alt-text="Screenshot of the Event Viewer showing multiple CAPI2 errors with Event ID 30":::
39
+
:::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-capi2-errors.png" alt-text="Event Viewer display that shows multiple CAPI2 errors and Event ID 30.":::
40
40
41
41
```xml
42
42
<Event>
@@ -57,40 +57,39 @@ If your device has event logging enabled for the [CryptoAPI (CAPI2)](/windows/wi
57
57
</Event>
58
58
```
59
59
60
-
You can access the CAPI2 event logs from the Event Viewer by going to **Applications and Services Logs** > **Microsoft** > **Windows** > **CAPI2** > **Operational**.
60
+
To access the CAPI2 event logs from the Event Viewer, go to **Applications and Services Logs** > **Microsoft** > **Windows** > **CAPI2** > **Operational**.
61
61
62
62
#### Enable CAPI2 logs
63
63
64
-
Use the following steps to enable CAPI2 event logging:
64
+
To enable CAPI2 event logging, follow these steps:
65
65
66
-
1. Open Event Viewer by pressing <kbd>Win</kbd> + <kbd>R</kbd>, type _eventvwr_, and then press <kbd>Enter</kdb>.
67
-
1.Go to **Applications and Services Logs** > **Microsoft** > **Windows** > **CAPI2** > **Operational**.
68
-
1.Right-click **Operational** and select **Clear Log** to delete any previous logs.
69
-
1.Right-click **Operational** and select **Enable Log** to start logging.
66
+
1. Open Event Viewer by pressing <kbd>Win</kbd> + <kbd>R</kbd>, type _eventvwr_, and then pressing <kbd>Enter</kdb>.
67
+
1.Navigate to **Applications and Services Logs** > **Microsoft** > **Windows** > **CAPI2** > **Operational**.
68
+
1.To delete any previous logs, right-click **Operational**, and then select **Clear Log**.
69
+
1.To start logging, right-click **Operational**, and then select **Enable Log**.
70
70
71
-
:::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-enable-capi2-logs.png" alt-text="Screenshot of the Event Viewer with the right-click menu to clear or enable logs for CAPI2":::
71
+
:::image type="content" source="./media/install-failure-2017-later-versions/event-viewer-enable-capi2-logs.png" alt-text="Event Viewer showing the right-click menu to clear or enable logs for CAPI2.":::
72
72
73
-
1. Try installing Visual Studio again by using the offline installer.
74
-
1. After reproducing the issue, the CAPI2 event logs should contain details about the install failure.
75
-
1. To stop logging, right-click **Operation** and select **Disable Log**.
73
+
1. Try again to install Visual Studio by using the offline installer.
74
+
1. After you reproduce the problem, the CAPI2 event logs should contain details about the installation failure.
75
+
1. To stop logging, right-click **Operation**, and then select **Disable Log**.
76
76
77
77
## Cause
78
78
79
79
This problem can occur for one of the following reasons, depending on the type of installation:
80
80
81
-
-_Offline install_: The device doesn't have the latest [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate that Visual Studio uses.
82
-
-_Online install_: The device's internet access is restricted and the user doesn't have permission to download the [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate.
81
+
-_Offline installation_: The device doesn't have the latest [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate that Visual Studio uses.
82
+
-_Online installation_: The device's internet access is restricted, and the user doesn't have permission to download the [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate.
83
83
84
84
## Solution
85
85
86
-
Use the following steps to resolve this problem:
86
+
To resolve this problem, follow these steps:
87
87
88
88
1. Download the [Microsoft Windows Code Signing PCA 2024](https://www.microsoft.com/pkiops/certs/Microsoft%20Windows%20Code%20Signing%20PCA%202024.crt) certificate by using a device that has internet access.
89
-
1. Copy the certificate file to `C:\Temp` on the device that has installation problems.
90
-
1. Install the _Microsoft Windows Code Signing PCA 2024_ certificate into the [Trusted Root Certification Authorities store](/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store) by running the following command from an elevated command prompt:
89
+
1. Copy the certificate file to `C:\Temp` on the device that experiences the installation problem.
90
+
1. Install the _Microsoft Windows Code Signing PCA 2024_ certificate in the [Trusted Root Certification Authorities store](/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store). To do this, run the following command in an elevated Command Prompt window:
91
91
92
92
```cli
93
93
CertUtil -addStore CA "C:\Temp\Microsoft Windows Code Signing PCA 2024.crt"
94
94
```
95
-
96
-
1. Try installing Visual Studio again by using the offline installer.
95
+
1. Try again to install Visual Studio by using the offline installer.
0 commit comments