Skip to content

Commit 70f221c

Browse files
committed
Add cause section and adjust applies to
1 parent 528e174 commit 70f221c

5 files changed

Lines changed: 17 additions & 10 deletions

File tree

support/developer/visualstudio/installation/install-failure-2017-2019-2022.md renamed to support/developer/visualstudio/installation/install-failure-2017-later-versions.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,42 @@
11
---
2-
title: Troubleshoot Visual Studio 2017, 2019, and 2020 Installation Failures
2+
title: Troubleshoot Visual Studio 2017 or Later Install Errors
33
description: Learn how to troubleshoot and resolve Visual Studio installation failures, including online and offline setup issues, with clear, actionable steps.
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, 2019, or 2022
9+
# Unable to install Visual Studio 2017 or later versions
1010

11-
_Applies to:_ Visual Studio 2017, 2019, and 2022
11+
_Applies to:_ Visual Studio 2017 and later versions
1212

13-
When you try to install Visual Studio 2017, 2019, or 2022, 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 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.
1414

1515
## Symptoms
1616

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

1919
### Online install
2020

21-
When you attempt an _online install_ of Visual Studio 2017, 2019, or 2022, the installation wizard shows the following message dialog:
21+
When you attempt an _online install_ of Visual Studio 2017 or a later version, the installation wizard shows the following message dialog:
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-2019-2022/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="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":::
2626

2727
After you select **Continue** in the message dialog, the installation wizard closes and the install stops.
2828

2929
### Offline install
3030

31-
When you attempt an _offline install_ of Visual Studio 2017, 2019, or 2022 on a device with no or limited internet access, the installation wizard shows the following error dialog:
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:
3232

3333
> Unable to download installation files. Check your internet connection and try again.
3434
35-
:::image type="content" source="./media/install-failure-2017-2019-2022/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="Screenshot of the Visual Studio installation wizard with an error message that the installer was unable to download installation files":::
3636

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

39-
:::image type="content" source="./media/install-failure-2017-2019-2022/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="Screenshot of the Event Viewer showing multiple CAPI2 errors with Event ID 30":::
4040

4141
```xml
4242
<Event>
@@ -68,12 +68,19 @@ Use the following steps to enable CAPI2 event logging:
6868
1. Right-click **Operational** and select **Clear Log** to delete any previous logs.
6969
1. Right-click **Operational** and select **Enable Log** to start logging.
7070

71-
:::image type="content" source="./media/install-failure-2017-2019-2022/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="Screenshot of the Event Viewer with the right-click menu to clear or enable logs for CAPI2":::
7272

7373
1. Try installing Visual Studio again by using the offline installer.
7474
1. After reproducing the issue, the CAPI2 event logs should contain details about the install failure.
7575
1. To stop logging, right-click **Operation** and select **Disable Log**.
7676

77+
## Cause
78+
79+
This problem can occur for one of the following reasons, depending on the type of installation:
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.
83+
7784
## Solution
7885

7986
Use the following steps to resolve this problem:

support/developer/visualstudio/installation/media/install-failure-2017-2019-2022/event-viewer-capi2-errors.png renamed to support/developer/visualstudio/installation/media/install-failure-2017-later-versions/event-viewer-capi2-errors.png

File renamed without changes.

support/developer/visualstudio/installation/media/install-failure-2017-2019-2022/event-viewer-enable-capi2-logs.png renamed to support/developer/visualstudio/installation/media/install-failure-2017-later-versions/event-viewer-enable-capi2-logs.png

File renamed without changes.

support/developer/visualstudio/installation/media/install-failure-2017-2019-2022/install-wizard-download-error.png renamed to support/developer/visualstudio/installation/media/install-failure-2017-later-versions/install-wizard-download-error.png

File renamed without changes.

support/developer/visualstudio/installation/media/install-failure-2017-2019-2022/install-wizard-set-up-things.png renamed to support/developer/visualstudio/installation/media/install-failure-2017-later-versions/install-wizard-set-up-things.png

File renamed without changes.

0 commit comments

Comments
 (0)