Erstellen und Verwalten einer Netzwerkinstallation von Visual Studio

Manchmal möchte ein Unternehmensadministrator einen privaten Installationscache (auch als „Layout“ bezeichnet) erstellen, der Visual Studio-Dateien enthält, die unter auf Clientcomputern innerhalb einer Organisation bereitgestellt werden können.

Die Erstellung eines Layouts ist in den folgenden Situationen nützlich:

• Ein Benutzer hat eingeschränkte Berechtigungen
• Die Client-Rechner haben nur begrenzten Zugang zum Internet
• Ein Unternehmen möchte eine bestimmte Version des Entwickler-Toolsets standardisieren

Wir haben Visual Studio so konzipiert, dass ein Administrator ein Layout erstellen und pflegen und es auf einer internen Netzwerkfreigabe speichern und optional im Intranet einer Organisation zur Verfügung stellen kann. Das Layout dient als Quellspeicherort für alle Visual Studio-Dateien, die sowohl für die Erstinstallation des Clients als auch für nachfolgende Updates benötigt werden.

Die Informationen auf dieser Seite sind in drei Hauptabschnitte unterteilt:

• Erstellen des Layouts: beschreibt, wie Sie das Layout mit dem richtigen Produktinhalt erstellen, die Standardeinstellungen konfigurieren, es auf einer Netzwerkfreigabe speichern und in Ihrem Intranet verfügbar machen.
• Verwalten des Netzwerklayouts: Hier finden Sie Informationen zur bestmöglichen Aktualisierung der Produktversion des Layouts oder der Änderung des Produktinhalts des Layouts, der Kanaleinstellungen, der Version des Installationsprogramms und der Ordnergröße.
• Hilfe und Support: Hier bekommen Sie Unterstützung.

Erstellen des Layouts

Vorbereiten des Speicherorts für die Netzwerkdateifreigabe

Zunächst müssen Sie bestimmen, wo Sie die heruntergeladenen Visual Studio-Pakete speichern möchten. Wenn Sie mehrere Editionen von Visual Studio in Ihrem Unternehmen nutzen (z. B. Visual Studio 2022 Professional und Visual Studio 2022 Enterprise), müssen Sie für jede Edition ein eigenes Layout erstellen. Die Erstellung eines separaten Layouts für jede Ausgabe kann sehr viel Speicherplatz beanspruchen, insbesondere wenn man bedenkt, dass auch Layout-Updates Speicherplatz verbrauchen.

Der Layoutpfad muss weniger als 80 Zeichen umfassen. Einige Organisationen haben erfolgreich symbolische Verknüpfungen verwendet, um die 80-Zeichen-Einschränkung zu umgehen.

Herunterladen des Visual Studio-Bootstrappers zum Erstellen des Layouts

Laden Sie den richtigen Bootstrapper für die gewünschte Visual Studio-Edition herunter, und kopieren Sie ihn in das Verzeichnis, das Sie als Repository des Layouts verwenden möchten. Nachdem das Layout erstellt wurde, können Sie es zum Installieren von Visual Studio auf beliebigen Clientcomputern verwenden. Der Bootstrapper ist die ausführbare Datei, die Sie zum Erstellen, Aktualisieren und Durchführen anderer Layoutvorgänge verwenden. Sie müssen über eine Internetverbindung und Administratorrechte verfügen, um diesen Schritt auszuführen.

Die unten aufgeführten Bootstrapper installieren immer die neueste, sicherste Version von Visual Studio 2022 im Kanal „Aktuell“, unabhängig davon, wann Sie sie ausführen. Wenn Sie ein Layout für eine bestimmte Version oder einen bestimmten Kanal von Visual Studio 2022 erstellen oder aktualisieren möchten, können Sie alternativ den Bootstrapper für die Evergreen- und Fixed-Version der Wartungsversion für den gewünschten Kanal von Visual Studio 2022 Release History herunterladen. Kopieren Sie es in das Verzeichnis, das Sie als Quellspeicherort des Layouts verwenden möchten.

Edition	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio Build Tools 2022	vs_buildtools.exe

Tipp

Wenn Sie zuvor eine Bootstrapper-Datei heruntergeladen haben und nun überprüfen möchten, welche Version heruntergeladen wird, erfahren Sie es hier. Öffnen Sie in Windows den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapperdatei, wählen Sie Eigenschaften und wählen Sie dann die Registerkarte Details aus. Das Feld Produktversion beschreibt den Kanal und die Version, die der Bootstrapper installiert. Die Versionsnummer sollte immer als „neueste Wartungsversion des angegebenen Werts“ interpretiert werden und für den Kanal wird „Aktuell“ angenommen, sofern er nicht explizit angegeben wird. Daher installiert ein Bootstrapper mit der Produktversion LTSC 17.0 die neueste 17.0.x-Wartungsversion, die im LTSC-Kanal 17.0 verfügbar ist. Ein Bootstrapper mit einer Produktversion, die als „Visual Studio 2022“ angegeben ist, installiert die neueste Wartungsversion von Visual Studio 2022 auf dem Kanal „Aktuell“.

Herunterladen der Visual Studio-Pakete

Für diesen Schritt benötigen Sie eine Internetverbindung.

Öffnen Sie eine Eingabeaufforderung mit erhöhten Rechten, navigieren Sie zu dem Verzeichnis, in das Sie den Bootstrapper heruntergeladen haben, und verwenden Sie die Parameter des Bootstrappers, wie auf der Seite Verwenden von Befehlszeilen Parametern zum Installieren von Visual Studio definiert, um das Netzwerklayout zu erstellen und zu verwalten. Die folgenden Beispiele veranschaulichen gängige Methoden zum Erstellen anfänglicher Layouts. Weitere Beispiele finden Sie auf der Seite mit den Beispielen für Befehlszeilenparameter für eine Visual Studio-Installation.

Ein vollständiges erstes Layout für ein Gebietsschema mit einer Sprache erfordert etwa 40 GB Datenträgerspeicher für Visual Studio Community und etwa 50 GB für Visual Studio Enterprise. Zusätzliche Sprachumgebungen benötigen jeweils etwa ein halbes GB.

Es wird empfohlen, ein anfängliches Layout von Visual Studio Enterprise mit allen Workloads und entsprechenden Sprachen zu erstellen und die Pakete im Layoutverzeichnis auf dem Netzwerkserver zu speichern. Auf diese Weise hat jede Clientinstallation Zugriff auf das gesamte Visual Studio-Produktangebot und die Möglichkeit, eine beliebige Teilmenge zu installieren. Um ein vollständiges Layout von Visual Studio zu erstellen, führen Sie in dem Verzeichnis, in dem Sie das Netzwerklayout hosten möchten, den folgenden Befehl aus:

vs_enterprise.exe --layout c:\VSLayout

Sicherstellen, dass Ihr Layout auf dem richtigen Kanal basiert

Es ist wichtig, sicherzustellen, dass das Netzwerklayout auf dem korrekten channel basiert, da dies eines der Kriterien ist, anhand derer administrator updates, wenn es im gesamten Unternehmen eingesetzt wird, ermittelt, welche Client-Instanzen aktualisiert werden sollten. Wenn Ihr Layout beispielsweise auf dem VisualStudio.17.Release.LTSC.17.0-Channel basiert und Ihre Clients so konfiguriert sind, dass sie Updates von den von Microsoft gehosteten Servern erhalten, stehen alle Sicherheitsupdates, die auf dem 17.0 LTSC-Channel verfügbar sind, den Clients zur Verfügung, die von diesem Layout aus installiert oder aktualisiert haben.

Die oben aufgeführten Bootstrapper basieren auf dem Kanal „Aktuell“. Um ein Layout basierend auf einem der LTSC-Kanäle zu erstellen, rufen Sie den Bootstrapper des richtigen Kanals von der Seite mit dem Visual Studio 2022-Releaseverlauf auf, kopieren ihn in Ihren Layoutordner und erstellen bzw. aktualisieren das Layout damit.

Konfigurieren der Inhalte eines Layouts

Es gibt mehrere Optionen zum Anpassen des Inhalts Ihres Netzwerklayouts. Sie können ein Teillayout erstellen, das nur eine bestimmte Gruppe von Gebietsschemas, Workloads und Komponenten mit ihren empfohlenen oder optionalen Abhängigkeiten enthält. Ein partielles Layout ist nützlich, wenn Sie wissen, dass Sie nur eine Teilmenge von Workloads auf Client-Workstations bereitstellen werden. Es folgen übliche Befehlszeilenparameter zum Anpassen des Layouts:

• --add zum Angeben von Workload- oder Komponenten-IDs.
  Wenn --add verwendet wird, werden nur die Workloads und Komponenten heruntergeladen, die mit --add angegeben sind. Wenn --add nicht verwendet wird, werden alle Workloads und Komponenten heruntergeladen.
• --includeRecommended zum Einschließen aller empfohlenen Komponenten für die angegebenen Workload-IDs.
• --includeOptional zum Einschließen aller optionalen Komponenten für die angegebenen Workload-IDs.
• --config eine *.vsconfig-Datei zu verwenden, um die Workloads, Komponenten oder Erweiterungen anzugeben, die im Layout enthalten sein oder auf die das Layout verweisen soll. Stellen Sie sicher, dass Sie den vollständigen Pfad der Konfigurationsdatei angeben.
• --lang zum Angeben von Gebietsschemas.

Es folgen einige Beispiele dazu, wie ein benutzerdefiniertes Netzwerklayout erstellt werden kann.

• Führen Sie zum Erstellen eines Layouts mit den erforderlichen Komponenten für alle Workloads für nur eine Sprache Folgendes aus:

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

• Führen Sie zum Erstellen eines Layouts mit den erforderlichen Komponenten für alle Workloads für mehrere Sprachen Folgendes aus:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Führen Sie zum Erstellen eines Layouts mit einer Workload und aller hierfür erforderlichen und empfohlenen Komponenten für alle Sprachen Folgendes aus:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• Führen Sie zum Erstellen eines Layouts mit zwei Workloads und einer optionalen Komponente für drei Sprachen Folgendes aus:

  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
  

Verwenden einer Konfigurationsdatei zum Initialisieren des Inhalts eines Layouts

Sie können den Parameter --config verwenden, um eine *.vsconfig Datei zu übergeben. Stellen Sie sicher, dass Sie den vollständigen Pfad der Konfigurationsdatei angeben. Durch die Verwendung einer *.vsconfig-Datei während der Layouterstellung wird der Inhalt eines Netzwerk-Layouts auf die in der Konfigurationsdatei angegebenen Daten beschränkt und angepasst. Die Konfigurationsdatei wird in das Layoutverzeichnis kopiert und in layout.vsconfig umbenannt.

Alle Erweiterungen, die in der Datei *.vsconfig angegeben sind, werden nicht direkt in das Layout kopiert. Stattdessen enthält die Datei response.json des Layouts einen Verweis auf die neu erstellte Datei layout.vsconfig, in der der Installationsort für die Erweiterungen des Clients definiert ist. Wenn Sie Erweiterungen installieren, die nicht digital signiert sind, stellen Sie sicher, dass Sie die response.json bearbeiten und "allowUnsignedExtensions": true hinzufügen. Siehe response.json Inhaltsbeispiele.

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

Kopieren des Layouts in eine Netzwerkfreigabe

Sie müssen das Layout auf einer Netzwerkfreigabe hosten, damit darauf von den Clientcomputern aus zugegriffen werden kann. Wenn Sie das Layout auf einem lokalen Computer erstellt haben, müssen Sie es an einen Dateispeicherort im Netzwerk kopieren. Im folgenden Beispiel wird xcopy verwendet. Sie können auch robocopy verwenden, wenn Sie möchten. Beispiel:

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

Konfigurieren der Standardeinstellungen für die Erstinstallation des Clients für dieses Layout

Eine Datei namens response.json wird im Stammordner des Layouts erstellt. Diese anpassbare Datei enthält die anfänglichen Standardeinstellungen, die auf dem Client zu konfigurieren sind, wenn der Client erstmals aus dem Layout installiert wird. Zu den üblichen Konfigurationsoptionen gehört die Möglichkeit der Konfiguration:

• Welche Workloads, Komponenten oder Sprachen sollen standardmäßig auf dem Client installiert werden?
• Wenn die empfohlenen Komponenten ebenfalls installiert werden sollen
• Wenn der Client eine Installationsdatei *.vsconfig beachten soll
• Woher soll der Kunde Aktualisierungen erhalten?
• Wenn nicht mehr unterstützte Komponenten bei einem Update entfernt werden sollen
• Wenn unsignierte Erweiterungen still & programmatisch geladen werden dürfen

Weitere Informationen finden Sie unter Programmgesteuertes Konfigurieren von Standardeinstellungen mithilfe einer Antwortdatei.

Bereitstellen des Zugriffs auf Ihr Layout über eine Intranetsite

Ab Juni 2023 können Sie Ihre Layouts auf einer internen Intranetsite verfügbar machen, sodass Sie die Leistungsfunktionen für die Zwischenspeicherung und Georeplikation von Webserverdateien nutzen können. Um dieses neue Feature verwenden zu können, müssen Sie die neuesten Visual Studio-Bootstrapper und den aktuellen Visual Studio-Installer verwenden. IT-Administratoren müssen Folgendes tun, um die Vorteile dieser Intranet-Webhosting-Funktion zu nutzen:

1. Erstellen und verwalten Sie zunächst ein Netzwerklayout, und stellen Sie sicher, dass die Bits auf der Netzwerkfreigabe vorhanden sind und regelmäßig aktualisiert werden. Denken Sie auch daran, den channelUri-Wert in der Datei „response.json“ des Layouts zu konfigurieren, wenn die Clients ihre Updates aus dem Layoutspeicherort im Intranet abrufen sollen.

2. Als Nächstes muss ein*e Administrator*in eine interne Website vorbereiten und die Quelle der Website an den Dateispeicherort im Netzwerk des Layouts binden. Sie müssen auch sicherstellen, dass der Webserver die folgenden MIME-Typen respektiert:

   Dateierweiterung	MIME-Typ
   .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. Um dieses Layout auf dem Client bereitzustellen, führen Sie schließlich ein PowerShell-Skript auf dem Client aus, um die Erstinstallation durchzuführen. Nach der erfolgreichen Installation von Visual Studio auf dem Client eines im Web gehosteten Layouts können die Client-Updates für im Web gehostete Layouts über die Standardmethoden aktualisiert werden.

Sicherstellen, dass Ihr Layout das neueste Installationsprogramm verwendet

Hinweis

Ab Juni 2023 wird das neueste Installationsprogramm standardmäßig mit jedem Update für alle unterstützten Versionen von Visual Studio 2017, Visual Studio 2019 und Visual Studio 2022 bereitgestellt. Wenn Sie also eine dieser Produktversionen nutzen, müssen Sie keine expliziten Maßnahmen ergreifen, um die aktuelle Version des Installationsprogramms mit den neuesten Funktionen und Fehlerbehebungen zu erhalten.

Wenn Sie eine Version von Visual Studio verwenden, die vor Juni 2023 ausgeliefert wurde, empfehlen wir Ihnen, immer den neuesten Visual Studio Installer in Ihrem Layout zu verwenden und ihn an Ihre Kunden weiterzugeben. Wenn Sie z. B. das Visual Studio 2022-Installationsprogramm über Ihre Visual Studio 2019-Layouts verteilen, können Ihre Visual Studio 2019-Clients, die auf diesem Layout basieren, den Quellspeicherort für Updates ändern oder Komponenten, die nicht mehr unterstützt werden, einfach entfernen. Weitere Einzelheiten sind unter im folgenden Abschnitt beschrieben.

Die Möglichkeit, programmatisch sicherzustellen, dass Sie das neueste Installationsprogramm verwenden, ist nur für Visual Studio 2019-Bootstrapper verfügbar, die nach der ursprünglichen Veröffentlichung von Visual Studio 2022 erstellt wurden. Die vs_enterprise.exe im folgenden Beispiel muss also eine Version sein, die nach dem 10. November 2021 bereitgestellt wurde.

Führen Sie zum Erstellen eines Layouts des vollständigen Produkts, das das neueste und umfangreichste Installationsprogramm verwendet, Folgendes aus:

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

Verwalten Ihres Layouts

Es empfiehlt sich, Ihr Visual Studio-Layout regelmäßig auf die neueste sichere Version des Produkts zu aktualisieren. Dadurch wird sichergestellt, dass das Layout sowohl als Installationspunkt als auch als Aktualisierungsquelle für Client-Installationen verwendet werden kann. Im folgenden Abschnitt werden die gängigsten und nützlichsten Layoutwartungsvorgänge beschrieben.

Wenn Sie ein Layout auf einer Netzwerkdateifreigabe hosten, sollten Sie ein aktualisiertes Layout auf eine private lokale Freigabe (z. B. C:\VSLayoutUpdate) herunterladen und diese, nachdem alle aktualisierten Inhalte heruntergeladen wurden, auf Ihre Netzwerkdateifreigabe für das Layout kopieren (z. B. \server\products\VS). Wenn Sie dies nicht tun, können Benutzer*innen, die das Setup ausführen, während Sie das Layout aktualisieren, möglicherweise nicht alle Inhalte aus dem Layout erhalten, da es noch nicht vollständig aktualisiert wurde.

Aktualisieren des Layouts auf die aktuellste Version des Produkts

Microsoft veröffentlicht häufig aktualisierte Versionen des Produkts, um Funktionsprobleme zu beseitigen und die Sicherheit zu verbessern. Es wird dringend empfohlen, Ihr Layout mit der neuesten Version des Produkts auf dem aktuellen Stand zu halten, damit Ihre Clients stets Zugriff auf die neueste sicherste Version des Produkts haben. Dies ist insbesondere wichtig, wenn Ihre Clients keinen Internetzugang haben und nur Produktupdates von dem Layout erhalten können. Visual Studio veröffentlicht Sicherheitsupdates in der Regel am zweiten Dienstag im Monat, am sogenannten „Patch Tuesday“. Eine gute Strategie wäre daher also, alle Ihre Layouts am Nachmittag des Patch Tuesday zu aktualisieren.

Wenn Sie das anfängliche Layout erstellen, werden die angegebenen Optionen, z. B. welche Workloads und Sprachen aufgenommen werden sollen, in der Konfigurationsdatei des Layouts (layout.json) gespeichert. Wenn Sie dieses Layout später auf eine neuere Version des Produkts aktualisieren, müssen Sie die im Layout gewünschten Produktkomponenten nicht erneut angeben. Ein Layoutupdate aktualisiert einfach die vorhandenen Komponenten im Layout auf die aktuelle Version.

Angenommen, Sie haben dieses Teillayout bereits mit einem der „Evergreen“-Bootstrapper in der obigen Tabelle erstellt.

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

Das Aktualisieren dieses Layouts auf die neueste Version des Produkts, die von Microsoft bereitgestellt und auf Microsoft-Servern gehostet wird, ist ganz einfach. Sie müssen nur den vorhandenen Evergreen-Bootstrapper im Layout verwenden und wie folgt den Befehl --layout an einer Eingabeaufforderung mit erhöhten Rechten ausführen, um die neuesten Pakete in Ihr Layout herunterzuladen:

vs_enterprise.exe --layout c:\VSLayout

Sie können Ihr Layout auch unbeaufsichtigt auf eine aktualisierte Version aktualisieren. Der Layoutvorgang führt den Setupprozess in einem neuen Konsolenfenster aus. Das Fenster bleibt geöffnet, sodass sich die Administrator*innen das endgültige Ergebnis des Layoutupdates und ggf. eine Zusammenfassung der aufgetretenen Fehler ansehen können. Wenn Sie einen Layoutvorgang unbeaufsichtigt durchführen möchten (wenn Sie z.B. über ein Skript verfügen, das regelmäßig ausgeführt wird, um ihr Layout auf die aktuelle Version zu aktualisieren), verwenden Sie den Parameter --passive, und der Vorgang schließt das Fenster automatisch.

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

Aktualisieren des Layouts auf eine bestimmte Version des Produkts

Es gibt Fälle, in denen Sie Layout auf eine bestimmte Version des Produkts aktualisieren möchten. Ein Beispiel: Ihr Layout soll der neuesten sicheren Version der Wartungsbaseline entsprechen, die Sie für Ihre Organisation als Standard festgelegt haben. Dazu gehen Sie wie folgt vor:

Sie können zur Seite mit dem Releaseverlauf von Visual Studio 2022 wechseln und einen bestimmten Bootstrapper mit fester Version herunterladen, ihn in Ihr Layout kopieren und verwenden, um das Layout auf die im Bootstrapper angegebene Version zu aktualisieren. Dazu verwenden Sie genau dieselbe Syntax wie oben.

Sie können ein Administratorupdate verwenden, um Ihr Layout auf eine bestimmte Version des Produkts zu aktualisieren. Um das Administratorupdate abzurufen, wechseln Sie zum Microsoft Update-Katalog, und suchen Sie nach dem Update, auf das Sie Ihr Layout aktualisieren möchten. Laden Sie die Datei update.exe auf den Computer herunter, auf dem das Layout gehostet wird, öffnen Sie auf diesem Computer eine Eingabeaufforderung mit erhöhten Rechten, und führen Sie einen Befehl wie den folgenden aus:

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

Beachten Sie, dass ein Administratorupdate nicht die Erstellung eines neuen Layouts initiiert. Es aktualisiert nur ein vorhandenes Layout. Sie müssen einen Bootstrapper verwenden, um das anfängliche Layout zu erstellen.

Sicherstellen, dass Ihr Netzwerklayout auf einer unterstützten Version basiert

Gelegentlich müssen Sie bei der Einführung von Kanälen aus dem Support sicherstellen, dass das Netzwerklayout weiterhin auf einem unterstützten Kanal basiert, damit Ihre Clients weiterhin Benachrichtigungen über Sicherheitsupdates erhalten können. Wenn Ihr Layout auf dem Kanal „VisualStudio.17.Release.LTSC.17.0“ basiert, veröffentlichen wir keine weiteren Sicherheitsupdates für den Kanal mehr, sobald der Support für den 17.0 LTSC-Kanal im Juli 2023 eingestellt wird. Ihre Layouts und Clients sind dann nicht mehr sicher. Das Ablaufdatum des Supports für verschiedene Visual Studio 2022-Kanäle finden Sie hier.

Um den Kanal zu ändern, auf dem das Layout basiert, rufen Sie den Bootstrapper des gewünschten Kanals von der Seite mit dem Visual Studio 2022-Releaseverlauf ab, kopieren ihn in Ihren Layoutordner und führen ein normales Update durch. Auf diese Weise sollten Ihre Clients dann entsprechend über ein Update benachrichtigt werden und weiterhin sicher sein.

Überprüfen der Inhalte eines Layouts

Es ist möglich, ein Teillayout zu ändern und ihm zusätzliche Workloads, Komponenten oder Sprachen hinzuzufügen. Es ist nicht möglich, Komponenten zuverlässig aus einem Layout zu entfernen.

Im folgenden Beispiel fügen wir die Azure-Workload und eine lokalisierte Sprache zu dem Layout hinzu, das zuvor nur mit der Managed Desktop-Workload und der Sprache „Englisch“ erstellt wurde. Nach der Änderung sind die Managed Desktop- und Azure-Workloads sowie die englischen und deutschen Ressourcen in diesem Layout enthalten. Zusätzlich zum Hinzufügen von Komponenten führt der Befehl --layout auch dazu, dass das Layout auf die vom Bootstrapper angegebene Version aktualisiert wird. Wenn Sie also den Evergreen-Bootstrapper verwenden, enthält das resultierende Layout die neue Komponente, die neue Sprache, und alle Layoutinhalte werden auf die neueste Version im Kanal des Bootstrappers aktualisiert.

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

Wenn Sie aus einem vorhandenen Teillayout ein vollständiges Layout machen möchten, verwenden Sie die Option „--all“, wie im folgenden Beispiel erläutert. Auch dieser Befehl bewirkt, dass der Layoutinhalt auf die vom Bootstrapper angegebene Version aktualisiert wird.

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

Sie können Komponenten zu einem Layout hinzufügen, indem Sie eine *.vsconfig-Datei übergeben, die die zusätzlichen Komponenten enthält, die Sie in Ihrem Layout haben möchten. Wenn Sie dies tun, überschreibt der neue Inhalt von *.vsconfig den bestehenden Inhalt von layout.vsconfig. Weitere Informationen finden Sie im vorhergehenden Abschnitt Verwendung einer Konfigurationsdatei zur Initialisierung des Inhalts eines Layouts.

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

Schließlich können Sie die Konfigurationsdatei layout.json direkt im Layoutordner bearbeiten und den Abschnitt „add“ dieser Datei aktualisieren, um die zusätzlichen Komponenten einzuschließen, die Sie in Ihr Layout aufnehmen möchten. Anschließend müssen Sie das Layout mit --layout wie zuvor beschrieben aktualisieren, um die neuesten Komponenten herunterzuladen.

Hinweis

Die einfachste Möglichkeit, die neu hinzugefügten Layoutkomponenten auf einem Clientcomputer zu installieren, besteht darin, den Bootstrapper im Layout auf dem Clientcomputer auszuführen. Im Abschnitt „add“ der Datei response.json im Layout wird festgelegt, welche Komponenten standardmäßig auf der Installationsoberfläche des Clients ausgewählt sind. Wenn Sie das Layout mit einer der oben genannten Methoden geändert haben, sollten Sie den Abschnitt „add“ in der Datei response.json manuell überprüfen und möglicherweise anpassen, sodass er besser mit dem Inhalt im Abschnitt „add“ der neu geänderten Datei layout.json übereinstimmt.

Konfigurieren Sie das Layout, um Komponenten auf dem Clientcomputer zu entfernen, deren Supportende erreicht wurde.

Einige Unternehmen möchten das in Visual Studio 2022, Version 17.4, eingeführte Feature nutzen, das Komponenten entfernt, die in einen Zustand nach dem Supportende übergegangen sind. Dies ist relativ einfach einzurichten, wenn Sie ein Layout verwalten und wenn Ihre Clients Administratorupdates erhalten. Zunächst müssen Sie Ihr Layout so konfigurieren, dass die neueste Version des Installationsprogramms verwendet wird, wie unten beschrieben. Als Nächstes müssen Sie der Datei "removeOos": true die Zeile response.json hinzufügen. Wenn für Ihr Layout diese beiden Details ordnungsgemäß festgelegt sind, berücksichtigen nachfolgende Administratorupdates diese Einstellung und entfernen die Komponenten von den Clientcomputern, deren Supportende erreicht ist.

Überprüfen eines Layouts

Mit --verify können Sie das Netzwerklayout überprüfen und ermitteln, ob Paketdateien fehlen oder ungültig sind. Am Ende der Überprüfung wird eine Liste der fehlenden und ungültigen Dateien ausgegeben.

Die Überprüfung funktioniert nur mit der neuesten Version einer bestimmten Nebenversion von Visual Studio. Sobald eine neue Version veröffentlicht wird, funktioniert die Überprüfung nicht mehr für Layouts mit früheren Releases.

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

Hinweis

Einige wichtige Metadatendateien, die für die Option --verify erforderlich sind, müssen im Layoutordner vorhanden sein. Wenn diese Metadatendateien fehlen, kann „--verify“ nicht ausgeführt werden, und das Setup gibt einen Fehler aus. Wenn dieser Fehler auftritt, versuchen Sie erneut, das Layout zu aktualisieren oder ein neues Netzwerklayout in einem anderen Ordner zu erstellen.

Denken Sie daran, dass Microsoft regelmäßig Updates für Visual Studio bereitstellt. Wenn Sie also einen Evergreen-Bootstrapper verwenden, enthält ein neueres Layout möglicherweise nicht die gleiche Version wie das ursprüngliche Layout. Wenn Sie jedoch einen Bootstrapper mit festen Links verwenden, erhalten Sie (fast) immer eine deterministische Dateigruppe.

Korrigieren eines Layouts

Verwenden Sie --fix, um die gleiche Überprüfung wie mit --verify durchzuführen, und versuchen Sie außerdem, die identifizierten Probleme zu beheben. Der --fix-Prozess benötigt eine Internetverbindung, also stellen Sie sicher, dass Ihr Computer mit dem Internet verbunden ist, bevor Sie --fix aufrufen.

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

Entfernen älterer Versionen aus einem Layout

Nach dem Ausführen von Layoutupdates für einen Netzwerkcache enthält der Layoutordner möglicherweise einige veraltete Pakete, die für die neueste Visual Studio-Installation nicht mehr benötigt werden. Mit der Option --clean lassen sich veraltete Pakete aus dem Netzwerklayoutordner entfernen.

Dazu benötigen Sie die Dateipfade zu den Katalogmanifesten, die diese veralteten Pakete enthalten. Die Katalogmanifeste finden Sie in einem Archivordner des Netzwerklayoutcaches. Sie werden gespeichert, wenn Sie ein Layout aktualisieren. Im Ordner „Archiv“ befindet sich mindestens ein Ordner namens „GUID“, der jeweils ein veraltetes Katalogmanifest enthält. Die Anzahl der GUID-Ordner sollte der Anzahl der Updates entsprechen, die für Ihre Layouts ausgeführt wurden.

Einige Dateien werden in jedem GUID-Ordner gespeichert. Die beiden interessantesten Dateien sind „catalog.json“ und „version.txt“. Die Datei „catalog.json“ ist das veraltete Katalogmanifest, das Sie an die Option --clean übergeben müssen. Die andere Datei, „version.txt“, enthält die Version des veralteten Katalogmanifests. Auf Grundlage der Versionsnummer können Sie entscheiden, ob veraltete Pakete aus diesem Katalogmanifest entfernt werden sollen. Sie können diesen Vorgang beim Durchgehen der anderen GUID-Ordner wiederholen. Nachdem Sie entschieden haben, welche Kataloge Sie bereinigen möchten, führen Sie den Befehl --clean aus, indem Sie die Dateipfade für diese Kataloge angeben.

Hier sehen Sie ein Beispiel für die Verwendung der 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

Wenn Sie diesen Befehl ausführen, analysiert das Setup Ihren Netzwerklayoutordner und sucht die Dateien, die ggf. entfernt werden. Sie haben dann die Gelegenheit, die Dateien, die gelöscht werden sollen, zu überprüfen und den Löschvorgang zu bestätigen.

Konfigurieren Sie das Layout so, dass immer das neueste Installationsprogramm eingefügt und bereitstellt wird.

Hinweis

Ab Juni 2023 wird das neueste Installationsprogramm standardmäßig mit jedem Update für unterstützte Versionen von Visual Studio 2017, Visual Studio 2019 und Visual Studio 2022 bereitgestellt. Daher müssen Sie keine expliziten Maßnahmen in Ihrem Layout und für Ihre Clients ergreifen, um die neueste Version des Installationsprogramms mit den neuesten Funktionen und Fehlerbehebungen zu erhalten.

Wenn Sie jedoch ein Layout verwenden, das vor Juni 2023 erstellt wurde, können Sie Ihr Layout auch explizit so konfigurieren, dass immer das neueste Installationsprogramm für Ihre Clients eingeschlossen und bereitgestellt wird, auch wenn das Installationsprogramm als Teil einer neueren Version von Visual Studio betrachtet wird. Wenn Ihr Client von diesem Layout aus aktualisiert wird, erhält er daher das neueste Installationsprogramm, das in diesem Layout eingeschlossen und bereitgestellt wird. Der Vorteil ist, dass sobald das neueste Installationsprogramm für Ihren Client aktiviert ist, Ihre Clientinstallationen von den Fehlerbehebungen und neuen Funktionen profitieren können, die dem Installationsprogramm weiterhin hinzugefügt werden.

Es gibt mehrere Möglichkeiten, wie Sie das neueste Installationsprogramm in Ihr Layout aufnehmen und bereitstellen:

• Sie können eine Version von Visual Studio verwenden, die im oder nach Juni 2023 erstellt wurde.

• Sie können den --useLatestInstaller-Parameter an den Bootstrapper übergeben, wenn Sie das Layout erstellen oder aktualisieren. Dadurch wird eine Einstellung in der Datei layout.json festgelegt, die sich im Stammverzeichnis des Layouts befindet. Im Folgenden finden Sie ein Beispiel für das Aktualisieren und Konfigurieren des Layouts für die Verwendung des neuesten und umfangreichsten Installationsprogramms.

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

• Sie können die Datei layout.json direkt bearbeiten, um diese Einstellung hinzuzufügen.

  {
     "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
  
  }
  

Es gibt keine Möglichkeit, diese Einstellung programmgesteuert aus der Datei layout.json zu entfernen. Wenn Sie also möchten, dass in Ihrem Layout nicht mehr das neueste Installationsprogramm verwendet werden soll, das Microsoft zur Verfügung stellt, sondern die Version, die dem Bootstrapper entspricht (und meist älter ist), entfernen Sie die Einstellung layout.json aus der Datei "UseLatestInstaller": true.

Beachten Sie, dass diese Einstellung "UseLatestInstaller": true möglicherweise auch in der Datei response.json des Layouts enthalten ist, dort aber ignoriert wird, um sicherzustellen, dass das Layout immer über den neuesten Installer verfügt. Die „response.json“-Datei wird verwendet, um Standardkonfigurationsoptionen auf dem Client festzulegen, wenn der Client über ein Layout installiert oder aktualisiert wird. Diese spezielle "useLatestInstaller": true-Einstellung in der Datei layout.json wird verwendet, um sicherzustellen, dass der Inhalt des Layouts das neueste Installationsprogramm enthält, sodass die Clientcomputer dann das neueste Installationsprogramm aus dem Layout abrufen können.

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 Ihr Netzwerklayout

Lassen Sie es uns wissen, wenn ein Problem mit Ihrem Netzwerklayout auftritt. 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 verwenden, wäre es sehr hilfreich, wenn Sie die Protokolle über das Tool Visual Studio Collect senden könnten, was uns bei der Diagnose und Behebung des Problems helfen kann.

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

• Administratorhandbuch für Visual Studio 2017 RC
• Bereitstellen von Visual Studio über ein Layout auf einem Clientcomputer
• Aktualisieren einer netzwerkbasierten Installation von Visual Studio
• Beheben von Netzwerkfehlern beim Installieren oder Verwenden von Visual Studio
• Konfigurieren von Richtlinien für Unternehmensbereitstellungen von Visual Studio
• Projektlebenszyklus und Wartung in Visual Studio
• Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio
• Arbeitsauslastung und Komponenten-IDs von Visual Studio
• Installieren der für eine Offlineinstallation von Visual Studio erforderlichen Zertifikate