Freigeben über


Bereitstellen von Visual Studio über ein Layout auf einem Clientcomputer

📣Wir freuen uns, Ihr Feedback zu hören!Bitte nehmen Sie sich einen Moment Zeit, um diese Umfrage abzuschließen, und teilen Sie uns mit, wie wir die Layouterfahrung verbessern können. Vielen Dank für Ihre Unterstützung!

Um ein Layout auf einem Clientcomputer bereitzustellen, müssen Sie zuerst die folgenden Themen berücksichtigen:

Installieren von Visual Studio auf einem Clientcomputer über ein Layout

Administratoren können ein Visual Studio-Layout programmgesteuert als Teil eines Installationsskripts auf Clientarbeitsstationen bereitstellen.

Installieren über ein Netzwerklayout

Ein Benutzer mit Administratorberechtigungen kann Visual Studio über ein Netzwerklayout im unbeaufsichtigten Modus installieren, indem er den folgenden Befehl ausführt. Die response.json im Layout stellen die Standardkonfigurationseinstellungen für die Installation bereit.

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

Wenn Benutzer*innen jemals Elemente auswählen, die im Layout nicht verfügbar sind, versucht das Installationsprogramm, diese zusätzlichen Dateien von den von Microsoft gehosteten Servern im Internet zu beziehen. Um sicherzustellen, dass das Installationsprogramm nicht versucht, beim Installieren des Produkts auf das Internet zuzugreifen, verwenden Sie die option --noweb. Verwenden Sie beispielsweise diesen Befehl, um die Installation auszuführen und zu verhindern, dass der Clientcomputer auf das Internet zugreift:

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

Anmerkung

Sich gedulden. Stellen Sie sicher, dass sowohl das Installationsprogramm als auch das Produkt den Vorgang abgeschlossen haben (--wait). Wenn Sie einen Client über ein Layout installieren oder aktualisieren, ist das Installationsprogramm immer das erste, was installiert oder aktualisiert werden soll, und dann wird das Visual Studio-Produkt selbst installiert oder aktualisiert. Beide dieser Prozesse müssen beendet sein, um als erfolgreiches Update zu gelten.

Beim Ausführen der Installation oder Aktualisierung als Teil einer unbeaufsichtigten automatisierten Batchdatei ist die option --wait hilfreich, um sicherzustellen, dass der vs_enterprise.exe Prozess wartet, bis die Installation abgeschlossen ist, bevor ein Exitcode zurückgegeben wird. Dies ist nützlich, wenn ein Unternehmensadministrator weitere Aktionen für eine abgeschlossene Installation ausführen möchte, z. B. einen Product Key auf eine erfolgreiche Installationanwenden möchte. Die Verwendung der Option --wait verhindert, dass nachfolgende Vorgänge vorzeitig gestartet werden. Wenn Sie --waitnicht verwenden, kann der vs_enterprise.exe Prozess beendet werden, bevor beide Teile der Installation abgeschlossen sind, und gibt daher einen ungenauen Exitcode zurück, der nicht den Zustand des Installationsvorgangs darstellt.

Installieren über einen internen Intranetspeicherort

Einige Unternehmen möchten das Layout an einem Intranetstandort hosten, um geografische Leistungsengpässe besser zu verwalten und die Webzwischenspeicherung zu nutzen. Um ein intranetgehostetes Layout auf einem Clientcomputer bereitzustellen, muss ein Benutzer mit Administratorberechtigungen ein PowerShell-Skript mit erhöhten Rechten wie das folgende ausführen, um die Installation auf dem Clientcomputer zu initialisieren.

    #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

Vorbereiten der Clientcomputer

Erlaubnisse

Stellen Sie sicher, dass das Benutzer- oder Systemkonto, das die Installation ausführt, über ordnungsgemäßen Zugriff auf die Netzwerkfreigabe verfügt, die das Layout enthält. Weitere Informationen finden Sie auf der Seite Problembehandlung bei netzwerkbezogenen Fehlern bei der Installation oder Verwendung von Visual Studio.

Installieren auf einem Client, der keinen Internetzugang hat

Sie müssen sicherstellen, dass alle Offlineclientcomputer die richtigen Zertifikateinstalliert haben.

Wenn Sie eine Installation über ein Layout durchführen, sucht das Installationsprogramm auf dem Client immer nach den Visual Studio-Paketen am Speicherort des Layouts. Wenn das Installationsprogramm jedoch Komponenten installieren möchte, die nicht im Layout enthalten sind, versucht es, die Visual Studio-Pakete aus der Updatequelle abzurufen. Diese werden von Administrator*innen häufig so konfiguriert, dass sie auf sich selbst verweisen.

Wenn Sie explizit verhindern möchten, dass visual Studio Installer versucht, fehlende Inhalte von von Microsoft gehosteten Servern im Web herunterzuladen, können Sie den parameter --noWebverwenden. Wenn --noWeb verwendet wird und im Layout eine für die Installation gewählte Komponente fehlt, schlägt das Setup fehl. Wenn --noWeb verwendet wird und das Layout auf Ihren Intranetwebservern und nicht auf einer Dateinetzwerkfreigabe gehostet wird, ist das Setup ebenfalls nicht erfolgreich.

Die Verwendung der option --noweb behebt häufig die Fehlermeldung "Ein Produkt, das den folgenden Parametern entspricht, kann nicht gefunden werden".

Computerressourcen

Stellen Sie sicher, dass ihr vollständiger Installationspfad weniger als 80 Zeichen enthält und der Computer über ausreichend Speicherplatz verfügt. Eine vollständige Installation von Visual Studio erfordert mindestens 45 -50 GB Speicherplatz.

Fehlercodes

Wenn Sie den --wait-Parameter verwendet haben, wird abhängig vom Ergebnis des Vorgangs die %ERRORLEVEL% Umgebungsvariable auf einen der folgenden Werte festgelegt:

Wert Ergebnis
0 Der Vorgang wurde erfolgreich abgeschlossen.
740 Erhöhung erforderlich
1001 Der Visual Studio-Installationsprozess wird ausgeführt.
1003 Visual Studio wird verwendet
1602 Der Vorgang wurde abgebrochen.
1618 Eine andere Installation wird ausgeführt.
1641 Der Vorgang wurde erfolgreich abgeschlossen, und der Neustart wurde initiiert.
3010 Der Vorgang wurde erfolgreich abgeschlossen, die Installation erfordert jedoch einen Neustart, bevor er verwendet werden kann.
5003 Bootstrapper konnte das Installationsprogramm nicht herunterladen.
5004 Der Vorgang wurde abgebrochen.
5005 Bootstrapper-Befehlszeilenanalysefehler
5007 Der Vorgang wurde blockiert – der Computer erfüllt nicht die Anforderungen.
8001 Fehler bei ARM-Computerüberprüfung
8002 Fehler bei Vorabprüfung des Hintergrunddownloads
8003 Fehler wegen nicht mehr unterstützter Auswahl
8004 Zielverzeichnisfehler
8005 Fehler beim Überprüfen der Quellnutzlasten
8006 Ausgeführte Visual Studio-Prozesse
8010 Das Betriebssystem wird nicht unterstützt. Verweis auf Systemanforderungen
-1073720687 Konnektivitätsfehler
-1073741510 Microsoft Visual Studio Installer wurde beendet (vom Benutzer oder externen Prozess)
Andere
(Beispiel:
-1, 1, 1603)
Fehlerzustand aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen.

Holen Sie sich Unterstützung für die Bereitstellung Ihres Layouts

Wenn bei der Bereitstellung Ihres Layouts auf einem Clientcomputer ein Problem auftritt, möchten wir es wissen. Die beste Möglichkeit, uns mitzuteilen, ist die Verwendung des tools Melden eines Problems, das sowohl im Visual Studio-Installer als auch in der Visual Studio-IDE angezeigt wird. Wenn Sie ein IT-Administrator sind und Visual Studio nicht installiert haben, können Sie IT-Administratorfeedback hierübermitteln. Wenn Sie dieses Tool verwenden, wäre es hilfreich, wenn Sie die Protokolle vom VS Collect-Toolsenden könnten, was uns helfen kann, das Problem zu diagnostizieren und zu beheben.

Außerdem bieten wir eine Installationschat- (nur englisch) Unterstützungsoption für installationsbezogene Probleme an.

Wir haben auch andere Supportoptionen zur Verfügung. Sehen Sie sich unsere Visual Studio Developer Communityan.