Aktualisieren von Visual Studio mit einem minimalen Offlinelayout

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

Das Tool für minimale Layouts erstellt ein perfekt auf die Anforderungen Ihres Teams angepasstes Layout. Unternehmensadministratoren können dieses Tool verwenden, um Aktualisierungslayouts für die meisten Versionen von Visual Studio, einschließlich Visual Studio 2017, zu erstellen. Im Gegensatz zu einem vollständigen Visual Studio-Layout enthält ein minimales Layout nur die aktualisierten Pakete. Die Größe ist also immer geringer, und die Generierung und Bereitstellung kann schneller erfolgen. Sie können die Größe des Updatelayouts noch weiter verringern, indem Sie nur die gewünschten Sprachen, Workloads und Komponenten angeben.

Generieren eines minimalen Layouts

Wichtig

Bei diesen Anweisungen wird vorausgesetzt, dass Sie zuvor bereits Layouts erstellt und verwendet haben. Weitere Informationen hierzu finden Sie unter Aktualisieren einer netzwerkbasierten Installation von Visual Studio.

Nähere Informationen zum Visual Studio-Lebenszyklus finden Sie unter Produktlebenszyklus und Preise in Visual Studio.

Dieses Tool erstellt Updatelayouts ab Visual Studio 2017 (15.9). Das Layout kann auf Netzwerkcomputern oder Offlinecomputern bereitgestellt werden, um Visual Studio-Instanzen zu aktualisieren. Während der normalen Layouterstellung werden alle Pakete für ein bestimmtes Release heruntergeladen. Die Erstellung von normalen Layouts ist für das Reparieren, Deinstallieren und weitere Standardvorgänge in Visual Studio-Instanzen erforderlich. Beim minimalen Layout werden nur aktualisierte Pakete heruntergeladen, es ist also kleiner und kann einfacher auf Offlinecomputer kopiert werden.

Installieren des Tools für minimale Layouts

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ächsten Schritt die Aufforderung für die Benutzerkontensteuerung, indem Sie auf Ja klicken.

   

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

Verwenden des Tools für minimale Layouts

MinimalLayout.exe verwendet die folgenden Befehle und Optionen, um das Layout zu generieren. Mindestens ein Befehl ist erforderlich, um das Tool auszuführen. So wird das Tool ausgeführt:

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

Befehle

• Vorschau: Verwenden Sie diesen Befehl, um als Vorschau zu sehen, wie viele Pakete heruntergeladen werden und wie viel Speicherplatz erforderlich ist, um das Layout zu erstellen.

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

• regenerate: Verwenden Sie diesen Befehl, um ein Layout mithilfe einer Antwortdatei für minimale Layouts erneut zu generieren. Jedes minimale Layout erzeugt eine MinimalLayout.json-Antwortdatei, die die Eingabeparameter für das ursprüngliche minimale Layout enthält. Sie können den Befehl regenerate und eine MinimalLayout.json-Antwortdatei verwenden, um das minimale Layout erneut zu generieren. Dies ist dann hilfreich, wenn Sie ein minimales Layout für eine neue Visual Studio-Aktualisierung erstellen möchten, die auf der Antwortdatei des vorherigen minimalen Layouts basieren soll.

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

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

• verify: Verwenden Sie diesen Befehl, um zu bestimmen, ob der Layoutordner beschädigt ist.

• Problemlösung: Verwenden Sie diesen Befehl, um Fehlerbehebungen für den beschädigten Layoutordner durchzuführen, einschließlich des Ersetzens jeglicher 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
--languages	Gibt die Sprachen an, die in das minimale Offlinelayout eingeschlossen werden sollen. Es können mehrere Werte angegeben werden, die dann durch Leerzeichen voneinander getrennt werden müssen.	Erforderlich	--languages en-US fr-FR
--productIds <mindestens eine Produkt-ID>	Die ID(s) der Produkte, aus 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 regenerate-Befehl verwendet.	Für den regenerate-Befehl erforderlich	--filePath C:\VSLayout\minimalLayout.json Beachten Sie, dass der regenerate-Befehl nur --filePath als Option akzeptiert.
--add <mindestens eine Workload- oder Komponenten-ID>	Gibt mindestens eine Workload- oder Komponenten-ID an, die hinzugefügt werden soll. Zusätzliche Komponenten können global hinzugefügt werden, wenn Sie --includeRecommended und/oder –-includeOptional verwenden. Es können mehrere Workload- oder Komponenten-IDs angegeben werden, die durch ein Leerzeichen voneinander getrennt werden müssen.	Optional	--add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended	Enthält die empfohlenen Komponenten für alle zu installierenden Workloads, aber keine optionalen Komponenten.	Optional	Für eine bestimmte Workload: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended Zur Anwendung aller Workloads: --includeRecommended
--includeOptional	Enthält die optionalen Komponenten für alle zu installierenden Workloads, einschließlich der empfohlenen Komponenten.	Optional	Für eine bestimmte Workload: --add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional Zur Anwendung aller Workloads: --includeOptional

Generieren eines minimalen Layouts

Wichtig

Bei diesen Anweisungen wird vorausgesetzt, dass Sie zuvor ein Layout für die Netzwerkinstallation erstellt haben. Weitere Informationen hierzu finden Sie auf der Seite Erstellen einer Netzwerkinstallation von Visual Studio.

Erstellen Sie mithilfe des generate-Befehls ein minimales Layout für Ihre speziellen Versionen. Sie müssen dazu außerdem die Produkt-ID, die Sprachen und sämtliche erforderlichen Workloads kennen. Dieses minimale Layout aktualisiert alle Visual Studio-Instanzen von der Basisversion bis zu und einschließlich der Zielversion.

Bevor Sie das Layout erstellen, können Sie sich die Gesamtgröße des Downloads und die Anzahl der darin eingeschlossenen Pakete anzeigen lassen, indem Sie den preview-Befehl verwenden. Dieser Befehl akzeptiert dieselben Optionen wie der generate-Befehl, und die Details werden in die Konsole geschrieben.

Im Folgenden sehen Sie einige Beispiele, wie eine Vorschau für ein minimales Layout angezeigt werden kann und wie es generiert und erneut generiert werden kann:

• Zuerst sehen Sie hier ein Beispiel, wie Sie eine Vorschau für ein Layout für die Visual Studio Enterprise-Versionen 16.4.0 bis 16.4.4 nur für die Sprache Englisch anzeigen können.

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

• Hier sehen 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
  

• Hier wiederum sehen Sie, wie Sie ein minimales Offlinelayout mithilfe einer vorhandenen Antwortdatei erneut generieren.

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

Nachstehend sehen Sie einige Beispiele für die Verwendung des generate-Befehls:

• Hier sehen 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
  

• Schließlich sehen Sie hier, wie Sie mehrere Sprachen in Ihr minimales Layout einschließen würden.

  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
  

Verwalten eines minimalen Layouts

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 der Ausführung des verify-Befehls Probleme auftreten, verwenden Sie den fix-Befehl, um diese fehlenden oder beschädigten Pakete zu korrigieren.

• So überprüfen Sie, ob es in einem Layout fehlende oder beschädigte Pakete gibt:

  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
  

• So korrigieren Sie ein solches Layout:

  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
  

Hinweis

Dieses Layout kann nicht verwendet werden, um Fehler einer Visual Studio-Installation zu beheben. Weitere Informationen zum Reparieren einer vorhandenen Visual Studio-Instanz finden Sie unter Reparieren von Visual Studio.

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

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

Navigieren Sie zum Ordner, und identifizieren Sie den Namen der Bootstrapanwendung. Der Name der Bootstrapanwendung hängt vom ProductId-Wert ab, der beim Generieren des minimalen Layouts angegeben wird. In der Tabelle unten finden Sie weitere Beispiele für häufige Werte.

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

Die Aktualisierung wird auf eine Visual Studio-Instanz in zwei Schritten angewendet. Beginnen Sie damit, den Visual Studio-Installer zu aktualisieren, und aktualisieren Sie dann Visual Studio.

1. Aktualisieren des Visual Studio-Installers

   Führen Sie den folgenden Befehl aus, und ersetzen Sie vs_enterprise.exe bei Bedarf durch den korrekten Namen der Bootstrapanwendung.

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

2. Aktualisieren der Visual Studio-Anwendung

   Zum Aktualisieren von Visual Studio müssen Sie den Installationspfad (installPath) der Visual Studio-Instanz angeben, die Sie aktualisieren möchten. Wenn mehrere Visual Studio-Instanzen installiert sind, muss jede einzeln aktualisiert werden. Es wird empfohlen, die –noWeb-Option unbedingt mit dem Befehl zur Aktualisierung anzugeben, um die Installation von Komponenten zu verhindern, die nicht Teil des minimalen Layouts sind. So kann verhindert werden, dass Visual Studio in einen nicht nutzbaren Zustand gerät.

   Führen Sie den folgenden Befehl aus, und ersetzen Sie dabei den installPath-Befehlszeilenparameter entsprechend. Vergewissern Sie sich außerdem, dass der richtige Bootstrapanwendungsname verwendet wird.

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

Support oder Problembehandlung

Manchmal kann etwas schiefgehen. 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:

• Für installationsbezogene Probleme wird eine Livechat-Supportoption angeboten (nur auf Englisch).
• Sie können uns über Produktprobleme mit dem Tool Problem melden informieren, das sowohl im Visual Studio-Installer als auch in der Visual Studio-IDE angezeigt wird. Wenn Sie IT-Administrator*in sind und noch kein Visual Studio haben, können Sie hier Feedback zu IT-Administratoren senden.
• Schlagen Sie ein Feature vor, verfolgen Sie Produktprobleme nach, und finden Sie Antworten in der Visual Studio-Entwicklercommunity.

Zugehöriger Inhalt

• Installieren von Visual Studio
• Administratorhandbuch für Visual Studio 2017 RC
• Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio
• Tools zum Erkennen und Verwalten von Visual Studio-Instanzen
• Gewusst wie: Definieren von Einstellungen in einer Antwortdatei
• Steuern von Updates für netzwerkbasierte Visual Studio-Bereitstellungen
• Projektlebenszyklus und Wartung in Visual Studio