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

📣Nous aimerions entendre vos commentaires !Veuillez prendre un moment pour effectuer cette enquête et nous faire savoir comment nous pouvons améliorer l’expérience de disposition. Merci pour votre soutien !

Parfois, un administrateur d’entreprise souhaite créer un cache d’installation privé (également appelé « disposition ») qui contient des fichiers Visual Studio qui peuvent être déployés sur des ordinateurs clients au sein d’une organisation.

La création d’une disposition est utile dans les situations suivantes :

• Un utilisateur dispose d’autorisations limitées
• Les ordinateurs clients ont un accès limité à Internet
• Une organisation souhaite normaliser une version particulière de l’ensemble d’outils de développement

Nous avons conçu Visual Studio afin qu’un administrateur puisse créer et gérer une disposition et le stocker sur un partage réseau interne et éventuellement le rendre disponible sur l’intranet d’une organisation. La disposition sert d’emplacement source pour tous les fichiers Visual Studio nécessaires à l’installation initiale du client et aux mises à jour suivantes.

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

• Créer la disposition: explique comment réaliser le plan avec le contenu approprié du produit, configurer les paramètres par défaut, le stocker sur un partage de fichiers réseau et le rendre accessible 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 la mise en page

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 vous avez plusieurs éditions de Visual Studio en cours d’utilisation dans votre entreprise (par exemple, Visual Studio 2022 Professional et Visual Studio 2022 Enterprise), vous devez créer une disposition distincte pour chaque édition. La création d’une disposition distincte pour chaque édition peut consommer beaucoup d’espace disque, en particulier lorsque vous envisagez que les mises à jour de disposition 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 programme d’amorçage approprié pour l’édition de Visual Studio souhaitée et copiez-le dans le répertoire que vous souhaitez utiliser comme référentiel de configuration. Une fois la disposition créée, 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 mise en page. Vous devez disposer d’une connexion Internet et des autorisations d’administrateur pour effectuer cette étape.

Les programmes d'amorçage suivants installent toujours la version la plus récente et la plus sécurisée de Visual Studio 2022 sur la chaîne actuelle, quel que soit le moment où vous les lancez. Sinon, 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 programme d’amorçage de la version stable et fixe pour la version de maintenance du canal souhaité à partir de l’historique des versions de Visual Studio 2022. Copiez-le dans le répertoire que vous souhaitez servir d’emplacement source de la disposition.

Édition	Programme d’amorçage
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Communauté Visual Studio 2022	vs_community.exe
Outils de génération Visual Studio 2022	vs_buildtools.exe

Conseil

Si vous avez précédemment téléchargé un fichier de programme d’amorçage et souhaitez vérifier la version qu’il installera, 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 en tant que « dernière version de maintenance de ce qui est spécifié », et le canal est supposé être Actif, 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 disposer d’une connexion Internet pour effectuer 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 de création de dispositions initiales. Vous trouverez d’autres exemples dans les exemples de paramètres de ligne de commande pour une page d’installation de Visual Studio.

Une disposition initiale complète pour les paramètres régionaux d’une langue unique 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 une disposition initiale de Visual Studio avec toutes les charges de travail et les langues appropriées et à stocker les packages dans le répertoire de disposition sur le serveur réseau. De cette façon, toute installation du client a accès à l’ensemble de l’offre de produit Visual Studio et à la possibilité d’installer n’importe quel sous-ensemble. Pour créer une disposition complète de Visual Studio, exécutez la commande suivante à partir du répertoire sur lequel vous envisagez d’héberger la disposition réseau :

vs_enterprise.exe --layout c:\VSLayout

Vérifiez que votre disposition est basée sur le canal approprié

Il est important de s'assurer que la configuration du réseau est basée sur le canal correct, car c'est l'un des critères qu'un administrateur utilise pour identifier les instances clientes à mettre à jour, s'il est déployé dans l'ensemble de l'organisation. Par exemple, si votre disposition est basée sur le canal VisualStudio.17.Release.LTSC.17.0 et si vos clients sont configurés pour recevoir des mises à jour des serveurs hébergés par Microsoft, toutes les mises à jour de sécurité mises à disposition sur le canal 17.0 LTSC sont disponibles pour les clients installés ou mis à jour à partir de cette disposition.

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'une mise en page

Vous pouvez utiliser plusieurs options pour 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. Une disposition partielle est utile si vous savez que vous allez déployer uniquement un sous-ensemble de charges de travail sur des stations de travail clientes. Les paramètres de ligne de commande classiques pour la personnalisation de la disposition sont les suivants :

• --add pour spécifier les ID de charge de travail ou de composant.
  Si --add est utilisé, seules les charges de travail et les composants spécifiés avec --add sont téléchargés. Si --add n’est pas utilisé, toutes les charges de travail et tous les composants sont téléchargés.
• --includeRecommended pour inclure tous les composants recommandés pour les ID de charge de travail spécifiés.
• --includeOptional pour inclure tous les composants facultatifs pour les identifiants de charge de travail spécifiés.
• --config d’utiliser un fichier *.vsconfig pour spécifier les charges de travail , les composants ou les extensions qui doivent être inclus ou référencés dans la disposition. 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 de création d’une disposition de réseau personnalisée.

• Pour créer une disposition avec les composants requis pour toutes les charges de travail dans un seul langage, exécutez :

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Pour créer une disposition 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 une disposition 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 une disposition 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’une disposition

Vous pouvez utiliser le paramètre --config pour transmettre 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 de disposition personnalise et limite le contenu d’une disposition réseau à ce qui est spécifié dans le fichier de configuration. Le fichier de configuration est copié dans le répertoire de disposition et renommé en layout.vsconfig.

Les extensions spécifiées dans le fichier *.vsconfig ne sont pas copiées directement dans la mise en page. Au lieu de cela, le fichier response.json de disposition contient une référence au fichier 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, veillez à modifier la response.json pour ajouter "allowUnsignedExtensions": true. Consultez response.json exemples de contenu.

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

Copier la mise en page vers un partage réseau

Vous devez héberger la disposition sur un partage réseau afin qu’elle soit accessible à partir des ordinateurs clients. Si vous avez créé la disposition sur un ordinateur local, vous devez la 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 d’installation initiale du client pour cette disposition

Un fichier appelé response.json est créé dans le dossier racine de la configuration. Ce fichier personnalisable fournit les paramètres par défaut initiaux à configurer sur le client, lorsque le client est initialement installé à partir de cette disposition. Les options de configuration courantes incluent la possibilité de configurer :

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

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

Rendre votre disposition accessible via un site intranet

À compter de juin 2023, vous pouvez rendre vos dispositions disponibles sur un site intranet interne, ce qui vous permet de tirer parti des fonctionnalités de mise en cache et de géoréplication des fichiers webserver. Pour utiliser cette nouvelle fonctionnalité, vous devez utiliser les derniers programme d’amorçage Visual Studio et le dernier programme d’installation de Visual Studio. Les administrateurs informatiques doivent effectuer les opérations suivantes pour tirer parti de cette fonctionnalité d’hébergement web intranet :

1. Tout d’abord, créez et gérez un schéma de réseau et assurez-vous que les éléments sont présents et régulièrement mis à jour sur la ressource 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, un administrateur devra préparer un site Internet interne et lier la source du site à l'emplacement du fichier réseau de la mise en page. 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 cette disposition sur le client, exécuter un script PowerShell sur le client pour effectuer l’installation initiale. Une fois que Visual Studio s’installe avec succès sur le client à partir d’une disposition hébergée sur le web, les mises à jour du client pour les layouts hébergés sur le web peuvent être mises à jour via des méthodes standards.

Assurez-vous que votre mise en page utilise le dernier programme d’installation

Remarque

Depuis juin 2023, le dernier programme d’installation est fourni par défaut avec chaque mise à jour vers 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 de ces versions de produit, vous n’aurez rien à faire explicitement pour obtenir la dernière version du programme d’installation avec les dernières fonctionnalités et correctifs de bogues.

Si vous utilisez une version de Visual Studio fournie avant juin 2023, nous vous recommandons d’utiliser toujours la dernière version de Visual Studio Installer dans votre disposition et de la distribuer à vos clients. Par exemple, si vous distribuez le programme d’installation de Visual Studio 2022 dans votre disposition Visual Studio 2019, vos clients Visual Studio 2019 basés sur cette disposition ont la possibilité de modifier l’emplacement source des mises à jour ou de supprimer facilement les composants hors support. Des détails complémentaires sont décrits dans la section suivante.

La possibilité de vous assurer par programmation que vous utilisez le dernier programme d’installation est disponible uniquement pour les programme d’amorçage Visual Studio 2019 qui ont été créés après l’expédition initiale de Visual Studio 2022. Par conséquent, le vs_enterprise.exe dans l’exemple suivant doit être une version fournie après le 10 novembre 2021.

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

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

Conserver votre mise en page

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 la disposition peut être utilisée à la fois en tant que point d’installation et source de mise à jour pour les installations du client. La section suivante décrit les opérations de maintenance de disposition les plus courantes ou utiles.

Si vous hébergez une disposition sur un partage de fichiers réseau, vous pouvez télécharger une disposition mise à jour vers un partage local privé (par exemple, c :\VSLayoutUpdate), puis, une fois que tout le contenu mis à jour est téléchargé, copiez-le dans votre partage de fichiers réseau de disposition (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 conserver votre disposition mise à 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 les mises à jour de sécurité le deuxième mardi du mois, appelé « Patch Tuesday », de sorte qu’une bonne stratégie consisterait à mettre à jour toutes vos configurations le mardi après-midi du Patch Tuesday.

Lorsque vous créez la disposition initiale, les options spécifiées, telles que les charges de travail et les langues à inclure dans la disposition, sont enregistrées dans le fichier de configuration de la disposition layout.json. Plus tard, lorsque vous mettez à jour cette disposition vers une version plus récente du produit, vous n’avez pas besoin de spécifier à nouveau les composants du produit souhaités dans la disposition. Une mise à jour de disposition met simplement à jour les composants existants de la disposition 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ée sur les 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 mise en page vers une version mise à jour de manière autonome. L’opération de disposition exécute le processus d’installation dans une nouvelle fenêtre de console. La fenêtre est ouverte afin que les administrateurs puissent voir le résultat de la mise à jour de disposition finale et un résumé des erreurs qui peuvent se produire. Si vous souhaitez effectuer une opération de mise à jour de disposition de manière sans assistance (par exemple, vous disposez d’un script qui est régulièrement exécuté pour mettre à jour votre disposition vers la dernière version), utilisez le paramètre --passive et 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

Parfois, vous pouvez mettre à jour votre mise en page vers une version particulière du produit. Par exemple, vous souhaiterez peut-être que votre disposition corresponde à la dernière version sécurisée de la base de référence de maintenance sur laquelle vous avez normalisé votre organisation. Voici comment procéder :

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 d’administrateur pour mettre à jour votre disposition 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 en mode administrateur sur cet ordinateur et exécutez une commande comme suit :

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

Notez qu’une mise à jour d’administrateur ne lance pas la création d’une nouvelle disposition ; il ne met à jour qu’une disposition existante. Vous devez utiliser un programme d’amorçage pour créer la disposition initiale.

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

Parfois, lorsque des canaux ne sont plus pris en charge, vous devez vous assurer que la disposition du réseau reste basée sur un canal pris en charge afin que vos clients puissent continuer à recevoir des notifications de mises à jour de sécurité. Si votre disposition est basée sur le canal VisualStudio.17.Release.LTSC.17.0, une fois que le canal 17.0 LTSC ne sera plus pris en charge en juillet 2023, nous ne publierons plus de mises à jour de sécurité et votre disposition et vos clients deviendront non 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 ensuite être avertis de manière appropriée d’une mise à jour afin qu’ils puissent rester sécurisés également.

Modifier le contenu d’une disposition

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

Dans l’exemple ci-dessous, nous allons ajouter 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 la langue anglaise. Une fois que nous avons apporté la modification, les charges de travail Managed Desktop et Azure, et les ressources anglaises et allemandes seront incluses dans cette disposition. Outre l’ajout de composants, la commande --layout entraîne également la mise à jour de la mise en page 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 afin qu’elle devienne une disposition complète, utilisez l’option --all, comme illustré dans l’exemple suivant. Encore une fois, cette commande met à jour le contenu de la mise en page à la version spécifiée par le bootstrap.

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

Vous pouvez ajouter des composants à une disposition en transmettant un fichier *.vsconfig qui contient les composants supplémentaires souhaités dans votre disposition. Si vous effectuez cette opération, le nouveau contenu *.vsconfig remplacera le contenu layout.vsconfig existant. Pour plus d’informations, reportez-vous à la section précédente Utilisation d’un fichier de configuration pour initialiser le contenu d’une disposition.

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 « ajouter » de ce fichier pour inclure les composants supplémentaires que vous souhaitez inclure dans votre disposition. Vous devez ensuite mettre à jour la disposition à l’aide de --layout, comme décrit précédemment pour télécharger les derniers composants.

Remarque

Le moyen le plus simple d’installer les nouveaux composants de mise en page sur une machine cliente consiste à exécuter le bootstrapper dans le dossier de mise en page à 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 pouvez vérifier manuellement et éventuellement ajuster la section « ajouter » dans le fichier response.json afin qu’elle corresponde plus correctement au contenu de la section « ajouter » du fichier layout.json nouvellement modifié.

Configurez la disposition pour supprimer les composants hors support 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 ont été transférés vers un état hors support. Cela est relativement facile à configurer si vous gérez une disposition et si vos clients reçoivent des mises à jour d’administrateur. Tout d’abord, vous devez configurer votre mise en page pour avoir la dernière version de l’installateur, comme décrit ci-dessous. Deuxièmement, vous devez ajouter la ligne "removeOos": true au fichier response.json. Si votre disposition comporte ces deux détails correctement définis, les mises à jour d’administrateur suivantes respectent ce paramètre et suppriment les composants hors support des ordinateurs clients.

Vérifier une disposition

Utilisez --verify pour effectuer la 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, il imprime la liste des fichiers manquants et non valides.

La vérification fonctionne uniquement 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 fonctionnera pas pour les dispositions qui contiennent des versions précédentes.

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

Remarque

Certains fichiers de métadonnées importants nécessaires par 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 vous donne 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 des bootstrappers à lien fixe , vous obtiendrez (presque) toujours un ensemble de fichiers déterministe.

Corriger une disposition

Utilisez --fix pour effectuer la même vérification que --verify et essayez également de résoudre les problèmes identifiés. Le processus --fix a besoin d’une connexion Internet. Assurez-vous que votre machine est connectée à Internet avant d’appeler --fix.

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

Supprimer les versions antérieures d’une disposition

Une fois que vous avez effectué des mises à jour de disposition vers un cache réseau, le dossier de disposition peut avoir des packages obsolètes qui ne sont plus nécessaires par la dernière installation de Visual Studio. Vous pouvez utiliser l’option --clean pour supprimer les packages obsolètes du dossier de disposition réseau.

Pour ce faire, vous aurez besoin du ou des chemins d’accès de fichier aux manifestes de catalogue qui contiennent ces packages obsolètes. Vous trouverez les manifestes du catalogue dans un dossier « Archive » dans le cache de disposition réseau. Ils sont enregistrés là lorsque vous mettez à jour une mise en page. Dans le dossier « Archive », il existe un ou plusieurs dossiers nommés « GUID », chacun contenant un manifeste de catalogue obsolète. Le nombre de dossiers « GUID » doit être identique au nombre de mises à jour apportées à vos dispositions.

Quelques fichiers sont enregistrés dans chaque dossier « GUID ». Les deux fichiers les plus intéressants sont un fichier «catalog.json» et un fichier «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 si vous souhaitez supprimer des packages obsolètes de ce manifeste de catalogue. Vous pouvez faire la même chose quand vous parcourez les autres dossiers « GUID ». Une fois que vous avez décidé du ou des catalogues que vous souhaitez nettoyer, exécutez la commande --clean en fournissant les chemins d’accès aux fichiers à 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 rechercher la liste des fichiers qu’il supprimera. Vous aurez ensuite la possibilité de passer en revue les fichiers qui vont être supprimés et de confirmer les suppressions.

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

Remarque

Depuis juin 2023, le dernier programme d’installation est fourni par défaut avec chaque mise à jour vers les versions prises en charge de Visual Studio 2017, Visual Studio 2019 et Visual Studio 2022. Vous n’aurez donc rien à faire explicitement pour obtenir la dernière version du programme d’installation avec les dernières fonctionnalités et correctifs de bogues dans votre configuration et pour vos clients.

Toutefois, si vous utilisez une disposition créée avant juin 2023, vous pouvez également configurer explicitement votre disposition pour que elle inclue et fournisse toujours le dernier programme d’installation à vos clients, même si celui-ci fait partie d’une version plus récente de Visual Studio. Par conséquent, lorsque votre client est mis à 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 le dernier programme d’installation sur votre client, vos installations clientes pourront tirer parti des correctifs de bogues et de nouvelles fonctionnalités que nous continuons à ajouter au programme d’installation.

Il existe plusieurs façons de configurer votre mise en page pour inclure et proposer la dernière version du 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 entraîne la définition d’un paramètre dans le fichier layout.json, qui se trouve dans le répertoire racine de la disposition. Voici un exemple pour mettre à jour la mise en page et la configurer afin d'utiliser le programme d’installation le plus récent et le meilleur 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 de la mise en page, mais il y est ignoré pour garantir que la mise en page a toujours le dernier programme d'installation. Le fichier response.json est utilisé pour définir les options par défaut de configuration 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, selon le résultat de l’opération, la variable d’environnement %ERRORLEVEL% est définie sur l’une des valeurs suivantes :

Valeur	Résultat
0	Opération terminée avec succès
740	Élévation requise
1001	Le processus d’installation de Visual Studio est en cours d’exécution
1003	Visual Studio est en cours d’utilisation
1602	L’opération a été annulée
1618	Une autre installation en cours d’exécution
1641	L’opération s’est terminée avec succès et le redémarrage a été lancé
3010	L’opération s’est terminée correctement, 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	L’opération a été annulée
5005	Erreur d’analyse de la ligne de commande du programme d’amorçage
5007	Opération bloquée : l’ordinateur ne répond pas aux exigences
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 le processus externe)
Autre (par exemple : -1, 1, 1603 )	Une condition d’échec s’est produite - Pour plus d’informations, consultez les journaux

Obtenez de l'assistance pour votre architecture réseau

Si vous rencontrez un problème avec votre disposition réseau, nous voulons en savoir plus. La meilleure façon de nous dire est d’utiliser l’outil Signaler un problème qui apparaît à la fois 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 d’activité par l’outil Visual Studio Collect qui peut nous aider à diagnostiquer et résoudre le problème.

Nous proposons également une assistance par chat d’installation (anglais uniquement) pour les problèmes liés à l’installation.

Nous avons également d’autres options de support disponibles. Consultez notre Communauté des développeurs Visual Studio.

Contenu connexe

• guide d’administrateur Visual Studio
• Déployer Visual Studio à partir d’un layout sur un ordinateur client
• Mettre à jour une installation basée sur le réseau de Visual Studio
• résoudre les erreurs liées au réseau lorsque vous installez ou utilisez Visual Studio
• configurer des stratégies pour les déploiements d’entreprise de Visual Studio
• cycle de vie et maintenance des produits Visual Studio
• Utiliser des paramètres de ligne de commande pour installer Visual Studio
• ID de charge de travail et de composant Visual Studio
• Installer des certificats requis pour l’installation hors connexion de Visual Studio