Aktualisieren von Visual Studio mithilfe eines minimalen Offlinelayouts

Für Computer, die nicht mit dem Internet verbunden sind, ist das Erstellen eines minimalen Layouts die einfachste und schnellste Möglichkeit, Ihre Offline-Visual Studio-Instanzen zu aktualisieren.

Das minimale Layouttool generiert ein Layout, das speziell auf die Anforderungen Ihres Teams zugeschnitten ist. Unternehmensadministratoren können dieses Tool verwenden, um Updatelayouts für die meisten Versionen von Visual Studio zu erstellen, einschließlich Visual Studio 2017. Im Gegensatz zu einem vollständigen Visual Studio-Layout enthält ein minimales Layout nur die aktualisierten Pakete, sodass es immer kleiner und schneller ist, um sie zu generieren und bereitzustellen. Sie können die Größe des Updatelayouts weiter minimieren, indem Sie nur die gewünschten Sprachen, Arbeitslasten und Komponenten angeben.

So generieren Sie ein minimales Layout

Wichtig

Bei diesen Anweisungen wird davon ausgegangen, dass Sie zuvor Layouts erstellt und verwendet haben. Weitere Informationen dazu finden Sie unter Aktualisieren einer netzwerkbasierten Installation von Visual Studio Seite.

Ein besseres Verständnis des Visual Studio-Lebenszyklus finden Sie auf der Seite Visual Studio Product Lifecycle and Servicing.

Dieses Tool erstellt Updatelayouts für Visual Studio 2017 (15.9) und höher. Das Layout kann auf Netzwerk-/Offlinecomputern bereitgestellt werden, um Visual Studio-Instanzen zu aktualisieren. Während der normalen Layouterstellung werden alle Pakete für ein bestimmtes Release heruntergeladen. Die normale Layouterstellung ist zum Reparieren, Deinstallieren und anderen Standardvorgängen in Visual Studio-Instanzen erforderlich. Das minimale Layout lädt nur aktualisierte Pakete herunter, sodass es kleiner und einfacher ist, auf Offlinecomputer zu kopieren.

Das Minimallayout-Tool installieren

1. Laden Sie zunächst das Tool für minimale Layouts hier herunter. Klicken Sie bei Aufforderung auf die Option Speichern und dann auf Ausführen.

   

2. Akzeptieren Sie als Nächstes die Eingabeaufforderung für die Benutzerkontensteuerung, indem Sie auf Jaklicken.

   

3. Das Tool für minimale Layouts wird unter C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout installiert.

Wie Sie das Minimal-Layouttool verwenden

MinimalLayout.exe verwendet die folgenden Befehle und Optionen, um das Layout zu generieren. Zum Ausführen des Tools ist mindestens ein Befehl erforderlich. So führen Sie das Tool aus:

MinimalLayout.exe [command] <options>...

Befehle

• Vorschau-: Verwenden Sie diesen Befehl, um in der Vorschau anzuzeigen, wie viele Pakete heruntergeladen werden sollen, und den Gesamtspeicher, der zum Erstellen dieses Layouts verwendet wurde.

• Generate: Verwenden Sie diesen Befehl, um das minimale Layout für die Aktualisierung von Visual Studio zu generieren.

• Neugenerieren: Verwenden Sie diesen Befehl, um ein Layout mithilfe einer vorhandenen minimalen Layoutantwortdatei neu zu generieren. Jedes minimale Layout erzeugt eine MinimalLayout.json Antwortdatei, die die ursprünglichen minimalen Layouteingabeparameter enthält. Sie können den Befehl regenerate und eine MinimalLayout.json-Antwortdatei verwenden, um das minimale Layout erneut zu generieren. Dies ist nützlich, wenn Sie ein minimales Layout für ein neues Visual Studio-Update basierend auf der Antwortdatei des vorherigen minimalen Layouts erstellen möchten.

  Für diesen Befehl ist ein MinimalLayout.json Dateipfad aus einem bereits generierten Layout erforderlich.

  MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
  

• Überprüfen Sie: Verwenden Sie diesen Befehl, um zu ermitteln, ob der Layoutordner beschädigt ist.

• Fix: Verwenden Sie diesen Befehl, um einen beschädigten Layoutordner zu beheben, einschließlich des Ersetzens fehlender Pakete aus dem Layoutordner.

Optionen

Optionen	Beschreibung	Erforderlich/Optional	Beispiel
--targetLocation <Verzeichnis>	Gibt ein Verzeichnis an, in dem ein minimales Offlinelayout erstellt werden soll.	Erforderlich	--targetLocation c:\VSLayout\
--baseVersion <Version>	Das minimale Offlinelayout wird ab dieser Version generiert.	Erforderlich	--baseVersion 16.4.0
--targetVersion <Version>	Das minimale Offlinelayout wird bis zu und einschließlich dieser Version generiert.	Erforderlich	--targetVersion 16.4.4
--Sprachen	Gibt die Sprachen an, die im minimalen Offlinelayout enthalten sein sollen. Mehrere Werte können durch Leerzeichen getrennt angegeben werden.	Erforderlich	--Sprachen en-US fr-FR
--productIds <eine oder mehrere Produkt-IDs>	Die ID(en) der Produkte, von denen das minimale Offlinelayout generiert wird, getrennt durch Kommas. Microsoft.VisualStudio.Product.Enterprise Microsoft.VisualStudio.Product.Professional Microsoft.VisualStudio.Product.BuildTools Microsoft.VisualStudio.Product.TestAgent Microsoft.VisualStudio.Product.TestController Microsoft.VisualStudio.Product.TeamExplorer	Erforderlich	--productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional
--filePath	Der Dateipfad der MinimalLayout.json-Datei eines bereits erstellten Layouts Diese Option wird nur mit dem Befehl "Neu generieren" verwendet.	Erforderlich für den Befehl "Neu generieren"	--filePath C:\VSLayout\minimalLayout.json Beachten Sie, dass der Befehl "Generieren" nur "-filePath" als Option verwendet.
--add <mindestens eine Workload- oder Komponenten-ID>	Gibt eine oder mehrere Workload- oder Komponenten-IDs an, die hinzugefügt werden sollen. Zusätzliche Komponenten können global hinzugefügt werden, wenn Sie --includeRecommended und/oder –-includeOptional. Mehrere Workloads oder Komponenten-IDs können durch ein Leerzeichen getrennt angegeben werden.	Wahlfrei	--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended	Enthält die empfohlenen Komponenten für alle installierten Workloads, aber nicht die optionalen Komponenten.	Wahlfrei	Für eine bestimmte Arbeitsauslastung: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended Zur Anwendung auf Workloads: --includeRecommended
--includeOptional	Enthält die optionalen Komponenten für alle installierten Workloads, einschließlich der empfohlenen Komponenten.	Wahlfrei	Für eine bestimmte Arbeitsauslastung: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional Zur Anwendung auf Workloads: --includeOptional

Generieren eines minimalen Layouts

Wichtig

Diese Anweisungen gehen davon aus, dass Sie zuvor ein Netzwerkinstallationslayout erstellt haben. Weitere Informationen dazu finden Sie unter Erstellen einer Netzwerkinstallation von Visual Studio Seite.

Erstellen Sie mithilfe des generate-Befehls ein minimales Layout für Ihre speziellen Versionen. Außerdem müssen Sie die productId, die Sprachen und die erforderlichen spezifischen Workloads kennen. Dieses minimale Layout aktualisiert jede Visual Studio-Instanz von der Basisversion bis hin zur Zielversion.

Bevor Sie das Layout erstellen, können Sie die Gesamtgröße des Downloads und die Anzahl der enthaltenen Pakete mithilfe des Befehls Vorschau ermitteln. Dieser Befehl akzeptiert dieselben Optionen wie der generate-Befehl, und die Details werden in die Konsole geschrieben.

Sehen wir uns ein paar Beispiele für die Vorschau, Generierung und Neugenerierung eines minimalen Layouts an:

• Im Folgenden finden Sie ein Beispiel für die Vorschau eines Layouts für Visual Studio Enterprise- Versionen 16.4.0 bis 16.4.4 für Englisch.

  MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
  

• Hier erfahren Sie, wie Sie dasselbe Layout mit einer Workload generieren.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
  

• Und hier erfahren Sie, wie Sie ein minimales Offlinelayout mithilfe einer vorhandenen Antwortdatei neu generieren.

  MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
  

Einige weitere Beispiele mit dem befehl "generieren":

• Hier erfahren Sie, wie Sie eine zusätzliche Workload hinzufügen und nur die empfohlenen Pakete einschließen.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
  

• Sie können auch ein minimales Offlinelayout generieren, das mehrere Produkte unterstützt.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
  

• Und schließlich erfahren Sie, wie Sie mehrere Sprachen in Ihr minimales Layout einschließen.

  MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
  

Wie man ein minimalistisches Layout beibehält

Verwenden Sie die Befehle verify und fix, um Ihr minimales Layout nach seiner Erstellung zu verwalten. Der verify-Befehl bestimmt, ob es beschädigte oder fehlende Pakete im minimalen Layout gibt. Wenn nach dem Ausführen des Befehls Probleme auftreten sollten, verwenden Sie den Befehl , um diese fehlenden oder beschädigten Pakete zu beheben.

• So überprüfen Sie, ob ein Layout beschädigte oder fehlende Pakete aufweist:

  MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US
  

• Und hier erfahren Sie, wie Sie dieses Layout beheben:

  MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
  

Anmerkung

Dieses Layout kann nicht zum Reparieren einer Visual Studio-Installation verwendet werden. Informationen zum Reparieren einer vorhandenen Instanz von Visual Studio finden Sie unter Reparieren von Visual Studio.

Verwenden eines minimalen Offlinelayouts zum Aktualisieren einer vorhandenen Installation von Visual Studio

Nach dem Generieren eines minimalen Layouts können Sie den gesamten minimalen Layoutordner auf einen Clientcomputer kopieren. Dies ist erforderlich, wenn der Computer keinen Zugriff auf den minimalen Layoutordner am ursprünglichen Speicherort hat.

Navigieren Sie zum Ordner, und identifizieren Sie den Namen der Bootstrapperanwendung. Der Name der Bootstrapper-Anwendung hängt vom ProductId-Wert ab, der beim Generieren des minimalen Layouts angegeben ist. In der folgenden Tabelle finden Sie allgemeine Beispiele.

ProductId-Wert	Anwendungsname
Microsoft.VisualStudio.Product.Enterprise	vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional	vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools	vs_buildtools.exe

Das Update wird in zwei Schritten auf eine Visual Studio-Instanz angewendet. Aktualisieren Sie zunächst den Visual Studio Installer und dann Visual Studio.

1. Aktualisieren des Visual Studio Installer-

   Führen Sie den folgenden Befehl aus, und ersetzen Sie bei Bedarf vs_enterprise.exe durch den richtigen Bootstrapperanwendungsnamen.

   vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
   

2. Aktualisieren der Visual Studio-Anwendung

   Um Visual Studio zu aktualisieren, müssen Sie den installPath der Visual Studio-Instanz angeben, die Sie aktualisieren möchten. Wenn mehrere Instanzen von Visual Studio installiert sind, muss jeder einzeln aktualisiert werden. Es wird dringend empfohlen, die Option –noWeb mit dem Updatebefehl anzugeben, um die Installation von Komponenten zu verhindern, die nicht im minimalen Layout enthalten sind. Dadurch wird verhindert, dass Visual Studio in einem nicht verwendbaren Zustand bleibt.

   Führen Sie den folgenden Befehl aus, und ersetzen Sie den befehlszeilenparameter installPath entsprechend. Achten Sie darauf, auch den richtigen Bootstrapperanwendungsnamen zu verwenden.

   vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
   

Support oder Problembehandlung

Manchmal kann es zu einem Fehler kommen. Wenn es bei der Installation von Visual Studio zu einem Fehler kommt, finden Sie ausführliche Informationen im Artikel Problembehandlung bei der Visual Studio-Installation und bei Upgradefehlern.

Hier sind einige weitere Supportoptionen:

• Verwenden Sie die Supportoption Installationschat (nur Englisch) für Installationsprobleme.
• Melden Sie produktprobleme an uns, indem Sie das Tool "Problem melden" verwenden, 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übermitteln.
• Schlagen Sie ein Feature vor, verfolgen Sie Produktprobleme, und finden Sie Antworten in der Visual Studio Developer Community.

Verwandte Inhalte

• Visual Studio- installieren
• Visual Studio-Administratorhandbuch
• Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio
• Tools zum Erkennen und Verwalten von Visual Studio-Instanzen
• Definieren von Einstellungen in einer Antwortdatei
• Steuern von Updates für netzwerkbasierte Visual Studio-Bereitstellungen
• Visual Studio Produktlebenszyklus und Wartung