Résolution des problèmes d’installation et de mise à niveau de Visual Studio 2017Troubleshoot Visual Studio 2017 installation and upgrade issues

Important

Vous rencontrez un problème d’installation ?Having a problem installing? Nous pouvons vous aider.We can help. Nous proposons une option de support Conversation en direct (en anglais uniquement).We offer a live chat (English only) support option.

Ce guide de résolution des problèmes inclut des instructions détaillées qui doivent permettre de résoudre la plupart des problèmes d’installation.This troubleshooting guide includes step-by-step instructions that should resolve most installation issues.

Guide pratique pour résoudre les problèmes liés à une installation en ligneHow to troubleshoot an online installation

Les étapes suivantes sont optimisées pour une installation en ligne classique.The following steps are optimized for a typical online installation. Pour tout problème affectant une installation hors connexion, consultez Guide pratique pour résoudre les problèmes liés à une installation hors connexion.For an issue that affects an offline installation, please see How to troubleshoot an offline installation.

Étape 1 : Vérifier si ce problème est un problème connuStep 1 - Check whether this problem is a known issue

Il existe certains problèmes connus avec le programme d’installation de Visual Studio que Microsoft s’emploie à résoudre.There are some known issues with the Visual Studio Installer that Microsoft is working on fixing. Pour savoir s’il existe une solution de contournement à votre problème, consultez la section Problèmes connus des notes de publication.To see if there's a workaround for your problem, check the Known Issues section of our release notes.

Étape 2 : Vérifier auprès de la communauté de développeursStep 2 - Check with the developer community

Effectuez une recherche à partir de votre message d’erreur auprès de la Communauté de développeurs Visual Studio.Search on your error message with the Visual Studio Developer Community. D’autres membres de la communauté ont peut-être une solution documentée à votre problème.Other members of the community might have documented a solution to your problem.

Étape 3 : Supprimer le répertoire du programme d’installation de Visual Studio pour résoudre les problèmes de mise à niveauStep 3 - Delete the Visual Studio Installer directory to fix upgrade problems

Le programme d’amorçage du programme d’installation de Visual Studio est un exécutable léger minimal qui installe le reste du programme d’installation de Visual Studio.The Visual Studio Installer bootstrapper is a minimal light-weight executable that installs the rest of the Visual Studio Installer. La suppression des fichiers du programme d’installation de Visual Studio, puis la réexécution du programme d’amorçage peuvent résoudre certains échecs de mise à jour.Deleting Visual Studio Installer files and then rerunning the bootstrapper might solve some update failures.

Note

Effectuer les actions suivantes réinstalle les fichiers de Visual Studio Installer et réinitialise les métadonnées d’installation.Performing the following actions reinstalls the Visual Studio Installer files and resets the installation metadata.

  1. Fermez le programme d’installation de Visual Studio.Close the Visual Studio Installer.
  2. Supprimez le répertoire du programme d’installation de Visual Studio.Delete the Visual Studio Installer directory. En règle générale, le répertoire est C:\Program Files (x86)\Microsoft Visual Studio\Installer.Typically, the directory is C:\Program Files (x86)\Microsoft Visual Studio\Installer.
  3. Exécutez le programme d’amorçage du programme d’installation de Visual Studio.Run the Visual Studio Installer bootstrapper. Vous pouvez trouver le programme d’amorçage dans votre dossier Téléchargements sous un nom respectant le modèle vs_[Visual Studio edition]__*.exe.You might find the bootstrapper in your Downloads folder with a file name that follows a vs_[Visual Studio edition]__*.exe pattern. Si vous ne trouvez pas cette application, vous pouvez télécharger le programme d’amorçage en accédant à la page des téléchargements Visual Studio, puis en cliquant sur le bouton Téléchargement correspondant à votre édition de Visual Studio.If you don't find that application, you can download the bootstrapper by going to the Visual Studio downloads page and clicking Download for your edition of Visual Studio. Exécutez ensuite l’exécutable pour réinitialiser vos métadonnées d’installation.Then, run the executable to reset your installation metadata.
  4. Essayez à nouveau d’installer ou de mettre à jour Visual Studio.Try to install or update Visual Studio again. Si le programme d’installation échoue à nouveau, passez à l’étape suivante.If the Installer continues to fail, go to the next step.

Étape 4 : Signaler un problèmeStep 4 - Report a problem

Dans certaines situations (fichiers endommagés, par exemple), vous devrez peut-être examiner les problèmes au cas par cas.In some situations, such as those related to corrupted files, the problems might have to be looked at on a case-by-case basis. Pour que nous puissions vous aider, effectuez les actions suivantes :To help us help you, please do the following:

  1. Collecter vos journaux d’installation.Collect your setup logs. Pour plus d’informations, consultez Guide pratique pour obtenir les journaux d’installation Visual Studio.See How to get the Visual Studio installation logs for details.
  2. Ouvrez le programme d’installation de Visual Studio, puis cliquez sur Signaler un problème pour ouvrir l’outil Commentaires sur Visual Studio.Open the Visual Studio Installer, and then click Report a problem to open the Visual Studio Feedback tool. Vous pouvez accéder par tabulation au bouton Fournir des commentaires pour ouvrir l’outil CommentairesYou can tab to the Provide Feedback button to open the feedback tool
  3. Indiquez le titre du problème signalé et les détails pertinents.Give your problem report a title, and provide relevant details. Cliquez sur Suivant pour accéder à la section Pièces jointes, puis joignez le fichier journal généré (le fichier est généralement situé à l’emplacement %TEMP%\vslogs.zip).Click Next to go to the Attachments section, and then attach the generated log file (typically, the file is at %TEMP%\vslogs.zip).
  4. Cliquez sur Suivant pour vérifier le problème signalé, puis sur Envoyer.Click Next to review your problem report, and then click Submit.

Étape 5 : Exécuter InstallCleanup.exe pour nettoyer les fichiers d’installationStep 5 - Run InstallCleanup.exe to remove installation files

En dernier recours, vous pouvez désinstaller Visual Studio pour supprimer tous les fichiers d’installation et les informations produit.As a last resort, you can remove Visual Studio to remove all installation files and product information.

  1. Suivez les instructions de la rubrique Supprimer Visual Studio.Follow the instructions in Remove Visual Studio.
  2. Exécutez à nouveau le programme d’amorçage dans Étape 3 : supprimer le répertoire de Visual Studio Installer pour résoudre les problèmes de mise à niveau.Rerun the bootstrapper that's described in Step 3 - Delete the Visual Studio Installer directory to fix upgrade problems.
  3. Essayez à nouveau d’installer ou de mettre à jour Visual Studio.Try to install or update Visual Studio again.

Étape 6 : Nous contacter (facultatif)Step 6 - Contact us (optional)

Si aucune des étapes précédentes ne vous permet d’installer ou de mettre à niveau Visual Studio correctement, contactez-nous via notre option de support Conversation en direct (en anglais uniquement) pour obtenir une assistance supplémentaire.If none of the previous steps help you successfully install or upgrade Visual Studio, contact us by using our live chat support option (English only) for further assistance.

Guide pratique pour résoudre les problèmes liés à une installation hors connexionHow to troubleshoot an offline installation

Voici un tableau des problèmes connus et de certaines solutions de contournement qui peuvent vous aider quand vous effectuez une installation dans une topologie locale.Here is a table of known issues and some workarounds that might help you when you install from a local layout.

ProblèmeIssue ÉlémentItem SolutionSolution
Les utilisateurs n’ont pas accès aux fichiers.Users do not have access to files. autorisations (ACL)permissions (ACLs) Vérifiez que vous ajustez les autorisations (ACL) de sorte qu’elles accordent un accès en lecture aux autres utilisateurs avant de partager l’installation hors connexion.Make sure that you adjust the permissions (ACLs) so that they grant Read access to other users before you share the offline install.
L’installation des nouvelles charges de travail, langues et des nouveaux composants a échoué.New workloads, components, or languages fail to install. --layout Assurez-vous d’avoir un accès Internet si vous installez depuis une disposition partielle et sélectionnez des charges de travail, composants ou langues non téléchargés préalablement dans cette disposition partielle.Make sure that you have internet access if you install from a partial layout and select workloads, components, or languages that were not downloaded previously in that partial layout.

Guide pratique pour obtenir les journaux d’installation de Visual StudioHow to get Visual Studio installation logs

Les journaux d’installation sont nécessaires pour résoudre la plupart des problèmes d’installation.Setup logs are needed to troubleshoot most installation issues. Lorsque vous envoyez un problème à l’aide de Signaler un problème dans Visual Studio Installer, ces journaux sont automatiquement inclus dans votre rapport.When you submit an issue by using Report a Problem in the Visual Studio Installer, these logs are automatically included in your report.

Si vous contactez le Support Microsoft, vous devrez peut-être fournir ces journaux d’installation à l’aide de l’outil Microsoft Visual Studio and .NET Framework Log Collection Tool.If you contact Microsoft Support, you might need to provide these setup logs by using the Microsoft Visual Studio and .NET Framework Log Collection Tool. L’outil de collecte des journaux permet de collecter des journaux d’installation à partir de tous les composants installés par Visual 2017 Studio, y compris .NET Framework, Kit SDK Windows et SQL Server.The log collection tool collects setup logs from all components installed by Visual Studio 2017, including .NET Framework, Windows SDK, and SQL Server. Il permet également de collecter des informations sur l’ordinateur, un inventaire de Windows Installer et des informations du journal des événements Windows pour Visual Studio Installer, le programme d’installation de Windows et la restauration du système.It also collects computer information, a Windows Installer inventory, and Windows event log information for Visual Studio Installer, Windows Installer, and System Restore.

Pour collecter les journaux :To collect the logs:

  1. Télécharger l’outil.Download the tool.
  2. Ouvrez une invite de commandes d’administration.Open an administrative command prompt.
  3. Exécutez Collect.exe à partir du répertoire dans lequel vous avez enregistré l’outil.Run Collect.exe from the directory where you saved the tool.
  4. Le fichier vslogs.zip résultant se trouve dans le répertoire %TEMP%, par exemple, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.Find the resulting vslogs.zip file in your %TEMP% directory, for example, C:\Users\YourName\AppData\Local\Temp\vslogs.zip.

Note

L’outil doit être exécuté sous le même compte utilisateur que l’installation défaillante.The tool must be run under the same user account that the failed installation was run under. Si vous exécutez l’outil à partir d’un autre compte utilisateur, définissez l’option –user:<name> permettant de spécifier le compte utilisateur sous lequel l’installation défaillante a été exécutée.If you are running the tool from a different user account, set the –user:<name> option to specify the user account under which the failed installation was run. Exécutez Collect.exe -? à partir d’une invite de commandes d’administration pour des options supplémentaires et des informations d’utilisation.Run Collect.exe -? from an administrator command prompt for additional options and usage information.

Obtenir de l’aide en directGet live help

Si les solutions listées dans ce guide de résolution des problèmes ne vous permettent pas d’installer ou de mettre à niveau Visual Studio correctement, utilisez notre option de support Conversation en direct (en anglais uniquement) pour obtenir une assistance supplémentaire.If the solutions listed in this troubleshooting guide do not help you to successfully install or upgrade Visual Studio, use our live chat support option (English only) for further assistance.

Voir aussiSee also