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

SymptômesSymptoms

Quand vous essayez d’installer ou de mettre à jour Visual Studio 2017, l’opération échoue.When you try to install or update Visual Studio 2017, the operation fails.

Solution de contournementWorkaround

Pour contourner ce problème, effectuez les étapes suivantes.To work around this issue, follow these steps.

É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 documenté une solution à votre problème.Other members of the community may 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 au format vs_[Visual Studio edition]__*.exe.You may 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 l’exécutable pour réinitialiser les métadonnées d’installation.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 certains cas (fichiers endommagés, par exemple), il peut se révéler nécessaire de résoudre les problèmes de manière individuelle :In some situations, such as those related to corrupted files, the problems may have to be looked at on a case-by-case basis:

  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 étape ne vous a permis de procéder à l’installation, vous pouvez nous contacter pour une conversation en direct pour une assistance à l’installation (en anglais uniquement).If none of the other steps allow you to successfully install, you can contact us by live chat for installation assistance (English only). Pour plus de détails, consultez la page du support Visual Studio.For details, see the Visual Studio support page.

Comment résoudre les problèmes d’un programme d’installation hors connexionHow to troubleshoot an offline installer

Voici un tableau susceptible de vous aider qui présente des problèmes connus et certaines solutions de contournement lors de l’installation à partir d’une disposition locale.Here is a table of known issues and some workarounds when installing from a local layout that might help.

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 Visual StudioHow to get the 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 fichiers journaux d’installation à l’aide de l’outil de collecte des journaux Microsoft Visual Studio et .NET Framework.If you contact Microsoft Support, you may 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.

Autres options de supportMore support options

Si aucune étape ne vous a permis de procéder à l’installation, vous pouvez nous contacter pour une conversation en direct pour une assistance à l’installation (en anglais uniquement).If none of the other steps allow you to successfully install, you can contact us by live chat for installation assistance (English only). Pour plus de détails, consultez la page du support Visual Studio.For details, see the Visual Studio support page.

Voici d’autres options :Here are a few more options:

Voir aussiSee also