Créer une installation réseau de Visual StudioCreate a network installation of Visual Studio

En règle générale, un administrateur d’entreprise crée un point d’installation réseau à déployer sur les stations de travail clientes.Typically, an enterprise administrator creates a network install point to deploy to client workstations. Nous avons conçu Visual Studio pour que vous puissiez mettre en cache dans un dossier unique les fichiers de l’installation initiale avec toutes les mises à jour de produit.We've designed Visual Studio to enable you to cache the files for the initial installation along with all product updates to a single folder. (Ce processus est également appelé création d’une disposition.)(This process is also referred to as creating a layout.)

De cette façon, les stations de travail clientes peuvent utiliser le même emplacement réseau pour gérer leur installation, même si elles n’ont pas encore effectué leur dernière mise à jour de maintenance.We've done this so that client workstations can use the same network location to manage their installation even if they haven't yet updated to the latest servicing update.

Notes

Si plusieurs éditions de Visual Studio sont utilisées dans votre entreprise (par exemple, Visual Studio Professional et Visual Studio Enterprise), vous devez créer un partage d’installation réseau distinct pour chaque édition.If you have multiple editions of Visual Studio in use within your enterprise (for example, both Visual Studio Professional and Visual Studio Enterprise), you must create a separate network install share for each edition.

Télécharger le programme d’amorçage de Visual StudioDownload the Visual Studio bootstrapper

Téléchargez un fichier bootstrapper pour l’édition de Visual Studio que vous voulez.Download a bootstrapper file for the edition of Visual Studio you want. Assurez-vous de choisir Enregistrer, puis choisir dossier ouvert.Make sure to choose Save, and then choose Open folder.

Pour obtenir un bootstrapper pour Visual Studio 2017, consultez la page de téléchargement des versions précédentes de Visual Studio pour plus de détails sur la façon de le faire.To get a bootstrapper for Visual Studio 2017, see the Visual Studio previous versions download page for details on how to do so.

Votre configuration—exécutable ou pour être—plus spécifique, le fichier bootstrapper doit correspondre ou être similaire à l’un des éléments suivants.Your setup executable—or to be more specific, the bootstrapper file—should match or be similar to one of the following.

ÉditionEdition Nom de fichierFilename
Visual Studio EnterpriseVisual Studio Enterprise vs_enterprise.exevs_enterprise.exe
Visual Studio ProfessionalVisual Studio Professional vs_professional.exevs_professional.exe
Visual Studio Build ToolsVisual Studio Build Tools vs_buildtools.exevs_buildtools.exe

D’autres bootstrappers pris en charge comprennent vs_feedbackclient.exe, vs_teamexplorer.exe, vs_testagent.exe, vs_testcontroller.exe, et vs_testprofessional.exe.Other supported bootstrappers include vs_feedbackclient.exe, vs_teamexplorer.exe, vs_testagent.exe, vs_testcontroller.exe, and vs_testprofessional.exe.

Votre configuration—exécutable ou pour être—plus spécifique, un fichier bootstrapper doit correspondre ou être similaire à l’un des éléments suivants.Your setup executable—or to be more specific, a bootstrapper file—should match or be similar to one of the following.

ÉditionEdition TéléchargementDownload
Visual Studio EnterpriseVisual Studio Enterprise vs_enterprise.exevs_enterprise.exe
Visual Studio ProfessionalVisual Studio Professional vs_professional.exevs_professional.exe
Visual Studio Build ToolsVisual Studio Build Tools vs_buildtools.exevs_buildtools.exe

D’autres bootstrappers pris en charge comprennent vs_teamexplorer.exe, vs_testagent.exe, et vs_testcontroller.exe.Other supported bootstrappers include vs_teamexplorer.exe, vs_testagent.exe, and vs_testcontroller.exe.

Conseil

Si vous avez déjà téléchargé un fichier bootstrapper et que vous souhaitez vérifier sa version, voici comment.If you previously downloaded a bootstrapper file and want to verify its version, here's how. Dans Windows, ouvrez File Explorer, cliquez à droite sur le fichier bootstrapper, choisissez les propriétés, choisissez l’onglet Détails, puis consultez le numéro de version produit.In Windows, open File Explorer, right-click the bootstrapper file, choose Properties, choose the Details tab, and then view the Product version number. Pour correspondre à ce nombre à une sortie de Visual Studio, voir le Visual Studio construire des numéros et la page de dates de sortie.To match that number to a release of Visual Studio, see the Visual Studio build numbers and release dates page.

Créer un dossier d’installation hors connexionCreate an offline installation folder

Vous devez avoir une connexion Internet pour terminer cette étape.You must have an internet connection to complete this step. Pour créer une installation hors ligne avec toutes les langues et toutes les fonctionnalités, utilisez une commande similaire à l’un des exemples suivants.To create an offline installation with all languages and all features, use a command that is similar to one of the following examples.

Important

Une disposition Visual Studio complète nécessite un minimum de 35 Go d’espace disque et peut être assez longue à télécharger.A complete Visual Studio layout requires a minimum of 35 GB of disk space and can take some time to download. Consultez la section Personnaliser la disposition réseau pour plus de détails sur la création d’une disposition comprenant uniquement les composants que vous souhaitez installer.See the Customize the network layout section for details on how to create a layout with only the components you want to install.

Conseil

Vérifiez que vous exécutez la commande à partir de votre répertoire de téléchargement.Make sure that you run the command from your Download directory. En règle générale, il s’agit du répertoire C:\Users\<username>\Downloads sur un ordinateur exécutant Windows 10.Typically, that's C:\Users\<username>\Downloads on a computer running Windows 10.

  • Pour Visual Studio Enterprise, exécutez :For Visual Studio Enterprise, run:

    vs_enterprise.exe --layout c:\VSLayout

  • Pour Visual Studio Professional, exécutez :For Visual Studio Professional, run:

    vs_professional.exe --layout c:\VSLayout

Modifier le fichier response.jsonModify the response.json file

Vous pouvez modifier response.json pour définir les valeurs par défaut qui sont utilisées lors de l’exécution du programme d’installation.You can modify the response.json to set default values that are used when setup is run. Par exemple, vous pouvez configurer le fichier response.json pour sélectionner un ensemble spécifique de charges de travail sélectionnées automatiquement.For example, you can configure the response.json file to select a specific set of workloads selected automatically. Pour plus d’informations, consultez Automatiser l’installation de Visual Studio avec un fichier réponse.See Automate Visual Studio installation with a response file for details.

Et, si vous rencontrez un problème avec le Bootstrapper Visual Studio lancer une erreur lorsque vous l’associez à un fichier response.json, voir le "Failed to analyse ID from parent process" section des erreurs liées au réseau Troubleshoot lorsque vous installez ou utilisez la page Visual Studio pour plus d’informations sur ce qu’il faut faire.And, if you run into a problem with the Visual Studio bootstrapper throwing an error when you pair it with a response.json file, see the "Failed to parse ID from parent process" section of the Troubleshoot network-related errors when you install or use Visual Studio page for more information on what to do.

Copier la disposition sur un partage réseauCopy the layout to a network share

Hébergez la disposition sur un partage réseau afin de pouvoir l’exécuter à partir d’autres ordinateurs.Host the layout on a network share so it can be run from other machines.

L’exemple suivant utilise xcopy.The following example uses xcopy. Vous pouvez également utiliser robocopy, si vous le souhaitez.You can also use robocopy, should you wish.

Exemple :Example:

xcopy /e c:\VSLayout \\server\products\VS2017
xcopy /e c:\VSLayout \\server\products\VS2019

Important

Pour éviter toute erreur, vérifiez que votre chemin de la disposition complet fait moins de 80 caractères.To prevent an error, make sure that your full layout path is less than 80 characters.

Personnaliser la disposition réseauCustomize the network layout

Plusieurs options vous permettent de personnaliser votre disposition réseau.There are several options you can use to customize your network layout. Vous pouvez créer une disposition partielle qui contient uniquement un ensemble spécifique de paramètres régionaux de langue, charges de travail, composants et leurs dépendances recommandées ou facultatives.You can create a partial layout that only contains a specific set of language locales, workloads, components, and their recommended or optional dependencies. Cela peut s’avérer utile si vous savez que vous allez uniquement déployer un sous-ensemble de charges de travail sur les stations de travail clientes.This might be useful if you know that you're going to deploy only a subset of workloads to client workstations. Les paramètres de ligne de commande standard permettant de personnaliser la disposition incluent :Typical command-line parameters for customizing the layout include:

  • --addpour spécifier la charge de travail ou les composants .--add to specify workload or component IDs.
    Si --add est utilisé, seuls les composants et les charges de travail spécifiés avec --add sont téléchargés.If --add is used, only those workloads and components specified with --add are downloaded. Si --add n’est pas utilisé, l’ensemble des charges de travail et des composants est téléchargé.If --add isn't used, all workload and components are downloaded.
  • --includeRecommended pour inclure tous les composants recommandés pour les ID de charge de travail spécifiés--includeRecommended to include all the recommended components for the specified workload IDs
  • --includeOptional pour inclure tous les composants recommandés et facultatifs pour les ID de charge de travail spécifiés.--includeOptional to include all the recommended and optional components for the specified workload IDs.
  • --lang pour spécifier les paramètres régionaux de langue.--lang to specify language locales.

Voici quelques exemples montrant comment créer une disposition partielle personnalisée.Here are a few examples of how to create a custom partial layout.

  • Pour télécharger tous composants et les charges de travail dans une langue, exécutez :To download all workloads and components for only one language, run:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US
    
  • Pour télécharger tous composants et les charges de travail de plusieurs langues, exécutez :To download all workloads and components for multiple languages, run:

    vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
    
  • Pour télécharger une charge de travail pour toutes les langues, exécutez :To download one workload for all languages, run:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
    
  • Pour télécharger deux charges de travail et un composant facultatif dans trois langues, exécutez :To download two workloads and one optional component for three languages, run:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended --lang en-US de-DE ja-JP
    
  • Pour télécharger deux charges de travail et tous leurs composants recommandés :To download two workloads and all of their recommended components:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeRecommended
    
  • Pour télécharger deux charges de travail et tous leurs composants recommandés et facultatifs, exécutez :To download two workloads and all of their recommended and optional components, run:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Component.GitHub.VisualStudio --includeOptional
    

Nouveautés dans la version 15.3New in version 15.3

Enregistrer vos options de dispositionSave your layout options

Lorsque vous exécutez une commande de disposition, les options que vous spécifiez sont enregistrées (par exemple, les langues et les charges de travail).When you run a layout command, the options that you specify are saved (such as the workloads and languages). Les commandes de disposition suivantes englobent toutes les options précédentes.Subsequent layout commands will include all of the previous options. Voici un exemple de disposition avec une charge de travail pour l’anglais uniquement :Here is an example of a layout with one workload for English only:

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Lorsque vous souhaitez mettre à jour cette disposition vers une version plus récente, vous n’avez pas à spécifier de paramètres de ligne de commande supplémentaires.When you want to update that layout to a newer version, you don't have to specify any additional command-line parameters. Les paramètres précédents sont enregistrés et utilisés par toutes les commandes de disposition suivantes dans ce dossier de disposition.The previous settings are saved and used by any subsequent layout commands in this layout folder. La commande suivante met à jour la disposition partielle existante.The following command will update the existing partial layout.

vs_enterprise.exe --layout c:\VSLayout

Lorsque vous voulez ajouter une charge de travail supplémentaire, suivez cet exemple qui montre comment faire.When you want to add an additional workload, here's an example of how to do so. Dans ce cas, nous allons ajouter une langue localisée et la charge de travail Azure.In this case, we'll add the Azure workload and a localized language. À présent, Managed Desktop et Azure sont inclus dans cette disposition.Now, both Managed Desktop and Azure are included in this layout. Les ressources de langue pour l’anglais et l’allemand sont comprises pour toutes ces charges de travail.The language resources for English and German are included for all these workloads. La disposition est mise à jour avec la dernière version disponible.The layout is updated to the latest available version.

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

Si vous souhaitez passer d’une disposition existante à une disposition complète, utilisez l’option --all, comme indiqué dans l’exemple suivant.If you want to update an existing layout to a full layout, use the --all option, as shown in the following example.

vs_enterprise.exe --layout c:\VSLayout --all

Effectuer un déploiement à partir d’une installation réseauDeploy from a network installation

Les administrateurs peuvent déployer Visual Studio sur les stations de travail clientes dans le cadre d’un script d’installation.Administrators can deploy Visual Studio onto client workstations as part of an installation script. Les utilisateurs qui disposent de droits d’administrateur peuvent aussi exécuter le programme d’installation directement à partir du partage pour installer Visual Studio sur leur ordinateur.Or, users who have administrator rights can run setup directly from the share to install Visual Studio on their machine.

  • Les utilisateurs peuvent effectuer l’installation en exécutant la commande suivante :Users can install by running the following command:

    \\server\products\VS\vs_enterprise.exe
    
  • Les administrateurs peuvent effectuer l’installation en mode sans assistance en exécutant la commande suivante :Administrators can install in an unattended mode by running the following command:

    \\server\products\VS\vs_enterprise.exe --quiet --wait --norestart
    

Important

Pour éviter toute erreur, vérifiez que votre chemin de la disposition complet fait moins de 80 caractères.To prevent an error, make sure that your full layout path is less than 80 characters.

Conseil

Quand elle est exécutée dans le cadre d’un fichier de commandes, l’option --wait garantit que le processus vs_enterprise.exe attend que l’installation soit terminée avant de retourner un code de sortie.When executed as part of a batch file, the --wait option ensures that the vs_enterprise.exe process waits until the installation is complete before it returns an exit code.

C’est utile si un administrateur d’entreprise souhaite effectuer d’autres opérations sur une installation terminée (par exemple, pour appliquer une clé de produit sur une installation réussie), alors qu’il doit attendre que l’installation se termine pour gérer le code de retour de cette installation.This is useful if an enterprise administrator wants to perform further actions on a completed installation (for example, to apply a product key to a successful installation) but must wait for the installation to finish to handle the return code from that installation.

Si vous n’utilisez pas --wait, le processus vs_enterprise.exe s’arrête avant que l’installation soit terminée et retourne un code de sortie incorrect qui ne représente pas l’état de l’opération d’installation.If you do not use --wait, the vs_enterprise.exe process exits before the installation is complete and returns an inaccurate exit code that doesn't represent the state of the install operation.

Important

Pour les installations hors ligne, si vous obtenez un message d’erreur qui dit "Un --noweb produit correspondant aux paramètres suivants ne peut pas être trouvé", assurez-vous que vous utilisez le commutateur avec la version 16.3.5 ou plus tard.For offline installations, if you get an error message that says "A product matching the following parameters cannot be found", make sure that you are using the --noweb switch with version 16.3.5 or later.

Lorsque vous installez à partir d’une disposition, le contenu qui est installé est acquis à partir de la disposition.When you install from a layout, the content that is installed is acquired from the layout. Toutefois, si vous sélectionnez un composant qui ne se trouve pas dans la disposition, celui-ci est téléchargé à partir d’Internet.However, if you select a component that isn't in the layout, it will be acquired from the internet. Si vous voulez empêcher le programme d’installation de Visual Studio de télécharger le contenu manquant dans la disposition, utilisez l’option --noWeb.If you want to prevent Visual Studio setup from downloading any content that is missing in your layout, use the --noWeb option. Si --noWeb est utilisé et qu’un contenu à installer est absent de la disposition, l’installation échoue.If --noWeb is used and the layout is missing any content that is selected to be installed, setup fails.

Conseil

Si vous souhaitez installer à partir d’une source hors connexion --noWeb --noUpdateInstaller sur un ordinateur non connecté à Internet, spécifiez à la fois les options et les options.If you want to install from an offline source on a non-internet connected computer, specify both the --noWeb and --noUpdateInstaller options. Le premier empêche le téléchargement de charges de travail mises à jour, composants, et ainsi de suite.The former prevents downloading updated workloads, components, and so on. Ce dernier empêche l’installateur de s’auto-actualiser sur le Web.The latter prevents the installer from self-updating from the web.

Important

L’option --noWeb n’empêche pas la configuration Visual Studio sur un ordinateur connecté à Internet de vérifier les mises à jour.The --noWeb option does not stop Visual Studio setup on an internet-connected computer from checking for updates. Pour plus d’informations, consultez la page Contrôler les mises à jour applicables aux déploiements de Visual Studio à partir du réseau.For more information, see the Control updates to network-based Visual Studio deployments page.

Codes d’erreurError codes

Si vous avez utilisé le paramètre --wait, en fonction du résultat de l’opération, la variable d’environnement %ERRORLEVEL% a l’une des valeurs suivantes :If you used the --wait parameter, then depending on the result of the operation, the %ERRORLEVEL% environment variable is set to one of the following values:

ValeurValue RésultatResult
00 Opération effectuée avec succèsOperation completed successfully
16021602 Opération annuléeOperation was canceled
16411641 Opération achevée avec succès, le redémarrage a été lancéOperation completed successfully, and reboot was initiated
30103010 Opération effectuée avec succès, mais l’installation nécessite un redémarrage avant de pouvoir être utiliséeOperation completed successfully, but install requires reboot before it can be used
50035003 Le programme d’amorçage a échoué à télécharger le programme d’installationBootstrapper failed to download installer
50045004 Opération annuléeOperation was canceled
50055005 Erreur d’analyse de la ligne de commande du programme d’amorçageBootstrapper command-line parse error
50075007 L’opération a été bloquée - l’ordinateur ne répond pas à la configuration requiseOperation was blocked - the computer does not meet the requirements
-1073741510-1073741510 Microsoft Visual Studio Installer a été arrêté (par l’utilisateur ou par un processus externe)Microsoft Visual Studio Installer was terminated (by the user or external process)
AutresOther
(par exemple :(for example:
-1, 1, 1603)-1, 1, 1603)
Une condition d’échec s’est produite - Pour plus d’informations, consultez les journauxFailure condition occurred - check the logs for more information

Mettre à jour une disposition d’installation réseauUpdate a network install layout

Quand les mises à jour de produit deviennent disponibles, vous avez la possibilité de mettre à jour la disposition d’installation réseau pour intégrer les packages mis à jour.As product updates become available, you might want to update the network install layout to incorporate updated packages.

Comment créer une disposition pour une version antérieure de Visual StudioHow to create a layout for a previous Visual Studio release

Notes

Les programmes d’amorçage de Visual Studio disponibles sur visualstudio.microsoft.com téléchargent et installent la dernière version de Visual Studio, chaque fois qu’ils sont exécutés.The Visual Studio bootstrappers that are available on visualstudio.microsoft.com download and install the latest Visual Studio release that's available whenever they are run.

Ainsi, si vous téléchargez un programme d’amorçage de Visual Studio aujourd’hui, et si vous l’exécutez dans six mois, il installe la version de Visual Studio disponible au moment où vous exécutez le programme d’amorçage.So, if you download a Visual Studio bootstrapper today and run it six months from now, it installs the Visual Studio release that is current at the time you run the bootstrapper.

Toutefois, si vous créez une disposition, et si vous l’installez à partir de celle-ci, la disposition installe la version spécifique de Visual Studio qui existe dans la disposition.But, if you create a layout and then install from it, the layout installs the specific version of Visual Studio that exists in the layout. Même si une version plus récente peut exister en ligne, vous obtenez la version de Visual Studio qui se trouve dans la disposition.Even though a newer version might exist online, you get the version of Visual Studio that is in the layout.

Notes

Les programmes d’amorçage de Visual Studio disponibles sur visualstudio.microsoft.com téléchargent et installent la dernière version de Visual Studio, chaque fois qu’ils sont exécutés.The Visual Studio bootstrappers that are available on visualstudio.microsoft.com download and install the latest Visual Studio release that's available whenever they are run.

Ainsi, si vous téléchargez un programme d’amorçage de Visual Studio aujourd’hui, et si vous l’exécutez dans six mois, il installe la version de Visual Studio disponible au moment où vous exécutez le programme d’amorçage.So, if you download a Visual Studio bootstrapper today and run it six months from now, it installs the Visual Studio release that is current at the time you run the bootstrapper.

Toutefois, si vous créez une disposition, et si vous l’installez à partir de celle-ci, la disposition installe la version spécifique de Visual Studio qui existe dans la disposition.But, if you create a layout and then install from it, the layout installs the specific version of Visual Studio that exists in the layout. Même si une version plus récente peut exister en ligne, vous obtenez la version de Visual Studio qui se trouve dans la disposition.Even though a newer version might exist online, you get the version of Visual Studio that is in the layout.

Si vous avez besoin de créer une mise en https://my.visualstudio.com page pour une version plus ancienne de Visual Studio, allez télécharger des versions "fixes" des bootstrappers Visual Studio.If you need to create a layout for an older version of Visual Studio, go to https://my.visualstudio.com to download "fixed" versions of the Visual Studio bootstrappers.

Comment obtenir de l’assistance pour votre programme d’installation hors connexionHow to get 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 chat sur les installations (en anglais uniquement) pour les problèmes liés à l’installation.We also offer an installation 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