Déployer Visual Studio à partir d’un layout sur un ordinateur client

  • Article

Pour déployer un layout sur un ordinateur client, vous devez d’abord prendre en compte les points suivants :

Installer Visual Studio sur un ordinateur client à partir d’un layout

Les administrateurs peuvent déployer un layout de Visual Studio sur les stations de travail clientes de manière programmatique dans le cadre d’un script d’installation.

Installer à partir d’un layout réseau

Un utilisateur disposant d’autorisations d’administrateur peut installer Visual Studio à partir d’un layout réseau en mode sans assistance en exécutant la commande suivante. Le response.json dans le layout fournit les paramètres de configuration par défaut pour l’installation.

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

Si l’utilisateur sélectionne des éléments qui ne sont pas disponibles dans le layout, le programme d’installation tente de sourcer ces autres fichiers dans les serveurs hébergés par Microsoft sur Internet. Pour que votre programme d’installation n’essaie pas d’accéder à Internet pendant l’installation du produit, utilisez le commutateur --noweb. Par exemple, utilisez cette commande pour exécuter l’installation et empêcher l’ordinateur client d’accéder à Internet :

\\server\products\VS\vs_enterprise.exe --noWeb --wait --passive --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional

Notes

Soyez patient. Assurez-vous --wait que le programme d’installation et le produit se terminent. Lors de l’installation ou de la mise à jour d’un client à partir d’une disposition, le programme d’installation est toujours la première chose à installer ou à mettre à jour, puis le produit Visual Studio lui-même est installé ou mis à jour. Ces deux processus doivent se terminer pour être considérés comme une mise à jour réussie.

Lors de l’exécution de l’installation ou de la mise à jour dans le cadre d’un fichier de traitement automatisé sans assistance, l’option --wait est utile pour s’assurer que le processus vs_enterprise.exe attend la fin de l’installation avant de renvoyer un code de sortie. Cela est utile quand un administrateur d’entreprise souhaite effectuer des actions supplémentaires sur une installation complète, comme appliquer une clé de produit à une installation réussie. L’utilisation de l’option --wait empêche les opérations suivantes de démarrer prématurément. Si vous n’utilisez pas --wait, le processus vs_enterprise.exe peut s’arrêter avant que l’installation soit terminée et retournera ainsi un code de sortie incorrect qui ne représente pas l’état de l’opération d’installation.

Installer à partir d’un emplacement intranet interne

Certaines entreprises souhaitent héberger le layout sur un emplacement intranet pour mieux gérer les goulots d’étranglement de performance géographiques et tirer parti de la mise en cache web. Pour déployer un layout hébergé sur un intranet sur un ordinateur client, un utilisateur disposant d’autorisations d’administrateur doit exécuter un script PowerShell avec élévation de privilèges similaire à ce qui suit pour initialiser l’installation sur l’ordinateur client.

    #Do the initial installation from the web hosted layout onto the client in an elevated PowerShell script

    #ADMIN CONFIGURATION
    #Enter layout URI here
    $LayoutUri = "http://MyCompanyIntranetSite/VS2022Enterprise/"

    #Enter bootstrapper name which is present in layout.
    $BootstrapperName = "vs_Enterprise.exe"

    #Add any arguments which you intend to send to bootstrapper.
    $Arguments = "--passive --wait"

    #SCRIPT FUNCTIONALITY
    #Forming URI for bootstrapper
    Write-Verbose "LayoutUri: $LayoutUri"
    $BootstrapperUri = "$LayoutUri/$BootstrapperName"
    Write-Verbose "BootstrapperUri: $BootstrapperUri"

    $Arguments += " --layoutUri $LayoutUri"
    Write-Verbose "Arguments: $Arguments"

    #Creating temp folder and download bootstrapper
    $VSLayoutFolderPath = Join-Path -Path $env:TEMP -ChildPath VSLayout
    $BootstrapperFile = Join-Path -Path $VSLayoutFolderPath -ChildPath $BootstrapperName
    Write-Verbose "The bootstrapper path is: $BootstrapperFile"

    if (Test-Path $VSLayoutFolderPath)
    {
    Write-Verbose "The directory exists - $VSLayoutFolderPath"
    if (Test-Path $BootstrapperFile)
    {
    Write-Verbose "Deleting file - $BootstrapperFile"
    Remove-Item $BootstrapperFile
    }
    }
    else
    {
    Write-Verbose "Creating folder - $VSLayoutFolderPath"
    New-Item -ItemType Directory -Path $VSLayoutFolderPath
    }

    Write-Verbose "Downloading bootstrapper from - $BootstrapperUri to $BootstrapperFile"
    Invoke-WebRequest -Uri $BootstrapperUri -OutFile $BootstrapperFile
    
    Write-Verbose "Starting bootstrapper -$BootstrapperFile with arguments $Arguments"
    start-process $BootstrapperFile $Arguments

Préparer les ordinateurs clients

Autorisations

Assurez-vous que l’utilisateur ou le compte système qui exécute l’installation dispose d’un accès approprié au partage réseau qui contient la disposition. Pour plus d’informations, consultez la page Résoudre les erreurs liées au réseau lorsque vous installez ou utilisez Visual Studio.

Installer sur un client qui n’a pas accès à Internet

Vous devez vous assurer que les certificats appropriés sont installés sur tous les ordinateurs clients hors connexion.

Lorsque vous installez à partir d’un layout, le programme d’installation sur le client recherche toujours les packages Visual Studio à l’emplacement du layout. Toutefois, si le programme d’installation tente d’installer des composants qui ne sont pas inclus dans le layout, il tente d’acquérir les packages Visual Studio à partir de la source de mise à jour, que les administrateurs configurent souvent pour pointer vers elle-même.

Si vous souhaitez empêcher explicitement Visual Studio Installer de tenter de télécharger du contenu manquant à partir des serveurs hébergés par Microsoft sur le web, vous pouvez utiliser le paramètre --noWeb. Si --noWeb est utilisé et qu’il manque au layout un composant qui a été sélectionné pour être installé, l’installation échoue. De même, si --noWeb est utilisé et que le layout est hébergé sur vos serveurs web intranet par opposition à un partage réseau de fichiers, l’installation échoue.

L’utilisation du commutateur --noweb corrige souvent le message d’erreur « Un produit correspondant aux paramètres suivants est introuvable ».

Ressources de l’ordinateur

Assurez-vous que votre chemin d’installation complet comporte moins de 80 caractères et que votre ordinateur dispose d’un espace de stockage suffisant. Une installation complète de Visual Studio demande au minimum 45 à 50 Go d’espace disque.

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 déployer votre layout

Si vous rencontrez un problème lors du déploiement de votre layout sur un ordinateur client, nous aimerions 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 utile d’envoyer les journaux via l’outil VS Collect pour 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.

Contenu connexe