Mettre à jour une installation réseau de Visual StudioUpdate a network-based installation of Visual Studio

Il est possible de mettre à jour une disposition d’installation réseau de Visual Studio avec les dernières mises à jour de produit, afin de pouvoir l’utiliser comme point d’installation de la dernière mise à jour de Visual Studio, et pour gérer aussi les installations déjà déployées sur les stations de travail clientes.It's possible to update a network installation layout of Visual Studio with the latest product updates so that it can be used both as an installation point for the latest update of Visual Studio and also to maintain installations that are already deployed to client workstations.

Comment mettre à jour une disposition réseauHow to update a network layout

Important

Ces instructions supposent que vous avez déjà créé une disposition d’installation réseau.These instructions assume that you've previously created a network installation layout. Pour plus d’informations sur la façon de procéder, consultez la page créer une installation réseau de Visual Studio .For more information about how to do so, see the Create a network installation of Visual Studio page.

Pour actualiser le partage d’installation réseau et inclure les dernières mises à jour, exécutez la commande --layout pour télécharger de manière incrémentielle les packages mis à jour.To refresh your network install share so that it includes the latest updates, run the --layout command to incrementally download updated packages.

Nouveauté de 15,3: Si vous avez sélectionné une disposition partielle lorsque vous avez créé la disposition du réseau, ces paramètres sont enregistrés.New in 15.3: If you selected a partial layout when you first created the network layout, those settings are saved. Toutes les commandes de disposition futures utilisent les options précédentes ainsi que toutes les nouvelles options que vous indiquez.Any future layout commands use the previous options plus any new options that you specify. Si vous vous servez d’une disposition d’une version antérieure, vous devez utiliser les mêmes paramètres de ligne de commande que ceux que vous avez utilisés quand vous avez créé la disposition d’installation réseau (autrement dit, les mêmes charges de travail et langues) pour mettre à jour son contenu.But if you are using a layout of an earlier version, you should use the same command-line parameters that you used when you first created the network install layout (in other words, the same workloads and languages) to update its content.

Si vous avez sélectionné une disposition partielle lorsque vous avez créé la disposition du réseau, ces paramètres sont enregistrés.If you selected a partial layout when you first created the network layout, those settings are saved. Toutes les commandes de disposition futures utilisent les options précédentes ainsi que toutes les nouvelles options que vous indiquez.Any future layout commands use the previous options plus any new options that you specify.

Si vous hébergez une disposition sur un partage de fichiers, vous devez mettre à jour une copie privée de la disposition (par exemple, c:\VSLayout), puis, une fois que tout le contenu mis à jour est téléchargé, copiez-le dans votre partage de fichiers (par exemple, \ server\products\VS).If you host a layout on a file share, you should update a private copy of the layout (for example, c:\VSLayout) and then, after all of the updated content is downloaded, copy it to your file share (for example, \server\products\VS). Si vous ne le faites pas, il est très probable que les utilisateurs exécutant le programme d’installation pendant que vous mettez à jour la disposition ne soient pas en mesure de récupérer tout le contenu de la disposition, puisque celui-ci n’est pas encore totalement à jour.If you don't do this, there is a greater chance that any users who run Setup while you are updating the layout might not be able to get all of the content from the layout because it is not yet completely updated.

Intéressons-nous de plus près à quelques exemples de création et de mise à jour d’une disposition :Let's walk through a few examples of how to create and then update a layout:

  • Tout d’abord, voyons un exemple montrant comment créer une disposition avec une charge de travail pour l’anglais uniquement :First, here's an example of how to create a layout with one workload for English only:

    vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US
    
  • Voici comment mettre à jour cette même disposition vers une version plus récente.Here's how to update that same layout to a newer version. Vous n’êtes pas obligé de spécifier les paramètres de ligne de commande supplémentaires.You don't have to specify any additional command-line parameters. Les paramètres précédents étaient enregistrés et ils vont être utilisés par toutes les commandes de disposition suivantes dans ce dossier de disposition.The previous settings were saved and will be used by any subsequent layout commands in this layout folder.

    vs_enterprise.exe --layout c:\VSLayout
    
  • Voici comment mettre à jour votre disposition avec une version plus récente en mode sans assistance.Here's how to update your layout to a newer version in an unattended manner. L’opération de disposition exécute le processus d’installation dans une nouvelle fenêtre de console.The layout operation runs the setup process in a new console window. La fenêtre reste ouverte pour que les utilisateurs puissent voir le résultat final, ainsi qu’un récapitulatif des erreurs qui se sont produites.The window is left open so users can see the final result and a summary of any errors that might have occurred. Si vous effectuez une opération de disposition en mode sans assistance (par exemple, si vous avez un script qui est exécuté régulièrement pour mettre à jour votre disposition vers la version la plus récente), utilisez le paramètre --passive pour que le processus ferme automatiquement la fenêtre.If you are performing a layout operation in an unattended manner (for example, you have a script that is regularly run to update your layout to the latest version), then use the --passive parameter and the process will automatically close the window.

    vs_enterprise.exe --layout c:\VSLayout --passive
    
  • Voici comment ajouter une charge de travail supplémentaire et une langue localisée.Here's how to add an additional workload and localized language. (Cette commande ajoute la charge de travail développement Azure .) Désormais, Managed Desktop et Azure sont inclus dans cette disposition.(This command adds the Azure development workload.) Now both Managed Desktop and Azure are included in this layout. Les ressources de langue pour l’anglais et l’allemand sont également englobées pour toutes ces charges de travail.The language resources for English and German are also included for all these workloads. De plus, la disposition est mise à jour avec la dernière version disponible.And, the layout is updated to the latest available version.

    vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE
    

    Important

    Une opération de mise à jour n’installe pas les composants facultatifs nouvellement ajoutés.An update operation doesn't install newly added optional components. Si vous avez besoin des composants facultatifs nouvellement ajoutés, supprimez les anciens composants facultatifs dans le Layout.JSON fichier réponse et incluez les composants dont vous avez besoin dans la section « ajouter » de Layout.JSON .If you need the newly added optional components, please remove the old optional components in the Layout.JSON response file and include the components you need in the "add" section of Layout.JSON.

    Solution de contournement: exécutez une opération de modification distincte après une mise à niveau pour installer les composants manquants.Workaround: Run a separate modify operation after an upgrade to install the missing components.

  • Et pour finir, voici comment ajouter une charge de travail et une langue localisée supplémentaires sans mettre à jour la version.And finally, here's how to add an additional workload and localized language without updating the version. (Cette commande ajoute la charge de travail de développement Web et ASP.net .) Les charges de travail de développement Web, Azure et & ASP.NET sont désormais incluses dans cette disposition.(This command adds the ASP.NET and web development workload.) Now the Managed Desktop, Azure, and ASP.NET & Web Development workloads are included in this layout. Les ressources de langue pour l’anglais, l’allemand et le français sont également englobées pour toutes ces charges de travail.The language resources for English, German, and French are also included for all these workloads. Toutefois, la disposition n’a été pas mise à jour vers la toute dernière version disponible lors de l’exécution de cette commande.However, the layout was not updated to the latest available version when this command was run. Elle reste à la version existante.It remains at the existing version.

    vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.NetWeb --lang fr-FR --keepLayoutVersion
    

Déployer une mise à jour sur les ordinateurs clientsDeploy an update to client machines

Selon la configuration de votre environnement réseau, une mise à jour peut être déployée par un administrateur d’entreprise ou lancée à partir d’un ordinateur client.Depending on how your network environment is configured, an update can either be deployed by an enterprise administrator or initiated from a client machine.

  • Les utilisateurs peuvent mettre à jour une instance de Visual Studio qui a été installée à partir d’un dossier d’installation hors connexion :Users can update a Visual Studio instance that was installed from an offline installation folder:
    • Exécutez le programme d’installation de Visual Studio.Run the Visual Studio Installer.
    • Cliquez ensuite sur Mettre à jour.Then, click Update.
  • Les administrateurs peuvent mettre à jour les déploiements de clients de Visual Studio sans aucune intervention utilisateur avec deux commandes distinctes :Administrators can update client deployments of Visual Studio without any user interaction with two separate commands:
    • Mettez tout d’abord à jour Visual Studio Installer :First, update the Visual Studio installer:
      vs_enterprise.exe --quiet --update
    • Mettez ensuite à jour l’application Visual Studio proprement dite :Then, update the Visual Studio application itself:
      vs_enterprise.exe update --installPath "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise" --quiet --wait --norestart
  • Les administrateurs peuvent mettre à jour les déploiements de clients de Visual Studio sans aucune intervention utilisateur avec deux commandes distinctes :Administrators can update client deployments of Visual Studio without any user interaction with two separate commands:
    • Mettez tout d’abord à jour Visual Studio Installer :First, update the Visual Studio installer:
      vs_enterprise.exe --quiet --update
    • Mettez ensuite à jour l’application Visual Studio proprement dite :Then, update the Visual Studio application itself:
      vs_enterprise.exe update --installPath "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise" --quiet --wait --norestart

Notes

Utilisez la commande vswhere.exe pour identifier le chemin d’installation d’une instance existante de Visual Studio sur un ordinateur client.Use the vswhere.exe command to identify the install path of an existing instance of Visual Studio on a client machine.

Conseil

Pour plus d’informations sur le contrôle du moment de la présentation des notifications de mise à jour aux utilisateurs, consultez Contrôler les mises à jour applicables aux déploiements de Visual Studio à partir du réseau.For details on how to control when update notifications are presented to users, see Control updates to network-based Visual Studio deployments.

Vérifier une dispositionVerify a layout

Utilisez l’option --verify pour effectuer la vérification dans le cache hors connexion fourni.Use --verify to perform verification on the offline cache supplied. Elle contrôle si des fichiers de package sont manquants ou non valides.It checks if packages files are either missing or invalid. À la fin de la vérification, la liste des fichiers manquants et non valides est imprimée.At the end of the verification, it prints the list of missing files and invalid files.

vs_enterprise.exe --layout <layoutDir> --verify

Le fichier vs_enterprise.exe peut être appelé à l’intérieur du répertoire layoutDir.The vs_enterprise.exe can be invoked inside the layoutDir.

Notes

Certains fichiers de métadonnées importantes, qui sont nécessaires à l’option --verify, doivent se trouver dans le cache hors connexion de la disposition.Some important metadata files that are needed by the --verify option must be in the layout offline cache. Si ces fichiers de métadonnées sont manquants, "--verify" ne peut pas s’exécuter et le programme d’installation signale une erreur.If these metadata files are missing, "--verify" cannot run and Setup gives you an error. Si vous rencontrez cette erreur, recréez une nouvelle disposition en mode hors connexion dans un dossier différent (ou dans le même dossier de cache hors connexion).If you experience this error, re-create a new offline layout to a different folder (or to the same offline cache folder. Pour cela, exécutez la même commande de disposition que celle que vous avez utilisée pour créer la disposition hors connexion initiale.To so do, run the same layout command that you used to create the initial offline layout. Par exemple : vs_enterprise.exe --layout <layoutDir>.For example, vs_enterprise.exe --layout <layoutDir>.

Comme Microsoft fournit régulièrement des mises à jour de Visual Studio, la version de la nouvelle disposition que vous créez peut donc être différente de celle de la disposition initiale.Microsoft ships updates to Visual Studio periodically, so the new layout that you create might not be the same version as the initial layout.

Notes

La vérification fonctionne seulement pour la dernière version d’une version mineure spécifique de Visual Studio.Verification works only for the latest version of a specific minor version of Visual Studio. Dès qu’une nouvelle version est publiée, la vérification ne fonctionne plus pour les versions du niveau de correctif antérieures de la même version mineure.As soon as a new version is released, verification won't work for earlier patch level releases of the same minor version.

Corriger une dispositionFix a layout

Utilisez --fix pour effectuer la même vérification que --verify et pour tenter également de résoudre les problèmes identifiés.Use --fix to perform the same verification as --verify and also try to fix the identified issues. Le processus --fix nécessite une connexion Internet, ainsi vous devez vous assurer que votre ordinateur est connecté à Internet avant d’appeler --fix.The --fix process needs an internet connection, so make sure your machine is connected to the internet before you invoke --fix.

vs_enterprise.exe --layout <layoutDir> --fix

Le fichier vs_enterprise.exe peut être appelé à l’intérieur du répertoire layoutDir.The vs_enterprise.exe can be invoked inside the layoutDir.

Supprimer les anciennes versions d’une mise en pageRemove older versions from a layout

Suite aux mises à jour de disposition que vous avez effectuées vers un cache hors connexion, le dossier du cache de disposition peut contenir quelques packages obsolètes qui ne sont plus utiles à la dernière installation en date de Visual Studio.After you perform layout updates to an offline cache, the layout cache folder may have some obsolete packages that are no longer needed by the latest Visual Studio installation. Vous pouvez utiliser l’option --clean pour supprimer les packages obsolètes à partir d’un dossier de cache hors connexion.You can use the --clean option to remove obsolete packages from an offline cache folder.

Pour ce faire, vous avez besoin du chemin de fichier du ou des manifestes de catalogue qui contiennent les packages obsolètes.To do this, you'll need the file path(s) to catalog manifest(s) that contain those obsolete packages. Vous pouvez trouver les manifestes de catalogue dans un dossier Archive situé dans le cache de disposition en mode hors connexion.You can find the catalog manifests in an "Archive" folder in the offline layout cache. Ils sont enregistrés à cet endroit lorsque vous mettez à jour une disposition.They are saved there when you update a layout. Dans le dossier Archive, il existe un ou plusieurs dossiers nommés GUID qui contiennent chacun un manifeste de catalogue obsolète.In the "Archive" folder, there is one or more "GUID" named folders, each of which contains an obsolete catalog manifest. Le nombre de dossiers GUID doit être le même que le nombre de mises à jour apportées à votre cache hors connexion.The number of "GUID" folders should be the same as the number of updates made to your offline cache.

Quelques fichiers sont enregistrés à l’intérieur de chaque dossier GUID.A few files are saved inside each "GUID" folder. Les deux fichiers les plus intéressants sont « catalog.json » et « version.txt ».The two files of most interest are a "catalog.json" file and a "version.txt" file. Le fichier catalog.json est le manifeste de catalogue obsolète que vous devez passer à l’option --clean.The "catalog.json" file is the obsolete catalog manifest you'll need to pass to the --clean option. L’autre fichier, version.txt, contient la version de ce manifeste de catalogue obsolète.The other version.txt file contains the version of this obsolete catalog manifest. En fonction du numéro de version, vous pouvez décider de supprimer ou non les packages obsolètes à partir de ce manifeste de catalogue.Based on the version number, you can decide whether you want to remove obsolete packages from this catalog manifest. Vous pouvez en faire de même lorsque vous parcourez les autres dossiers GUID.You can do the same as you go through the other "GUID" folders. Après avoir décidé du ou des catalogues à nettoyer, exécutez la commande --clean en spécifiant les chemins de fichier de ces catalogues.After you make the decision on the catalog(s) you want to clean, run the --clean command by supplying the files paths to these catalogs.

Voici quelques exemples montrant comment utiliser l’option--clean :Here are a few examples of how to use the --clean option:

vs_enterprise.exe --layout <layoutDir> --clean <file-path-of-catalog1> <file-path-of-catalog2> …
vs_enterprise.exe --layout <layoutDir> --clean <file-path-of-catalog1> --clean <file-path-of-catalog2> …

Vous pouvez aussi appeler le fichier vs_enterprise.exe à l’intérieur du répertoire <layoutDir>.You can also invoke vs_enterprise.exe inside the <layoutDir>. Voici un exemple :Here's an example:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VS2017Layout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Lorsque vous exécutez cette commande, le programme d’installation analyse votre dossier de cache hors connexion pour trouver la liste des fichiers à supprimer.When you execute this command, Setup analyzes your offline cache folder to find the list of files that it will remove. Vous avez ensuite la possibilité de revoir les fichiers qui vont être supprimés pour confirmer les suppressions.You will then have a chance to review the files that are going to be deleted and confirm the deletions.

Obtenir de l’aide pour votre programme d’installation hors connexionGet support for your offline installer

Si vous rencontrez un problème avec votre installation hors connexion, nous voulons le savoir.If you experience a problem with your offline installation, we want to know about it. Le meilleur moyen de nous en faire part est d’utiliser l’outil Signaler un problème.The best way to tell us is by using the Report a Problem tool. Lorsque vous utilisez cet outil, vous pouvez nous envoyer la télémétrie et des journaux, dont nous avons besoin pour nous aider à diagnostiquer et à résoudre le problème.When you use this tool, you can send us the telemetry and logs we need to help us diagnose and fix the problem.

Nous offrons également une option de support par Conversation en direct (en anglais uniquement) pour les problèmes liés à l’installation.We also offer a live chat (English only) support option for installation-related issues.

D’autres options de support sont également à votre disposition.We have other support options available, too. Pour obtenir la liste, consultez notre page Commentaires.For a list, see our Feedback page.

Voir aussiSee also