Erstellen und Verwalten einer Netzwerkinstallation von Visual Studio

📣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!

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

Das Erstellen eines Layouts ist in folgenden Situationen hilfreich:

• Ein Benutzer verfügt über eingeschränkte Berechtigungen
• Die Clientcomputer haben eingeschränkten Zugriff auf das Internet.
• Eine Organisation möchte eine bestimmte Version des Entwicklertoolsets standardisieren.

Wir haben Visual Studio so entworfen, dass ein Administrator sowohl ein Layout erstellen als auch verwalten und in einer internen Netzwerkfreigabe speichern und optional im Intranet einer Organisation verfügbar machen kann. Das Layout dient als Quellspeicherort für alle Visual Studio-Dateien, die sowohl für die anfängliche Clientinstallation als auch für nachfolgende Updates erforderlich sind.

Die Informationen auf dieser Seite sind in drei Hauptabschnitte unterteilt:

• Erstellen des Layouts: Beschreibt, wie Sie das Layout mit den richtigen Produktinhalten erstellen, die Standardeinstellungen konfigurieren, sie in einer Netzwerkdateifreigabe speichern und in Ihrem Intranet verfügbar machen.
• Verwalten des Layouts: Informationen zum optimalen Aktualisieren der Produktversion des Layouts oder Ändern der Produktinhalte, Kanaleinstellungen, Installationsversion und Ordnergröße des Layouts.
• Hilfe und Support: Wo man nach Hilfe fragen kann

Erstellen des Layouts

Vorbereiten des Speicherorts für die Netzwerkdateifreigabe

Zunächst müssen Sie ermitteln, wo die heruntergeladenen Visual Studio-Pakete gespeichert werden sollen. Wenn Sie mehrere Editionen von Visual Studio in Ihrem Unternehmen verwenden (z. B. Visual Studio 2022 Professional und Visual Studio 2022 Enterprise), müssen Sie für jede Edition ein separates Layout erstellen. Das Erstellen eines separaten Layouts für jede Edition kann viel Speicherplatz beanspruchen, insbesondere, wenn Sie berücksichtigen, dass Layoutupdates auch Speicherplatz verbrauchen.

Der Layoutpfad muss weniger als 80 Zeichen lang sein. einige Organisationen verwenden erfolgreich symbolische Verknüpfungen, um die Einschränkung von 80 Zeichen zu umgehen.

Laden Sie den Visual Studio-Bootstrapper herunter, um das Layout zu erstellen.

Laden Sie den richtigen Bootstrapper für die gewünschte Version von Visual Studio 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 verwenden, um Visual Studio auf einem beliebigen Clientcomputer zu installieren. Der Bootstrapper ist die ausführbare Datei, die Sie zum Erstellen, Aktualisieren und Ausführen anderer Layoutvorgänge verwenden. Sie müssen über eine Internetverbindung und Administratorberechtigungen verfügen, um diesen Schritt abzuschließen.

Die folgenden Bootstrapper installieren immer die neueste sicherste Version von Visual Studio 2022 im aktuellen Kanal, 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, laden Sie die unveränderbare Version des Evergreen-Bootstrappers für die Wartungsversion für den gewünschten Kanal unter Versionsverlauf von Visual Studio 2022 herunter. 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 überprüfen möchten, welche Version installiert wird, gehen Sie wie folgt vor. Öffnen Sie in Windows den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapperdatei, wählen Sie Eigenschaften aus, 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" gelesen werden. Der Kanal wird als aktueller Kanal angenommen, sofern nicht explizit etwas anderes angegeben ist. Ein Bootstrapper mit einer Produktversion von LTSC 17.0 installiert also die neueste 17.0.x-Wartungsversion, die im 17.0 LTSC-Kanal 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

Sie müssen über eine Internetverbindung verfügen, um diesen Schritt abzuschließen.

Ö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 sie auf der Seite "Verwenden von Befehlszeilenparametern zur Installation von Visual Studio" definiert sind, um Ihr Netzwerklayout zu erstellen und zu verwalten. Die folgenden Beispiele veranschaulichen allgemeine Möglichkeiten zum Erstellen von anfänglichen Layouts. Weitere Beispiele finden Sie auf der Seite mit Befehlszeilenparameterbeispielen für eine Visual Studio-Installation.

Ein vollständiges Anfängliches Layout für ein gebietsschema mit einer Sprache erfordert ca. 40 GB Speicherplatz für Visual Studio Community und ca. 50 GB für Visual Studio Enterprise. Zusätzliche Gebietsschemas erfordern jeweils etwa ein halbes GB.

Der empfohlene Ansatz besteht darin, ein anfängliches Layout von Visual Studio mit allen Workloads und geeigneten 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 Teilmenge zu installieren. Führen Sie zum Erstellen eines vollständigen Layouts von Visual Studio den folgenden Befehl aus dem Verzeichnis aus, auf dem Sie das Netzwerklayout hosten möchten:

vs_enterprise.exe --layout c:\VSLayout

Sicherstellen, dass Ihr Layout auf dem richtigen Kanal basiert

Es ist wichtig, dass das Netzwerklayout auf dem richtigen Kanal basiert, da dies eines der Kriterien ist, mit deren Hilfe bei Administratorupdates ermittelt wird, welche Clientinstanzen aktualisiert werden sollen. Dies gilt für Updates, die in der gesamten Organisation bereitgestellt werden. Wenn Ihr Layout beispielsweise auf dem Kanal "VisualStudio.17.Release.LTSC.17.0" basiert und Ihre Clients für den Empfang von Updates von von Microsoft gehosteten Servern konfiguriert sind, stehen alle Sicherheitsupdates, die auf dem 17.0 LTSC-Kanal zur Verfügung gestellt werden, den Clients zur Verfügung, die über dieses Layout installiert oder aktualisiert wurden.

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 aus dem Visual Studio 2022-Versionsverlauf Seite ab, kopieren Sie es in Ihren Layoutordner, und verwenden Sie ihn, um das Layout zu erstellen oder zu aktualisieren.

Konfigurieren des Inhalts eines Layouts

Es gibt mehrere Optionen, mit denen Sie den Inhalt Ihres Netzwerklayouts anpassen können. 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 Arbeitslasten auf Clientarbeitsstationen bereitstellen werden. Typische Befehlszeilenparameter zum Anpassen des Layouts sind:

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

Hier sind einige Beispiele zum Erstellen eines benutzerdefinierten Netzwerklayouts.

• Führen Sie Folgendes aus, um ein Layout mit erforderlichen Komponenten für alle Workloads in nur einer Sprache zu erstellen:

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

• Führen Sie Folgendes aus, um ein Layout mit erforderlichen Komponenten für alle Workloads in mehreren Sprachen zu erstellen:

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

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

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

• Führen Sie Folgendes aus, um ein Layout mit zwei Workloads und einer optionalen Komponente in drei Sprachen zu erstellen:

  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 Dateizu übergeben. Geben Sie den vollständigen Pfad der Konfigurationsdatei an. Die Verwendung einer *.vsconfig Datei während der Layouterstellung passt an und schränkt den Inhalt eines Netzwerklayouts auf die in der Konfigurationsdatei angegebenen Inhalte ein. Die Konfigurationsdatei wird in das Layoutverzeichnis kopiert und in layout.vsconfigumbenannt.

Alle in der *.vsconfig Datei angegebenen Erweiterungen werden nicht direkt in das Layout kopiert. Stattdessen enthält die response.json-Datei des Layouts einen Verweis auf die neu erstellte layout.vsconfig Datei, wobei der Installationsspeicherort für die Erweiterungen des Clients definiert wird. Wenn Sie Erweiterungen installieren, die nicht digital signiert sind, müssen Sie die response.json bearbeiten, um "allowUnsignedExtensions": truehinzuzufü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 Netzwerkdateispeicherort kopieren. Im folgenden Beispiel wird xcopyverwendet. Sie können auch robocopyverwenden, wenn Sie möchten. Beispiel:

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

Konfigurieren Sie die Standardeinstellungen für die anfängliche Installation des Clients in diesem Layout.

Eine Datei namens response.json wird im Stammordner des Layouts erstellt. Diese anpassbare Datei stellt die anfänglichen Standardeinstellungen bereit, die auf dem Client konfiguriert werden sollen, wenn der Client zunächst aus dem Layout installiert wird. Allgemeine Konfigurationsoptionen umfassen die Möglichkeit zum Konfigurieren:

• Welche Workloads, Komponenten oder Sprachen standardmäßig auf dem Client installiert werden sollen
• Wenn empfohlene Komponenten ebenfalls installiert werden sollten
• Wenn der Client eine Installation *.vsconfig Datei respektieren sollte
• Wo sollte der Client Updates erhalten
• Wenn Nicht-Support-Komponenten während eines Updates entfernt werden sollen
• Wenn nicht signierte Erweiterungen unbeaufsichtigt und programmgesteuert geladen werden dürfen

Weitere Informationen finden Sie auf der Seite Automatisieren der Visual Studio-Installation mit einer Antwortdatei.

Erstellung eines zugänglichen Layouts auf einer Intranet-Website

Ab Juni 2023 können Sie Ihre Layouts auf einer Intranet-Website zur Verfügung stellen, mit der Sie die Möglichkeiten des Webserver-Cachings und der Georeplikationsleistung nutzen können. Um dieses neue Feature zu verwenden, müssen Sie die neuesten Visual Studio-Bootstrapper und das neueste Visual Studio-Installationsprogramm verwenden. IT-Administratoren müssen folgendes tun, um diese Intranetwebhostingfunktion nutzen zu können:

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 im response.json- des Layouts zu konfigurieren, wenn Ihre Clients ihre Aktualisierungen vom Intranet-Layout-Standort abrufen sollen.

2. Als Nächstes muss ein Administrator eine interne Website vorbereiten und die Quelle der Website an den Netzwerkdateispeicherort des Layouts binden. Außerdem müssen sie sicherstellen, dass der Webserver die folgenden MIME-Typen berücksichtigt:

   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 Ausführen eines PowerShell-Skripts auf dem Client zur Durchführung einer Erstinstallation. Nachdem Visual Studio erfolgreich über ein webgehostetes Layout auf dem Client installiert wurde, können Clientupdates für webgehostete Layouts über Standardmethodenaktualisiert werden.

Sicherstellen, dass Ihr Layout das neueste Installationsprogramm verwendet

Anmerkung

Ab Juni 2023 wird das neueste Installationsprogramm standardmäßig mit allen unterstützten Versionen von Visual Studio 2017, Visual Studio 2019 und Visual Studio 2022 ausgeliefert. Wenn Sie also eine dieser Produktversionen verwenden, müssen Sie nichts explizit tun, um die neueste Version des Installers mit den neuesten Funktionen und Fehlerbehebungen zu erhalten.

Wenn Sie eine Version von Visual Studio verwenden, die vor Juni 2023 ausgeliefert wurde, empfehlen wir, immer das neueste Visual Studio-Installationsprogramm in Ihrem Layout zu verwenden und an Ihre Clients zu verteilen. Wenn Sie z. B. das Visual Studio 2022-Installationsprogramm in Ihrem Visual Studio 2019-Layout verteilen, haben Ihre visual Studio 2019-Clients, die auf diesem Layout basieren, die Möglichkeit, den Quellspeicherort für Updates zu ändern oder Komponenten außerhalb des Supports auf einfache Weise zu entfernen. Weitere Details werden im folgenden Abschnitt beschrieben.

Die Fähigkeit, um programmgesteuert sicherzustellen, dass Sie das neueste Installationsprogramm verwenden, ist nur für Visual Studio 2019-Bootstrapper verfügbar, die erstellt wurden, nachdem Visual Studio 2022 ursprünglich ausgeliefert wurde. Daher muss die vs_enterprise.exe im folgenden Beispiel eine Version sein, die nach dem 10. November 2021 ausgeliefert 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 des 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 Updatequelle für Clientinstallationen verwendet werden kann. Im folgenden Abschnitt werden die am häufigsten verwendeten oder nützlichsten Layoutwartungsvorgänge beschrieben.

Wenn Sie ein Layout in einer Netzwerkdateifreigabe hosten, möchten Sie möglicherweise ein aktualisiertes Layout auf eine private lokale Freigabe herunterladen (z. B. c:\VSLayoutUpdate) und dann, nachdem alle aktualisierten Inhalte heruntergeladen wurden, auf Ihre Layout-Netzwerkdateifreigabe kopieren (z. B. \server\products\VS). Wenn Sie dies nicht tun, können Benutzer, die das Setup ausführen, während Sie das Layout aktualisieren, möglicherweise eine Diskrepanz bei den Inhalten des Layouts erleben, da es noch nicht vollständig aktualisiert wurde.

Aktualisieren des Layouts auf die neueste Version des Produkts

Microsoft veröffentlicht häufig aktualisierte Versionen des Produkts, um Funktionen oder Sicherheitsprobleme zu beheben. Es wird dringend empfohlen, das Layout mit der neuesten Version des Produkts auf dem neuesten Stand zu halten, damit Ihre Kunden immer Zugriff auf die neueste sicherste Version des Produkts haben. Dies ist insbesondere wichtig, wenn Ihre Clients keinen Internetzugang haben und nur Produktupdates vom Layout erhalten können. Visual Studio veröffentlicht in der Regel Sicherheitsupdates am zweiten Dienstag des Monats, der als "Patch-Dienstag" bezeichnet wird. Daher wäre eine gute Strategie, alle Ihre Layouts am Patch-Dienstagnachmittag zu aktualisieren.

Wenn Sie das anfängliche Layout erstellen, werden die angegebenen Optionen, z. B. welche Workloads und Sprachen in das Layout einbezogen werden sollen, in der Konfigurationsdatei des Layouts layout.jsongespeichert. Wenn Sie das Layout später auf eine neuere Version des Produkts aktualisieren, müssen Sie nicht erneut angeben, welche Komponenten des Produkts im Layout verwendet werden sollen. Ein Layoutupdate aktualisiert einfach die vorhandenen Komponenten im Layout auf ihre neueste 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, das von Microsoft angeboten wird und auf Microsoft-Servern gehostet wird, ist 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 auf eine aktualisierte Version auf unbeaufsichtigte Weise aktualisieren. Der Layoutvorgang führt den Setupvorgang in einem neuen Konsolenfenster aus. Das Fenster bleibt geöffnet, sodass Administratoren das endgültige Layoutupdateergebnis und eine Zusammenfassung aller möglicherweise aufgetretenen Fehler sehen können. Wenn Sie einen Layoutaktualisierungsvorgang auf unbeaufsichtigte Weise ausführen möchten (z. B. ein Skript, das regelmäßig ausgeführt wird, um Ihr Layout auf die neueste Version zu aktualisieren), verwenden Sie den parameter --passive, und der Prozess schließt das Fenster automatisch.

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

Aktualisieren des Layouts auf eine bestimmte Version des Produkts

Manchmal möchten Sie Ihr Layout möglicherweise auf eine bestimmte Version des Produktsaktualisieren. Sie können beispielsweise festlegen, dass Ihr Layout mit der neuesten sicheren Version der Wartungsbasis übereinstimmt, auf die Sie Ihre Organisation standardisiert haben. Gehen Sie dazu wie folgt vor:

Sie können zur Seite mit dem Versionsverlauf von Visual Studio 2022 wechseln und die unveränderbare Version eines bestimmten Bootstrappers herunterladen, ihn in Ihr Layout kopieren und verwenden, um das Layout auf die im Bootstrapper angegebene Version zu aktualisieren. Sie würden die gleiche Syntax wie oben verwenden.

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

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

Beachten Sie, dass ein Administratorupdate die Erstellung eines neuen Layouts nicht 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 beim Übergang 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 VisualStudio.17.Release.LTSC.17.0-Kanal basiert, wird der 17.0 LTSC-Kanal im Juli 2023 nicht mehr unterstützt, wir werden keine weiteren Sicherheitsupdates veröffentlichen, und Ihr Layout und Ihre Clients werden unsicher. Supportdaten 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 aus dem Visual Studio 2022-Versionsverlauf Seite ab, kopieren Sie ihn in Ihren Layoutordner, und führen Sie eine normale Aktualisierung durch. Ihre Clients sollten dann entsprechend über ein Update benachrichtigt werden, damit sie auch sicher bleiben können.

Ändern des Inhalts eines Layouts

Es ist möglich, ein partielles Layout zu ändern und 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 zum Layout hinzu, das zuvor mit nur der Workload "Verwalteter Desktop" und der englischen Sprache erstellt wurde. Nachdem wir die Änderung vorgenommen haben, werden sowohl die verwalteten Desktop- als auch die Azure-Arbeitsauslastungen sowie die englischen und deutschen Ressourcen in diesem Layout enthalten sein. Zusätzlich zum Hinzufügen von Komponenten bewirkt der Befehl --layout auch, 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 ein vorhandenes Partielles Layout so ändern möchten, dass es zu einem vollständigen Layout wird, verwenden Sie die Option --all, wie im folgenden Beispiel gezeigt. Dieser Befehl bewirkt erneut, dass der Layoutinhalt auf die vom Bootstrapper angegebene Version aktualisiert wird.

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

Sie können einem Layout Komponenten hinzufügen, indem Sie eine *.vsconfig Datei übergeben, die die zusätzlichen Komponenten enthält, die Sie im Layout benötigen. In diesem Fall überschreibt der neue *.vsconfig Inhalt den vorhandenen layout.vsconfig Inhalt. Weitere Informationen finden Sie im vorherigen Abschnitt Verwenden einer Konfigurationsdatei zum Initialisieren des Inhalts eines Layouts.

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

Schließlich können Sie die layout.json Konfigurationsdatei direkt im Layoutordner bearbeiten und den Abschnitt "Hinzufügen" dieser Datei aktualisieren, um die zusätzlichen Komponenten einzuschließen, die In Ihr Layout enthalten sein sollen. Anschließend müssen Sie das Layout mithilfe von --layout aktualisieren, wie zuvor beschrieben, um die neuesten Komponenten herunterzuladen.

Anmerkung

Die einfachste Möglichkeit zum Installieren der neu hinzugefügten Layoutkomponenten auf einem Clientcomputer besteht darin, den Bootstrapper im Layout vom Clientcomputer aus auszuführen. Der Abschnitt "Hinzufügen" der response.json Datei im Layout bestimmt, welche Komponenten standardmäßig in der Installationsprogramm-Benutzeroberfläche des Clients ausgewählt werden. Wenn Sie das Layout mit einer der oben genannten Methoden geändert haben, sollten Sie den Abschnitt "Hinzufügen" in der response.json Datei manuell überprüfen und möglicherweise anpassen, damit es dem Inhalt im Abschnitt "Hinzufügen" der neu geänderten layout.json Datei besser entspricht.

Konfigurieren Sie das Layout, um Out-of-Support-Komponenten auf dem Clientcomputer zu entfernen.

Einige Unternehmen möchten das in Visual Studio 2022, Version 17.4 eingeführte Feature nutzen, das Komponenten entfernt, die in einen Nicht-Support-Zustand umgestellt wurden. 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 vorhanden ist, wie untenbeschrieben. Zweitens müssen Sie der response.json Datei die Zeile "removeOos": true hinzufügen. Wenn ihr Layout diese beiden Details ordnungsgemäß festgelegt hat, beachten nachfolgende Administratorupdates diese Einstellung und entfernen nicht unterstützte Komponenten von den Clientcomputern.

Überprüfen eines Layouts

Verwenden Sie --verify, um die Überprüfung im Netzwerklayout durchzuführen, die überprüft, ob die Paketdateien entweder fehlen oder ungültig sind. Am Ende der Überprüfung wird die Liste der fehlenden und ungültigen Dateien gedruckt.

Die Überprüfung funktioniert nur für die neueste Version einer bestimmten Nebenversion von Visual Studio. Sobald eine neue Version veröffentlicht wird, funktioniert die Überprüfung nicht für Layouts, die frühere Versionen enthalten.

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

Anmerkung

Einige wichtige Metadatendateien, die von der Option --verify benötigt werden, müssen sich im Layoutordner befinden. Wenn diese Metadatendateien fehlen, kann "--verify" nicht ausgeführt werden, und Setup gibt ihnen einen Fehler. Wenn dieser Fehler auftritt, versuchen Sie, das Layout erneut zu aktualisieren, oder erstellen Sie ein neues Netzwerklayout in einem anderen Ordner erneut.

Denken Sie daran, dass Microsoft regelmäßig Updates für Visual Studio liefert. Wenn Sie also einen evergreen bootstrapperverwenden, enthält ein aktuelleres Layout möglicherweise nicht dieselbe Version wie das anfä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 --verify durchzuführen und auch zu versuchen, die identifizierten Probleme zu beheben. Der --fix Prozess benötigt eine Internetverbindung. Stellen Sie daher sicher, dass Ihr Computer mit dem Internet verbunden ist, bevor Sie --fixaufrufen.

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

Entfernen älterer Versionen aus einem Layout

Nachdem Sie Layoutupdates für einen Netzwerkcache ausgeführt haben, enthält der Layoutordner möglicherweise einige veraltete Pakete, die von der neuesten Visual Studio-Installation nicht mehr benötigt werden. Sie können die Option --clean verwenden, um veraltete Pakete aus dem Netzwerklayoutordner zu entfernen.

Hierfür benötigen Sie die Dateipfade zu den Katalogmanifesten, die diese veralteten Pakete enthalten. Sie finden die Katalogmanifeste in einem Ordner "Archiv" im Netzwerklayoutcache. Sie werden dort gespeichert, wenn Sie ein Layout aktualisieren. Im Ordner "Archiv" gibt es einen oder mehrere benannte GUID-Ordner, die jeweils ein veraltetes Katalogmanifest enthalten. Die Anzahl der "GUID"-Ordner sollte mit der Anzahl der Aktualisierungen übereinstimmen, die an Ihren Layouts vorgenommen wurden.

Einige Dateien werden in jedem "GUID"-Ordner gespeichert. Die beiden am meisten interessanten Dateien sind eine "catalog.json" Datei und eine "version.txt" Datei. Die Datei "catalog.json" ist das veraltete Katalogmanifest, das Sie an die Option --clean übergeben müssen. Die andere version.txt Datei enthält die Version dieses veralteten Katalogmanifests. Basierend auf der Versionsnummer können Sie entscheiden, ob Sie veraltete Pakete aus diesem Katalogmanifest entfernen möchten. Sie können die gleichen Aktionen ausführen, wie Sie die anderen GUID-Ordner durchlaufen. Nachdem Sie die Entscheidung für die Kataloge getroffen haben, die Sie bereinigen möchten, führen Sie den Befehl --clean aus, indem Sie die Dateipfade zu diesen Katalogen angeben.

Hier ist 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 Setup Ihren Netzwerklayoutordner, um die Liste der Dateien zu finden, die entfernt werden. Dann haben Sie die Möglichkeit, die Zu löschenden Dateien zu überprüfen und die Löschungen zu bestätigen.

Konfigurieren Sie das Layout so, dass es stets das neueste Installationsprogramm einbezieht und bereitstellt.

Anmerkung

Ab Juni 2023 wird das neueste Installationsprogramm standardmäßig mit jedem Update auf unterstützte Versionen von Visual Studio 2017, Visual Studio 2019 und Visual Studio 2022 bereitgestellt. Daher müssen Sie nichts explizit tun, um die neueste Version des Installers mit den neuesten Funktionen und Fehlerbehebungen in Ihrem Layout und auf Ihren Clients 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 die neuesten Installationsprogramme für Ihre Clients einschließen und bereitstellen, auch wenn das Installationsprogramm als Teil einer neueren Version von Visual Studio betrachtet wird. Wenn Ihr Client daher von diesem Layout aktualisiert wird, erhält der Client das neueste Installationsprogramm, das in diesem Layout enthalten und bereitgestellt wird. Der Vorteil besteht darin, dass Ihre Clientinstallationen, sobald sich das neueste Installationsprogramm auf Ihrem Client befindet, die Fehlerkorrekturen und neue Funktionen nutzen können, die wir dem Installationsprogramm weiterhin hinzufügen.

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

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

• Sie können den parameter --useLatestInstaller beim Erstellen oder Aktualisieren des Layouts an den Bootstrapper übergeben. Dies führt dazu, dass eine Einstellung in der layout.json Datei festgelegt wird, die sich im Stammverzeichnis des Layouts befindet. Hier ist ein Beispiel, wie Sie das Layout aktualisieren und so konfigurieren können, dass es das neueste und beste verfügbare Installationsprogramm verwendet.

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

• Sie können die layout.json Datei 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 "UseLatestInstaller": true aus der Datei layout.json.

Beachten Sie, dass Sie diese "UseLatestInstaller": true Einstellung auch in der response.json Datei des Layouts finden, aber sie wird dort ignoriert, um sicherzustellen, dass das Layout immer über das neueste Installationsprogramm verfügt. Die response.json Datei wird verwendet, um Standardkonfigurationsoptionen für den -Client festzulegen, wenn der Client ein Layoutinstalliert oder aktualisiert. Diese spezielle "useLatestInstaller": true Einstellung in der layout.json-Datei wird verwendet, um sicherzustellen, dass der Inhalt des Layout s das neueste Installationsprogramm enthält, damit die Clientcomputer dann das neueste Installationsprogramm aus dem Layout abrufen können.

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 ist aktiv.
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 die 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 auf weitere Informationen.

Support für Ihr Netzwerklayout erhalten

Wenn ein Problem mit Ihrem Netzwerklayout 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 sehr hilfreich, wenn Sie die Protokolle vom Visual Studio Collect-Tool senden könnten, das 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.

Verwandte Inhalte

• Visual Studio-Administratorhandbuch
• Bereitstellen von Visual Studio über ein Layout auf einem Clientcomputer
• Aktualisieren einer netzwerkbasierten Installation von Visual Studio
• Beheben von Netzwerkfehlern bei der Installation oder Verwendung von Visual Studio
• Konfigurieren von Richtlinien für Unternehmensbereitstellungen von Visual Studio
• Visual-Studio-Produktlebenszyklus und Wartungsplan
• Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio
• Visual Studio-Arbeitsauslastung und Komponenten-IDs
• Installieren von Zertifikaten, die für die Offlineinstallation von Visual Studio erforderlich sind