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
Copy file name to clipboardExpand all lines: support/developer/visualstudio/installation/troubleshoot-installation-issues.md
+21Lines changed: 21 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,10 +40,15 @@ If a repair doesn't fix your issue, search for your error message in the [Visual
40
40
If you encounter an issue when you try to update the program, try deleting the Visual Studio Installer folder, and then rerun the installation bootstrapper. This action can solve certain update failures. It reinstalls the Visual Studio Installer files and resets the installation metadata. To delete the folder, follow these steps:
41
41
42
42
1. Close the Visual Studio Installer.
43
+
43
44
1. Delete the Visual Studio Installer folder. Typically, the folder path is _C:\Program Files (x86)\Microsoft Visual Studio\Installer_.
45
+
44
46
1. Run the Visual Studio Installer bootstrapper.
47
+
45
48
- You can get the bootstrapper for the latest version of Visual Studio from the [downloads page](https://visualstudio.microsoft.com/downloads). For previous Visual Studio versions, see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads).
49
+
46
50
- You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
51
+
47
52
1. Try again to install or update Visual Studio. If the Visual Studio Installer continues to fail, go to the next section.
48
53
49
54
#### 5. Report the problem to Microsoft Support
@@ -53,11 +58,13 @@ In some situations, corrupted files cause issues that require case-by-case troub
53
58
##### [Visual Studio 2022 and later](#tab/vs-2022-older)
54
59
55
60
1. Collect your setup logs. For details, see [How to get the Visual Studio installation logs](#collect-installation-logs-for-microsoft-support).
61
+
56
62
1. Open the Visual Studio Installer. Then, select **Report a problem** to open the Visual Studio Feedback tool.
57
63
58
64
:::image type="content" source="media/troubleshoot-installation-issues/vs-installer-report-problem.png" alt-text="The Provide feedback button in the Visual Studio Installer." lightbox="media/troubleshoot-installation-issues/vs-installer-report-problem.png":::
59
65
60
66
1. Give your problem report a title, and provide the relevant details. The most recent setup log for the Visual Studio Installer is automatically added to the **Additional attachments** section of your problem report.
67
+
61
68
1. Select **Submit**.
62
69
63
70
##### [Visual Studio 2019 and earlier](#tab/vs-2019-earlier)
@@ -79,9 +86,13 @@ In some situations, corrupted files cause issues that require case-by-case troub
79
86
As a last resort, you can remove all Visual Studio installation files and product information:
80
87
81
88
1.[Remove all files by using InstallCleanup.exe](/visualstudio/install/uninstall-visual-studio#remove).
89
+
82
90
1. Rerun the Visual Studio Installer bootstrapper.
91
+
83
92
- You can get the bootstrapper for the latest version of Visual Studio from the [downloads page](https://visualstudio.microsoft.com/downloads). For previous Visual Studio versions, see the [older downloads page](https://visualstudio.microsoft.com/vs/older-downloads).
93
+
84
94
- You can also find the bootstrapper in your _Downloads_ folder. The bootstrapper is named `VisualStudioSetup.exe` for Visual Studio 2022 and later, or `vs_<edition>.exe` for Visual Studio 2019 and earlier.
95
+
85
96
1. Try again to reinstall Visual Studio.
86
97
87
98
#### 7. Roll back to a previous install (Visual Studio 2022 and later)
@@ -94,11 +105,15 @@ If none of the previous steps help you to successfully update Visual Studio, you
94
105
##### Roll back by using the Visual Studio Installer
95
106
96
107
1. Start **Visual Studio Installer** on your computer.
108
+
97
109
1. In the installer, look for the edition of Visual Studio to match the installed edition.
110
+
98
111
1. Select **More**.
112
+
99
113
1. Select **Rollback to previous version**.
100
114
101
115
:::image type="content" source="media/troubleshoot-installation-issues/rollback-from-previous-version.png" alt-text="Option to roll back to a previous program version." lightbox="media/troubleshoot-installation-issues/rollback-from-previous-version.png":::
116
+
102
117
1. To confirm the action, select **OK**.
103
118
104
119
##### Roll back by using the command line
@@ -126,8 +141,11 @@ Various situations can prevent administrator updates from applying correctly. Fo
126
141
To provide feedback about Visual Studio administrator updates, or to report issues that affect the updates, use the following methods:
127
142
128
143
- Ask questions of the user community at the [Visual Studio Setup Q&A Forum](/answers/topics/vs-setup.html).
144
+
129
145
- Go to the [Visual Studio support page](https://visualstudio.microsoft.com/vs/support/), and check whether your issue is listed in the FAQ.
146
+
130
147
-[Provide feature feedback or report a problem](https://aka.ms/vs/wsus/feedback) to the Visual Studio team about your experience.
148
+
131
149
- Contact your organization's technical accounts manager for Microsoft.
132
150
133
151
## Collect installation logs for Microsoft Support
@@ -137,7 +155,9 @@ A Microsoft Support agent might ask you to collect setup logs by using the [Micr
137
155
To collect the logs, follow these steps:
138
156
139
157
1.[Download the tool](https://aka.ms/vscollect).
158
+
140
159
1. Open an elevated Command Prompt window.
160
+
141
161
1. Run `Collect.exe` in the folder where you saved the tool.
142
162
143
163
You must run the tool under the same user account that you used for the failed installation attempt. If you run the tool from a different user account, set the `-user:<name>` option to specify the user account for the failed installation. For more options and usage information, run `Collect.exe -?` at an elevated command prompt.
@@ -151,6 +171,7 @@ Report product issues by using the [Report a Problem](/visualstudio/ide/how-to-r
151
171
If your organization's Group Policy settings block the installation of the WebView2 component, you can't install Visual Studio because the installer requires WebView2. If this issue occurs, check these policies:
152
172
153
173
- If the [Microsoft Edge 'Install (WebView)'](/deployedge/microsoft-edge-update-policies#install-webview) policy is configured, that policy determines whether WebView2 can be installed.
174
+
154
175
- If the _Microsoft Edge 'Install (WebView)' policy_ isn't configured, the [Microsoft Edge 'InstallDefault'](/deployedge/microsoft-edge-update-policies#installdefault) policy determines whether WebView2 can be installed.
0 commit comments