Skip to content

Commit 2af1204

Browse files
authored
Update install-failure-2017-later-versions.md
Edit review per CI 8820
1 parent 70f221c commit 2af1204

1 file changed

Lines changed: 30 additions & 31 deletions

File tree

Lines changed: 30 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,42 @@
11
---
2-
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.
44
ms.date: 12/30/2025
55
ms.reviewer: khgupta, v-shaywood
66
ms.custom: sap:Installation\Setup, maintenance, or uninstall
77
---
88

9-
# Unable to install Visual Studio 2017 or later versions
9+
# Installation fails for Visual Studio 2017 or later
1010

1111
_Applies to:_ Visual Studio 2017 and later versions
1212

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.
1414

1515
## Symptoms
1616

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).
1818

19-
### Online install
19+
### Online installation
2020

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:
2222

2323
> Before you get started, we need to set up a few things so that you can configure your installation.
2424
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.":::
2626

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.
2828

29-
### Offline install
29+
### Offline installation
3030

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:
3232

3333
> Unable to download installation files. Check your internet connection and try again.
3434
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.":::
3636

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):
3838

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.":::
4040

4141
```xml
4242
<Event>
@@ -57,40 +57,39 @@ If your device has event logging enabled for the [CryptoAPI (CAPI2)](/windows/wi
5757
</Event>
5858
```
5959

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**.
6161

6262
#### Enable CAPI2 logs
6363

64-
Use the following steps to enable CAPI2 event logging:
64+
To enable CAPI2 event logging, follow these steps:
6565

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**.
7070

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.":::
7272

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**.
7676

7777
## Cause
7878

7979
This problem can occur for one of the following reasons, depending on the type of installation:
8080

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.
8383

8484
## Solution
8585

86-
Use the following steps to resolve this problem:
86+
To resolve this problem, follow these steps:
8787

8888
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:
9191

9292
```cli
9393
CertUtil -addStore CA "C:\Temp\Microsoft Windows Code Signing PCA 2024.crt"
9494
```
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

Comments
 (0)