Créer et gérer une installation réseau de Visual Studio

Nous aimerions connaître votre avis ! Veuillez prendre un moment pour répondre à cette enquête et nous indiquer comment nous pouvons améliorer l'expérience de la mise en page. Nous vous remercions de votre soutien!

Il arrive qu'un administrateur d'entreprise souhaite créer un cache d'installation privé (également appelé « layout ») contenant des fichiers Visual Studio qui peuvent être déployés sur des machines clientes au sein de l'organisation.

La création d'un modèle est utile dans les situations suivantes :

  • Un utilisateur dispose d'autorisations limitées
  • Les machines clientes ont un accès limité à l'internet
  • Une organisation souhaite standardiser une version particulière de l'ensemble des outils de développement

Nous avons conçu Visual Studio de manière à ce qu'un administrateur puisse à la fois créer et maintenir une présentation, la stocker sur un partage du réseau interne et, éventuellement, la rendre disponible sur l'intranet de l'organisation. Le layout sert d’emplacement source pour tous les fichiers Visual Studio nécessaires à l’installation initiale du client et aux mises à jour qui suivront.

Les informations de cette page sont regroupées en trois sections principales :

  • Créer la mise en page : décrit comment créer la mise en page avec le contenu correct du produit, configurer les paramètres par défaut, la stocker sur un réseau de partage de fichiers et la rendre disponible sur votre intranet.
  • Gérer le layout : informations sur la meilleure façon de mettre à jour la version produit du layout, ou de modifier le contenu du produit, les paramètres de canal, la version du programme d’installation et la taille du dossier du layout.
  • Aide et support : où demander de l’aide

Créer le layout

Préparer l’emplacement de stockage du partage de fichiers réseau

Tout d’abord, vous devez déterminer où vous allez stocker les packages Visual Studio téléchargés. Si plusieurs éditions de Visual Studio sont utilisées dans votre entreprise (par exemple, Visual Studio 2022 Professional et Visual Studio 2022 Enterprise), vous devez créer un layout distinct pour chaque édition. Créer un layout séparé pour chaque édition peut consommer beaucoup d’espace disque, surtout lorsque l’on considère que les mises à jour du layout consomment également de l’espace disque.

Le chemin du layout doit contenir moins de 80 caractères, mais certaines organisations utilisent correctement des liens symboliques pour contourner la limite des 80 caractères.

Télécharger le programme d’amorçage Visual Studio pour créer le layout

Téléchargez le bon programme d’amorçage pour l’édition de Visual Studio souhaitée et copiez-le dans le répertoire que vous souhaitez utiliser comme référentiel du layout. Une fois que le layout est créé, vous pouvez l’utiliser pour installer Visual Studio sur n’importe quel ordinateur client. Le programme d’amorçage est l’exécutable que vous utilisez pour créer, mettre à jour et effectuer d’autres opérations de disposition. Vous devez disposer d'une connexion internet et de droits d'administrateur pour effectuer cette étape.

Les programmes d’amorçage suivants installent toujours la dernière version la plus sécurisée de Visual Studio 2019, quel que soit le moment où vous les exécutez. Sinon, si vous souhaitez créer ou mettre à jour une disposition vers une version spécifique de Visual Studio 2019, accédez à la page Versions de Visual Studio 2019 qui contient des liens vers les programmes d’amorçage de version fixe pour chaque version de maintenance, puis téléchargez celle souhaitée. Copiez-la dans le répertoire que vous souhaitez définir en tant qu’emplacement source de la disposition.

Édition Programme d’amorçage
Visual Studio 2019 Enterprise version 16.11 vs_enterprise.exe
Visual Studio 2019 Professional version 16.11 vs_professional.exe
Visual Studio 2019 Build Tools version 16.11 vs_buildtools.exe

Les autres programmes d’amorçage pris en charge incluent vs_teamexplorer.exe, vs_testagent.exe et vs_testcontroller.exe.

Les programmes d’amorçage suivants installent toujours la dernière version la plus sécurisée de Visual Studio 2022 sur le Canal actuel, quel que soit le moment où vous les exécutez. Alternativement, si vous souhaitez créer ou mettre à jour un layout vers une version spécifique ou un canal spécifique de Visual Studio 2022, téléchargez le lanceur d’installation en version pérenne et fixe pour la version de maintenance du canal que vous souhaitez depuis l’historique des versions de Visual Studio 2022. Copiez-la dans le répertoire que vous souhaitez définir en tant qu’emplacement source de la disposition.

Édition Programme d’amorçage
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Community vs_community.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

Conseil

Si vous avez précédemment téléchargé un fichier de programme d’amorçage et que vous souhaitez vérifier sa version, voici comment procéder. Dans Windows, ouvrez l’Explorateur de fichiers, cliquez avec le bouton droit sur le fichier de programme d’amorçage, choisissez Propriétés, choisissez l’onglet Détails, puis affichez le numéro de version du produit. Pour faire correspondre ce numéro à une version de Visual Studio, consultez le tableau situé en bas de la page Versions de Visual Studio 2019.

Conseil

Si vous avez précédemment téléchargé un fichier de programme d’amorçage et que vous souhaitez vérifier la version qu’il installe, voici comment procéder. Dans Windows, ouvrez l’Explorateur de fichiers, cliquez avec le bouton droit sur le fichier de programme d’amorçage, choisissez Propriétés, puis choisissez l’onglet Détails. Le champ version du produit décrit le canal et la version que le programme d’amorçage installera. Le numéro de version doit toujours être lu comme « dernière version de maintenance de ce qui est spécifié », et la chaîne est supposée être Actuel, sauf indication explicite. Ainsi, un programme d’amorçage avec la version de produit du canal de maintenance à long terme (LTSC) 17.0 installe la dernière version de maintenance 17.0.x disponible sur le canal LTSC 17.0. Un programme d’amorçage avec une version de produit indiquant que Visual Studio 2022 installe la dernière version de maintenance de Visual Studio 2022 sur la chaîne actuelle.

Télécharger les packages Visual Studio

Vous devez avoir une connexion Internet pour terminer cette étape.

Ouvrez une invite de commandes avec élévation de privilèges, accédez au répertoire dans lequel vous avez téléchargé le programme d’amorçage et utilisez les paramètres du programme d’amorçage, tels que définis dans la page Utiliser les paramètres de ligne de commande pour installer Visual Studio afin de créer et de gérer votre layout réseau. Les exemples suivants illustrent les méthodes courantes pour créer les layouts initiaux. Vous trouverez d’autres exemples dans la page Exemples de paramètres de ligne de commande pour l’installation de Visual Studio.

Un layout initial complet pour un seul paramètre régional nécessite environ 40 Go d’espace disque pour Visual Studio Community et environ 50 Go pour Visual Studio Enterprise. Les paramètres régionaux de langue supplémentaires nécessitent environ un demi-Go chacun.

L’approche recommandée consiste à créer un layout initial de Visual Studio avec toutes les charges de travail et langues appropriées et à stocker les packages dans le répertoire du layout sur le serveur réseau. De cette façon, toute installation du client a accès à l’ensemble de l’offre des produits Visual Studio et la possibilité d’installer n’importe quelle partie. Pour créer un layout complet de Visual Studio, exécutez la commande suivante à partir du répertoire sur lequel vous envisagez d’héberger le layout réseau :

vs_enterprise.exe --layout c:\VSLayout

Vérifier que votre layout est basé sur le canal approprié

Il est important de s’assurer que le layout réseau est basé sur le bon canal, car c’est l’un des critères que les mises à jour administrateur, si elles sont déployées dans toute l’organisation, utilisent pour identifier les instances clientes à mettre à jour. Par exemple, si votre layout est basé sur le canal VisualStudio.17.Release.LTSC.17.0 et si vos clients sont configurés pour recevoir des mises à jour depuis les serveurs hébergés par Microsoft, alors toutes les mises à jour de sécurité disponibles sur le canal 17.0 LTSC sont disponibles pour les clients ayant installé ou mis à jour depuis ce layout.

Les programmes d’amorçage listés précédemment sont basés sur le Canal actuel. Pour créer un layout basé sur l’une des chaînes LTSC, il est important d’acquérir le programme d’amorçage de la chaîne appropriée à partir de la page Historique des mises en production de Visual Studio 2022, de le copier dans votre dossier de disposition et de l’utiliser pour créer ou mettre à jour la disposition.

Configurer le contenu d’un layout

Plusieurs options vous permettent de personnaliser le contenu de votre disposition réseau. 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. Un layout partiel est utile si vous savez que vous allez déployer uniquement un sous-ensemble de charges de travail sur les postes de travail des clients. Les paramètres de ligne de commande standard permettant de personnaliser la disposition incluent :

  • --add pour spécifier les ID de charge de travail ou de composant.
    Si --add est utilisé, seuls les composants et les charges de travail spécifiés avec --add sont téléchargés. Si --add n’est pas utilisé, l’ensemble des charges de travail et des composants est téléchargé.
  • --includeRecommended pour inclure tous les composants recommandés pour les ID de charge de travail spécifiés.
  • --includeOptional pour inclure tous les composants optionnels pour les ID de charge de travail spécifiés.
  • --config pour utiliser un fichier de *.vsconfig afin de spécifier les charges de travail, composants ou extensions qui doivent être inclus dans ou référencés par le layout. Veillez à spécifier le chemin d’accès complet du fichier config.
  • --lang pour spécifier les paramètres régionaux de langue.

Voici quelques exemples montrant comment créer un layout réseau personnalisé.

  • Pour créer un layout avec les composants requis pour toutes les charges de travail dans une seule langue, exécutez :

    vs_enterprise.exe --layout C:\VSLayout --lang en-US
    
  • Pour créer un layout avec les composants requis pour toutes les charges de travail dans plusieurs langues, exécutez :

    vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
    
  • Pour créer un layout avec une charge de travail et tous les composants requis et recommandés pour cette charge de travail, dans toutes les langues, exécutez :

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
    
  • Pour créer un layout avec deux charges de travail et un composant facultatif dans trois langues, exécutez :

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
    

Utiliser un fichier de configuration pour initialiser le contenu d’un layout

Vous pouvez utiliser le paramètre --config pour passer dans un fichier *.vsconfig. Veillez à spécifier le chemin d’accès complet du fichier config. L’utilisation d’un fichier *.vsconfig lors de la création du layout personnalise et limite le contenu d’un agencement réseau à ce qui est spécifié dans le fichier de configuration. Le fichier de configuration est copié dans le répertoire du layout et renommé en layout.vsconfig.

Les extensions spécifiées dans le fichier de *.vsconfig ne sont pas copiées directement dans le layout. Au lieu de cela, le fichier response.json du layout contient une référence au fichier de layout.vsconfig nouvellement créé, définissant l’emplacement d’installation des extensions du client. Si vous installez des extensions qui ne sont pas signées numériquement, assurez-vous de modifier le response.json pour y ajouter "allowUnsignedExtensions": true. Consultez les response.json exemples de contenu.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Copier la disposition sur un partage réseau

Vous devez héberger le layout sur un partage réseau afin de pouvoir y accéder à partir des ordinateurs clients. Si vous avez créé le layout sur un ordinateur local, vous devez le copier dans un emplacement de fichier réseau. L'exemple suivant utilise xcopy. Vous pouvez également utiliser robocopy, si vous le souhaitez. Exemple :

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Configurer les valeurs par défaut de l’installation initiale du client pour cette disposition

Un fichier appelé response.json est créé dans le dossier racine du layout. Ce fichier personnalisable fournit les paramètres par défaut initiaux à configurer sur le client, lorsque le client installe initialement depuis le layout. Les options de configuration courantes incluent la capacité de configurer :

  • Quelles charges de travail, composants ou langues doivent être installés par défaut sur le client
  • Si des composants recommandés doivent également être installés
  • Si le client doit respecter un fichier d’installation *.vsconfig
  • D’où le client doit-il recevoir les mises à jour
  • Si les composants hors support doivent être supprimés lors d’une mise à jour
  • Si les extensions non signées sont autorisées à se charger silencieusement & de manière programmatique

Pour plus d’informations, consultez la page Automatiser l’installation de Visual Studio avec un fichier réponse.

Rendre votre layout accessible via un site intranet

À compter de juin 2023, vous pouvez rendre vos layouts disponibles sur un site intranet interne, ce qui vous permettra de tirer parti des fonctionnalités de mise en cache de fichiers de serveur web et de niveau de performance de géoréplication. Pour utiliser cette nouvelle fonctionnalité, vous devez utiliser les derniers programmes d’amorçage Visual Studio et le dernier Visual Studio Installer. Les administrateurs de systèmes informatiques doivent faire ce qui suit pour profiter de cette capacité d’hébergement Web intranet :

  1. Tout d’abord, créez et gérez un layout réseau et assurez-vous que les composants sont présents et régulièrement mis à jour sur le partage réseau. N’oubliez pas de configurer la valeur channelUri dans le fichier response.json du layout si vous souhaitez que vos clients récupèrent leurs mises à jour dans l’emplacement de layout intranet.

  2. Ensuite, les administrateurs doivent préparer un site web interne et lier la source du site web à l’emplacement des fichiers réseau du layout. Ils doivent également s’assurer que le serveur Web respecte les types MIME suivants :

    Extension de fichier Type MIME
    .cab application/vnd.ms-cab-compressed
    .exe application/octet-stream
    .json application/json
    .msi application/octet-stream
    .msu application/octet-stream
    .nupkg application/octet-stream
    .opc application/octet-stream
    .ps1 application/postscript
    .vsix application/octet-stream
    .xml text/xml
    .zip application/x-zip-compressed
  3. Enfin, pour déployer ce layout sur le client, exécutez un script PowerShell sur le client pour effectuer l’installation initiale. Une fois que Visual Studio est correctement installé sur le client à partir d’un agencement hébergé sur le Web, alors les mises à jour du client pour les agencements hébergés sur le Web peuvent être mises à jour via des méthodes standard.

Vérifiez que votre disposition utilise le dernier programme d’installation

Notes

À compter de juin 2023, le dernier programme d’installation est livré par défaut avec chaque mise à jour de toutes les versions prises en charge de Visual Studio 2017, Visual Studio 2019 et Visual Studio 2022. Par conséquent, si vous utilisez l’une des versions de ces produits, vous n’avez pas besoin de faire quoi que ce soit d’explicite pour obtenir la dernière version du programme d’installation contenant les fonctionnalités et correctifs de bogues les plus récents.

Si vous utilisez une version de Visual Studio expédiée avant juin 2023, nous recommandons toujours d’utiliser le dernier installateur de Visual Studio dans votre layout et de le distribuer à vos clients. Par exemple, si vous distribuez le programme d’installation de Visual Studio 2022 dans votre layout Visual Studio 2019, vos clients Visual Studio 2019 basés sur ce layout ont la possibilité de changer l’emplacement source des mises à jour ou de supprimer facilement les composants hors support. Des détails supplémentaires sont décrits dans la section suivante.

La capacité de garantir de manière programmatique que vous utilisez le dernier installateur est uniquement disponible pour les lanceurs d’installation de Visual Studio 2019 qui ont été développés après la sortie initiale de Visual Studio 2022. Par conséquent, le vs_enterprise.exe dans l’exemple suivant doit être une version qui a été livrée après le 10 novembre 2021.

Pour créer une disposition de l’ensemble du produit qui utilise le dernier et le plus grand programme d’installation disponible, exécutez

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Maintenance de votre disposition

Il est recommandé de mettre régulièrement à jour votre disposition Visual Studio vers la dernière version sécurisée du produit. Cela garantit que le layout peut être utilisé à la fois comme point d’installation et source de mise à jour pour les installations clientes. La section suivante décrit les opérations de maintenance de disposition les plus courantes ou les plus utiles.

Si vous hébergez un layout sur un partage de fichiers réseau, vous voudrez peut-être télécharger un layout mis à jour sur un partage local privé (par exemple, c:\VSLayoutUpdate) et, une fois que tout le contenu mis à jour est téléchargé, le copier sur le partage de fichiers réseau de votre layout (par exemple, \server\products\VS). Si vous ne le faites pas, les utilisateurs qui exécutent le programme d’installation pendant que vous mettez à jour le layout constatent une différence de contenu du layout parce qu’il n’est pas encore complètement mis à jour.

Mettre à jour la disposition vers la version la plus récente du produit

Microsoft publie fréquemment des versions mises à jour du produit pour résoudre les problèmes de fonctionnalité ou de sécurité. Nous vous recommandons vivement de maintenir votre disposition à jour avec la dernière version du produit afin que vos clients aient toujours accès à la dernière version la plus sécurisée du produit. C’est particulièrement important si vos clients n’ont pas accès à Internet et peuvent uniquement recevoir les mises à jour du produit à partir du layout. Visual Studio publie généralement des mises à jour de sécurité le deuxième mardi du mois, connu sous le nom de « patch Tuesday », donc une bonne stratégie consiste à mettre à jour tous vos layouts l’après-midi du mardi-même.

Lorsque vous créez le layout initial, les options spécifiées, telles que les charges de travail et les langues à inclure dans le layout, sont enregistrées dans le fichier de configuration layout.json du layout. Par la suite, quand vous mettrez à jour cette disposition vers une version plus récente du produit, vous n’aurez pas besoin de spécifier à nouveau les composants du produit à installer dans la disposition. Une mise à jour de layout met simplement à jour les composants du layout vers leur version la plus récente.

Supposons que vous avez déjà créé cette disposition partielle à l’aide de l’un des programmes d’amorçage persistants dans le tableau ci-dessus.

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

La mise à jour de cette disposition vers la dernière version du produit proposé par Microsoft et hébergé sur des serveurs Microsoft est facile. Il vous suffit d’utiliser le programme d’amorçage permanent qui existe dans le layout et d’exécuter la commande --layout à une invite avec élévation de privilèges pour télécharger les derniers packages dans votre layout, comme ceci :

vs_enterprise.exe --layout c:\VSLayout

Vous pouvez également mettre à jour votre layout avec une version mise à jour en mode sans assistance. L’opération de disposition exécute le processus d’installation dans une nouvelle fenêtre de console. La fenêtre reste ouverte pour que les administrateurs puissent voir le résultat final de la mise à jour de la disposition ainsi qu’un récapitulatif des erreurs qui se sont produites. Si vous souhaitez effectuer une opération de mise à jour de la 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.

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

Mettre à jour la disposition vers une version spécifique du produit

Vous pouvez parfois mettre à jour votre disposition vers une version spécifique du produit. Par exemple, vous pouvez faire en sorte que votre disposition corresponde à la dernière version sécurisée de la base de référence de maintenance sur laquelle vous avez standardisé votre organisation. Voici comment procéder :

Vous pouvez accéder à la page Versions de Visual Studio 2019 et télécharger un programme d’amorçage de version fixe spécifique, le copier dans votre disposition et l’utiliser pour mettre à jour la disposition vers la version exacte spécifiée dans le programme d’amorçage. Vous utiliseriez exactement la même syntaxe que ci-dessus.

Vous pouvez utiliser une mise à jour administrateur pour mettre à jour votre layout vers une version spécifique du produit. Pour obtenir la mise à jour administrateur, accédez au catalogue Microsoft Update et recherchez la version de la mise à jour vers laquelle vous souhaitez mettre à jour votre layout. Téléchargez le update.exe sur l'ordinateur qui héberge le Layout, ouvrez une invite de commandes avec élévation de privilèges et exécutez une commande comme ceci :

visualstudioupdate-16.0.0to16.11.23.exe layout --layoutPath c:\VSLayout

Notez qu’une mise à jour administrateur ne lance pas la création d’un nouveau layout, elle met uniquement à jour un layout existant. Vous devez utiliser un programme d’amorçage pour créer la disposition initiale.

Vous pouvez accéder à la page Versions de Visual Studio 2022 et télécharger un programme d’amorçage de version fixe spécifique, le copier dans votre disposition et l’utiliser pour mettre à jour la disposition à la version exacte spécifiée dans le programme d’amorçage. Vous utiliseriez exactement la même syntaxe que ci-dessus.

Vous pouvez utiliser une mise à jour administrateur pour mettre à jour votre layout vers une version spécifique du produit. Pour obtenir la mise à jour administrateur, accédez au catalogue Microsoft Update et recherchez la mise à jour vers laquelle vous souhaitez mettre à jour votre layout. Téléchargez le update.exe sur l'ordinateur qui héberge le Layout, ouvrez une invite de commandes avec élévation de privilèges sur cet ordinateur et exécutez une commande comme ceci :

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Notez qu’une mise à jour administrateur ne lance pas la création d’un nouveau layout, elle met uniquement à jour un layout existant. Vous devez utiliser un programme d’amorçage pour créer la disposition initiale.

Vérifier que votre disposition réseau est basée sur une version prise en charge

À l’occasion, lorsque les chaînes ne sont pas prises en charge, vous devez vous assurer que la disposition réseau continue d’être basée sur une chaîne prise en charge, afin que vos clients puissent continuer à recevoir des notifications de mises à jour de sécurité. Si votre layout est basé sur le canal VisualStudio.17.Release.LTSC.17.0, une fois que le canal 17.0 LTSC ne sera plus prise en charge en juillet 2023, nous ne publierons plus de mises à jour de sécurité et votre layout et vos clients ne seront plus sécurisés. Vous trouverez les dates de support des différents canaux Visual Studio 2022 ici.

Pour modifier la chaîne sur laquelle la disposition est basée, il est important d’acquérir le programme d’amorçage de la chaîne souhaitée à partir de la page Historique des mises en production de Visual Studio 2022, de le copier dans votre dossier de disposition et d’effectuer une mise à jour normale. Vos clients doivent alors être informés de manière opportune d’une mise à jour afin qu’ils puissent également rester en sécurité.

Modifier le contenu d’une disposition

Il est possible de modifier une disposition partielle et d’ajouter des charges de travail, des composants ou des langues supplémentaires. Il n’est pas possible de supprimer de manière fiable des composants d’une disposition.

Dans l’exemple ci-dessous, nous ajoutons la charge de travail Azure et une langue localisée à la disposition créée précédemment avec uniquement la charge de travail Managed Desktop et l’anglais. Une fois la modification effectuée, les charges de travail Managed Desktop et Azure, ainsi que les ressources anglaises et allemandes, sont incluses dans cette disposition. En plus d’ajouter des composants, la commande --layout entraîne la mise à jour de la disposition vers la version spécifiée par le programme d’amorçage. Par conséquent, si vous utilisez le programme d’amorçage persistant, la disposition résultante a le nouveau composant et la nouvelle langue, et tout le contenu de la disposition est mis à jour vers la dernière version sur le canal du programme d’amorçage.

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

Si vous souhaitez modifier une disposition partielle existante pour qu’elle devienne une disposition complète, utilisez l’option --all, comme indiqué dans l’exemple suivant. Là encore, cette commande entraîne la mise à jour du contenu de la disposition vers la version spécifiée par le programme d’amorçage.

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

Vous pouvez ajouter des composants à un layout en passant un *.vsconfig fichier contenant les composants supplémentaires que vous souhaitez dans votre layout. Si vous le faites, le nouveau contenu *.vsconfig écrasera le contenu existant layout.vsconfig. Pour plus d’informations, veuillez vous reporter à la section précédente Utiliser un fichier de configuration pour initialiser le contenu d’un agencement.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Enfin, vous pouvez modifier directement le fichier de configuration layout.json dans le dossier de disposition et mettre à jour la section « add » de ce fichier pour inclure les composants supplémentaires à inclure dans votre disposition. Vous devez ensuite mettre à jour la disposition en utilisant --layout, comme décrit précédemment, pour télécharger les derniers composants.

Remarque

Le moyen le plus simple d’installer les composants de disposition récemment ajoutés sur un ordinateur client consiste à exécuter le programme d’amorçage dans la disposition à partir de l’ordinateur client. La section « add » du fichier response.json dans la disposition détermine les composants sélectionnés par défaut dans l’interface utilisateur du programme d’installation du client. Si vous avez modifié la disposition à l’aide de l’une des méthodes ci-dessus, vous souhaiterez peut-être vérifier et ajuster manuellement la section « add » du fichier response.json afin qu’elle corresponde mieux au contenu de la section « add » du fichier layout.json nouvellement modifié.

Configurez la disposition pour supprimer les composants non pris en charge sur l’ordinateur client.

Certaines entreprises souhaitent tirer parti de la fonctionnalité introduite dans Visual Studio 2022 version 17.4 qui supprime les composants qui sont passés à un état non pris en charge. Cela est relativement facile à configurer si vous gérez une disposition et si vos clients reçoivent des mises à jour administrateur. Tout d’abord, vous devez configurer votre layout pour avoir la dernière version du programme d’installation, comme décrit ci-dessous. Ensuite, vous devez ajouter la ligne "removeOos": true au fichier response.json. Si ces deux détails sont correctement définis dans votre disposition, les mises à jour de l’administrateur suivantes respectent ce paramètre et suppriment les composants non pris en charge des ordinateurs clients.

Vérifier une disposition

Utiliser --verify pour effectuer une vérification sur la disposition réseau qui vérifie si les fichiers de packages sont manquants ou non valides. À la fin de la vérification, la liste des fichiers manquants et non valides est imprimée.

La vérification fonctionne seulement pour la dernière version d’une version mineure spécifique de Visual Studio. Dès qu’une nouvelle version est publiée, la vérification ne fonctionne pas pour les dispositions qui contiennent des versions précédentes.

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

Notes

Certains fichiers de métadonnées importantes, qui sont nécessaires à l’option --verify, doivent se trouver dans le dossier de disposition. Si ces fichiers de métadonnées sont manquants, "--verify" ne peut pas s’exécuter et le programme d’installation signale une erreur. Si vous rencontrez cette erreur, essayez de mettre à jour à nouveau la disposition ou recréez une disposition réseau dans un autre dossier.

N’oubliez pas que Microsoft envoie régulièrement des mises à jour à Visual Studio, donc si vous utilisez un programme d’amorçage persistant, un layout plus récent risque de contenir la même version que le layout initial. Toutefois, si vous utilisez un programme d’amorçage de liaison fixe, vous obtenez (presque) toujours un ensemble de fichiers déterministe.

Corriger une disposition

Utilisez --fix pour effectuer la même vérification que --verify et pour tenter également de résoudre les problèmes identifiés. Le processus --fix nécessite une connexion Internet, ainsi vous devez vous assurer que votre ordinateur est connecté à Internet avant d’appeler --fix.

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

Supprimer les versions antérieures d’une disposition

Suite aux mises à jour de disposition que vous avez effectuées vers un cache réseau, le dossier de disposition peut contenir quelques packages obsolètes qui ne sont plus utiles à la dernière installation en date de Visual Studio. Vous pouvez utiliser l’option --clean pour supprimer les packages obsolètes à partir du dossier de disposition réseau.

Pour ce faire, vous avez besoin du chemin de fichier du ou des manifestes de catalogue qui contiennent les packages obsolètes. Vous pouvez trouver les manifestes de catalogue dans un dossier Archive situé dans le cache de disposition réseau. Ils sont enregistrés à cet endroit lorsque vous mettez à jour une disposition. Dans le dossier Archive, il existe un ou plusieurs dossiers nommés GUID qui contiennent chacun un manifeste de catalogue obsolète. Le nombre de dossiers GUID doit être le même que le nombre de mises à jour apportées à vos dispositions.

Quelques fichiers sont enregistrés à l’intérieur de chaque dossier GUID. Les deux fichiers les plus intéressants sont « catalog.json » et « version.txt ». Le fichier catalog.json est le manifeste de catalogue obsolète que vous devez passer à l’option --clean. L’autre fichier, version.txt, contient la version de ce manifeste de catalogue obsolète. 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. Vous pouvez en faire de même lorsque vous parcourez les autres dossiers GUID. 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.

Voici un exemple d’utilisation de l’option --clean :

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

Lorsque vous exécutez cette commande, le programme d’installation analyse votre dossier de disposition réseau pour trouver la liste des fichiers à supprimer. Vous avez ensuite la possibilité de revoir les fichiers qui vont être supprimés pour confirmer les suppressions.

Configurer la disposition pour toujours inclure et fournir le dernier programme d’installation

Notes

Depuis juin 2023, le dernier programme d’installation est livré par défaut avec chaque mise à jour des versions prises en charge de Visual Studio 2017, Visual Studio 2019 et Visual Studio 2022. Par conséquent, vous n’avez pas besoin de faire quoi que ce soit d’explicite pour obtenir la dernière version du programme d’installation contenant les fonctionnalités et correctifs de bogues les plus récents dans votre layout et sur vos clients.

Toutefois, si vous utilisez un layout qui a été créé avant juin 2023, vous pouvez également configurer explicitement votre layout de façon à inclure et fournir systématiquement le dernier programme d’installation à vos clients, même si celui-ci est considéré comme faisant partie d’une version plus récente de Visual Studio. Ainsi, lorsque votre client met à jour à partir de cette disposition, le client acquiert le dernier programme d’installation inclus et fourni par cette disposition. L’avantage est qu’une fois que le dernier programme d’installation est sur votre client, vos installations clientes pourront tirer parti des correctifs de bogues et des nouvelles fonctionnalités que nous continuons à ajouter au programme d’installation.

Conseil

Si vous souhaitez changer l’emplacement où l’installation de Visual Studio 2019 de votre client recherche les mises à jour, vous devez avoir le dernier programme d’installation de Visual Studio 2022 sur votre ordinateur client. Pour ce faire, vous pouvez inclure le programme d’installation de Visual Studio 2022 dans vos dispositions Visual Studio 2019 à l’aide des paramètres décrits ci-dessous. La fonctionnalité d’utilisation du dernier programme d’installation n’est disponible que pour les programme d’amorçage Visual Studio 2019 qui ont été créés après la livraison initiale de Visual Studio 2022. Par conséquent, le vs_enterprise.exe dans l’exemple ci-dessous doit être une version qui a été livrée après le 10 novembre 2021.

Il existe plusieurs façons de permettre à votre layout d’inclure et de fournir le dernier programme d’installation :

  • Vous pouvez utiliser une version de Visual Studio qui a été créée en juin 2023 ou après.

  • Vous pouvez transmettre le paramètre --useLatestInstaller au programme d’amorçage lorsque vous créez ou mettez à jour la disposition. Cela permet de définir un paramètre dans le fichier layout.json, qui se trouve dans le répertoire racine du layout. Voici un exemple pour mettre à jour la disposition et la configurer pour utiliser le dernier et le plus grand programme d’installation disponible.

    vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
    
  • Vous pouvez modifier le fichier layout.json directement pour ajouter ce paramètre.

    {
       "installChannelUri": ".\\ChannelManifest.json",
       "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
       "installCatalogUri": ".\\Catalog.json",
       "channelId": "VisualStudio.16.Release",
       "productId": "Microsoft.VisualStudio.Product.Enterprise",
    
       "useLatestInstaller": true,
       "removeOos": true
    
    }
    

Il n’existe aucun moyen de supprimer par programmation ce paramètre dans le fichier layout.json. Par conséquent, si vous souhaitez que votre disposition cesse d’utiliser le dernier programme d’installation mis à disposition par Microsoft et utilise à la place la version du programme d’installation correspondant au programme d’amorçage (qui est probablement plus ancien que le programme d’installation le plus récent), modifiez le fichier layout.json et supprimez le paramètre "UseLatestInstaller": true.

Notez que vous pouvez également trouver ce paramètre "UseLatestInstaller": true dans le fichier response.json du layout, mais qu’il est ignoré là pour garantir que le layout a toujours le dernier programme d’installation. Le fichier response.json est utilisé pour définir les options de configuration par défaut sur le client lorsque le client installe ou met à jour à partir d’une disposition. Ce paramètre "useLatestInstaller": true particulier dans le fichier layout.json est utilisé pour garantir que le contenu du layout contient le dernier programme d’installation, afin que les ordinateurs clients puissent ensuite acquérir le dernier programme d’installation à partir du layout.

Codes d’erreur

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 :

Valeur Résultat
0 Opération effectuée avec succès
740 Élévation obligatoire
1001 Le processus du programme d’installation de Visual Studio est en cours d’exécution
1003 Visual Studio est en cours d’utilisation
1602 Opération annulée
1618 Autre installation en cours d’exécution
1641 Opération achevée avec succès, le redémarrage a été lancé
3010 Opération effectuée avec succès, mais l’installation nécessite un redémarrage avant de pouvoir être utilisée
5003 Le programme d’amorçage a échoué à télécharger le programme d’installation
5004 Opération annulée
5005 Erreur d’analyse de la ligne de commande du programme d’amorçage
5007 L’opération a été bloquée - l’ordinateur ne répond pas à la configuration requise
8001 Échec de la vérification de l’ordinateur ARM
8002 Échec de la vérification préalable du téléchargement en arrière-plan
8003 Échec sélectionnable non pris en charge
8004 Échec du répertoire cible
8005 Vérification de l’échec des charges utiles sources
8006 Processus Visual Studio en cours d’exécution
8010 Système d’exploitation non pris en charge. Reportez-vous à la configuration requise
-1073720687 Échec de connectivité
-1073741510 Microsoft Visual Studio Installer a été arrêté (par l’utilisateur ou par un processus externe)
Autres
(par exemple :
-1, 1, 1603)
Une condition d’échec s’est produite - Pour plus d’informations, consultez les journaux

Obtenir de l’aide pour votre disposition réseau

Si vous rencontrez un problème avec votre disposition réseau, nous voulons le savoir. La meilleure façon de nous le dire est d’utiliser l’outil Signaler un problème qui apparaît dans Visual Studio Installer et dans l’IDE Visual Studio. Si vous êtes administrateur informatique et que Visual Studio n’est pas installé, vous pouvez envoyer vos commentaires d’administrateur informatique ici. Lorsque vous utilisez cet outil, il serait très utile d’envoyer les journaux de l’outil Visual Studio Collect, ce qui peut nous aider à diagnostiquer et à résoudre le problème.

Nous offrons également une option de support par chat sur les installations (en anglais uniquement) pour les problèmes liés à l’installation.

D’autres options de support sont également à votre disposition. Consultez notre Communauté des développeurs Visual Studio.