Freigeben über

Bereitstellen von Visual Studio über ein Layout auf einem Clientcomputer

  • Artikel

Wir freuen uns auf Ihr Feedback!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

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

Installieren über ein Netzwerklayout

Benutzer*innen mit Administratorberechtigungen können Visual Studio über ein Netzwerklayout in einem unbeaufsichtigten Modus installieren, indem sie den folgenden Befehl ausführen. response.json im Layout gibt die Standardkonfigurationseinstellungen für die Installation an.

\\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 Ihr Installationsprogramm nicht versucht, beim Installieren des Produkts auf das Internet zuzugreifen, verwenden Sie die --noweb-Option. 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

Hinweis

Warten Sie einen Augenblick. Vergewissern Sie sich, dass sowohl das Installationsprogramm als auch das Produkt den Vorgang abgeschlossen haben (--wait). Beim Installieren oder Aktualisieren eines Clients über ein Layout wird das Installationsprogramm immer zuerst installiert oder aktualisiert und dann das eigentliche Visual Studio-Produkt. Ein Update gilt dann als erfolgreich, wenn beide Prozesse abgeschlossen wurden.

Beim Ausführen der Installation oder des Updates als Teil einer unbeaufsichtigten automatisierten Batchdatei lässt sich mit der Option --wait sicherstellen, 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 die abgeschlossene Installation durchführen möchte, etwa das Anwenden eines Product Key auf eine erfolgreiche Installation. Mit der Option --wait lässt sich verhindern, dass nachfolgende Vorgänge vorzeitig gestartet werden. Wenn Sie --wait nicht verwenden, wird der Prozess vs_enterprise.exe möglicherweise beendet, bevor die beide Teile der Installation abgeschlossen sind, und gibt daher einen ungenauen Exitcode zurück, der keinen Aufschluss über den Installationsvorgang gibt.

Installieren über einen internen Intranetspeicherort

Einige Unternehmen möchten das Layout an einem Intranetspeicherort hosten, um geografische Leistungsengpässe besser bewältigen und die Vorteile der Webzwischenspeicherung nutzen zu können. Um ein im Intranet gehostetes Layout auf einem Clientcomputer bereitzustellen, müssen Benutzer*innen 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

Berechtigungen

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 Beheben von Netzwerkfehlern bei der Installation oder Verwendung von Visual Studio.

Installation auf einem Client ohne Internetzugriff

Sie müssen sicherstellen, dass auf allen Offlineclientcomputern die richtigen Zertifikate installiert sind.

Wenn die Installation über ein Layout erfolgt, 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 der Visual Studio-Installer versucht, fehlende Inhalte von den von Microsoft gehosteten Servern im Web herunterzuladen, können Sie den --noWeb-Parameter verwenden. Wenn --noWeb verwendet wird und eine Komponente im Layout fehlt, die zur Installation ausgewählt wurde, tritt beim Setup ein Fehler auf. Wenn --noWeb verwendet wird und das Layout auf Ihren Intranetwebservern und nicht auf einer Dateinetzwerkfreigabe gehostet wird, ist das Setup ebenfalls nicht erfolgreich.

Mithilfe der Option --noweb kann die Fehlermeldung „Ein Produkt, das mit den folgenden Parametern übereinstimmt, wurde nicht gefunden.“ häufig behoben werden.

Computerressourcen

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

Fehlercodes

Wenn Sie den Parameter --wait nicht verwenden, wird je nach Ergebnis des Vorgangs die Umgebungsvariable %ERRORLEVEL% auf einen der folgenden Werte festgelegt:

Wert Ergebnis
0 Der Vorgang wurde erfolgreich abgeschlossen.
740 Rechteerweiterung erforderlich
1001 Visual Studio-Installer 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 ein Neustart wurde eingeleitet.
3010 Der Vorgang wurde erfolgreich abgeschlossen, für die Installation ist jedoch ein Neustart erforderlich, bevor sie verwendet werden kann.
5003 Fehler bei Bootstrapper beim Herunterladen des Installers
5004 Der Vorgang wurde abgebrochen.
5005 Bootstrapper-Befehlszeilen-Analysefehler
5007 Der Vorgang wurde blockiert – der Computer entspricht nicht den 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 Visual Studio-Prozesse werden ausgeführt
8010 Das Betriebssystem wird nicht unterstützt. Verweis auf Systemanforderungen
-1073720687 Konnektivitätsfehler
-1073741510 Microsoft Visual Studio-Installer wurde beendet (durch den Benutzer oder einen externen Prozess)
Sonstiges
(Beispiel:
-1, 1, 1603)		 Es ist ein Fehler aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen

Unterstützung für die Bereitstellung Ihres Layouts

Wenn bei der Bereitstellung Ihres Layouts auf einem Clientcomputer ein Problem auftritt, teilen Sie uns das bitte mit. Nutzen Sie dazu am besten das Tool Problem melden, das sowohl im Visual Studio-Installer als auch in der Visual Studio-IDE zur Verfügung steht. IT-Administratoren, bei denen Visual Studio nicht installiert ist, können hier IT-Administrator-Feedback geben. Wenn Sie dieses Tool nutzen, hilft es uns, wenn Sie uns die Protokolle des VS Collect-Tools senden, die uns bei der Diagnose und Behebung des Problems unterstützen.

Für installationsbezogene Probleme wird außerdem eine Livechat-Supportoption angeboten (nur auf Englisch).

Wir bieten auch noch weitere Supportoptionen. Schauen Sie bei unserer Visual Studio-Entwicklercommunity vorbei.

Zugehöriger Inhalt