Verwenden von Befehlszeilenparametern zum Installieren, Aktualisieren und Verwalten von Visual Studio

Wenn Sie Visual Studio programmgesteuert oder über eine Eingabeaufforderung installieren, können Sie verschiedene Befehlszeilenparameter verwenden, um die Installation zu steuern oder anzupassen, um die folgenden Aktionen auszuführen:

• Starten Sie die Installation auf dem Client mit bestimmten Optionen und Verhaltensweisen, die vorab ausgewählt wurden.
• Automatisieren Sie den Installations- oder Aktualisierungsprozess.
• Erstellen oder Verwalten eines Netzwerklayouts der Produktdateien zum Installieren oder Aktualisieren von Clientcomputern.

Die folgenden Befehlszeilenverben und -parameter können mit den folgenden ausführbaren Dateien oder Programmen verwendet werden:

• Der Setup-Bootstrapper, bei dem es sich um die kleine (~1 MB)-Datei (z. B. vs_enterprise.exe) handelt, die den Downloadvorgang und die Erstinstallation initiiert.
• Das Visual Studio-Installationsprogramm, das möglicherweise bereits auf dem Computer installiert ist und sich im Ordner C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebefindet. Sie müssen das Installationsprogramm programmgesteuert aus einem anderen Verzeichnis als dem initiieren, in dem sich das Installationsprogramm befindet. Das Installationsprogramm wird in der Regel für Aktualisierungs- oder Änderungsbefehle verwendet.
• Mit einem winget-Befehl, der den winget-Parameter „--override“ verwendet
• Mit einem Administratorupdatepaket, das aus dem Microsoft Update Catalogheruntergeladen werden kann, um Ihr Netzwerklayout programmgesteuert zu aktualisieren. Weitere Informationen finden Sie im Artikel "Aktualisieren oder Ändern Ihres Layouts".

Nicht alle Befehle oder Parameter funktionieren in jeder dieser Situationen, und alle speziellen Einschränkungen oder Ausnahmen werden dokumentiert. Darüber hinaus haben Sie in einigen Szenarien möglicherweise keinen Zugriff auf alle diese ausführbaren Dateien, die zuvor beschrieben wurden. Beispielsweise verfügen Clientcomputer möglicherweise nur über das Installationsprogramm für die programmgesteuerte Ausführung, wenn Visual Studio über ein Layout installiert wurde.

Um die neuesten Bootstrapper für Visual Studio 2022 zu erhalten, die immer die neueste Version des aktuellen Kanals installieren, laden Sie eine der Dateien in der folgenden Tabelle herunter. Wenn Sie alternativ eine bestimmte Version oder einen bestimmten Kanal von Visual Studio 2022 installieren möchten, lesen Sie die Seite Visual Studio 2022-Versionsverlauf. Diese Seite enthält Links zur unveränderbaren Version der Bootstrapper für jedes Wartungsrelease.

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 Werts“ gelesen werden, und der Kanal ist Aktuell, sofern nicht explizit angegeben. 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 einfach Visual Studio 2022 angibt, installiert die neueste Version von Visual Studio 2022 über den aktuellen Channel.

Installieren, Aktualisieren, Ändern, Reparieren, Deinstallieren und Exportieren von Befehlen und Befehlszeilenparametern

Wenn Sie den Visual Studio-Bootstrapper oder das Installationsprogramm programmgesteuert aufrufen, um das Produkt zu installieren oder ein Layout zu verwalten:

• Der erste Parameter ist der Befehl (das Verb), der den auszuführenden Vorgang beschreibt.
• Die nachfolgenden optionalen Befehlszeilenparameter, die alle durch zwei Gedankenstriche (--) präfixiert werden, definieren weiter, wie dieser Vorgang erfolgen soll.

Bei allen Befehlszeilenparametern von Visual Studio wird die Groß-/Kleinschreibung nicht beachtet, und weitere Beispiele finden Sie auf der Seite Beispiele für Befehlszeilenparameter.

Syntaxbeispiel: vs_enterprise.exe [command] <optional parameters>...

Befehl	Beschreibung
(leer)	Der Standardbefehl installiert das Produkt und dient zugleich allen Layoutwartungsvorgängen.
modify	Ändert ein installiertes Produkt.
update	Aktualisiert ein installiertes Produkt.
updateall	Aktualisiert alle installierten Produkte in sequenzieller Reihenfolge. Funktioniert mit --quiet- und --passive-Parametern.
repair	Repariert ein installiertes Produkt.
uninstall	Deinstalliert ein installiertes Produkt.
export	Exportiert die Installationskonfiguration in eine *.vsconfig Datei.

Wichtig

Wenn Sie mehrere unterschiedliche Workloads oder Komponenten oder Sprachen angeben, müssen Sie die --add oder --remove Befehlszeilenoption für jedes Element wiederholen.

Parameter	Beschreibung
--installPath <dir>	Für den Standardinstallationsbefehl ist dieser Parameter Optional und beschreibt, wo die Instanz auf dem Clientcomputer installiert ist. Bei anderen Befehlen wie Aktualisieren oder Ändern ist dieser Parameter Erforderlich und gibt das Installationsverzeichnis an, auf das die Instanz reagieren soll.
--productId <id>	Optional: Die ID der Produktinstanz, die geändert und mit --channelId verwendet wird Die productID ist etwa "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	Optional: Während eines Aktualisierungsbefehls können Sie eine neue --channelUri übergeben, um den Speicherort der Updateeinstellungen zu ändern. Es wird empfohlen, den Parameter --installPath zu koppeln, damit Sie explizit angeben können, welche Instanz von Visual Studio Sie konfigurieren. Siehe Syntaxbeispiele für --channelUri
--channelId <id>	Die ID des Kanals, z. B. VisualStudio.17.Release. Siehe Syntaxbeispiele für --channelId. channelId ist für Änderungsvorgänge neben --productID oder --installPatherforderlich.
--add <one or more workload or component IDs>	Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter eine oder mehrere Workload- oder Komponenten-IDs an, die hinzugefügt werden sollen. Die erforderlichen Komponenten des Artefakts werden installiert, aber nicht die empfohlenen oder optionalen Komponenten. Sie können andere Komponenten global mit --includeRecommended und/oder --includeOptional Parametern steuern. Um mehrere Arbeitslasten oder Komponenten einzuschließen, wiederholen Sie den befehl --add (z. B. --add Workload1 --add Workload2). Bei feinerer Steuerung können Sie ;includeRecommended oder ;includeOptional an die ID anfügen (z. B. --add Workload1;includeRecommended oder --add Workload2;includeRecommended;includeOptional). Weitere Informationen finden Sie auf der Seite Workload und Komponenten-IDs.
--all	Optionaler: Während eines Installations- oder Änderungsbefehls bewirkt dieser Parameter, dass alle Arbeitslasten und Komponenten für das Produkt installiert werden.
--allWorkloads	Optional: Während eines Installations- oder Änderungsbefehls installiert dieser Parameter alle Workloads und Komponenten, aber keine empfohlenen oder optionalen Komponenten.
--includeRecommended	Optionaler: Während eines Installations- oder Änderungsbefehls enthält dieser Parameter die empfohlenen Komponenten für alle installierten Workloads. Sie enthält nicht die optionalen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --addangegeben. Bitte beachten Sie, dass Sie mit dem parameter --includeRecommended Ihr Updateeinstellungen Dialogfeld "Empfohlene Komponenten für installierte Workloads beim Update hinzufügen" aktivieren. Informationen zum Ändern dieser Einstellung finden Sie unter Anpassen von Updateeinstellungen.
--includeOptional	Optionaler: Während eines Installations- oder Änderungsbefehls enthält dieser Parameter die optionalen Komponenten für alle installierten Workloads. Es enthält nicht die empfohlenen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --addangegeben.
--addProductLang <language-locale>	Optionaler: Während eines Installations- oder Änderungsbefehls gibt dieser wiederholbare Parameter die Benutzeroberflächen-Sprachpakete an, die mit dem Produkt installiert werden sollen. Wenn sie nicht vorhanden ist, verwendet die Installation das Sprachpaket, das dem Gebietsschema des Computers entspricht. Weitere Informationen finden Sie in der [Liste der Sprachregionen]
--remove <one or more workload or component IDs>	Optional: Während eines modify-Befehls gibt dieser wiederholbare Parameter eine oder mehrere Workload- oder Komponenten-IDs an, die entfernt werden sollen. Sie ergänzt und verhält sich ähnlich wie der --add Parameter.
(#list-of-language-locales) Abschnitt auf dieser Seite
--removeProductLang <language-locale>	Optionaler: Während eines Installations- oder Änderungsbefehls bestimmt dieser wiederholbare Parameter die Benutzeroberflächen-Sprachpakete, die aus dem Produkt entfernt werden sollen. Sie ergänzt und verhält sich ähnlich wie der --addProductLang Parameter.
--in <path>	Optional: Der URI oder Pfad zu einer Antwortdatei, die möglicherweise Konfigurationseinstellungen enthält.
--quiet	Optionaler: Wird mit einem beliebigen Befehl verwendet, verhindert dieser Parameter, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird. Nicht programmatisch für Standardbenutzer verfügbar, unabhängig davon, wie die Richtlinie AllowStandardUserControl festgelegt wird.
--passive, -p	Optionaler: Dieser Parameter bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. Dieser Parameter schließt den --quiet-Parameter aus und überschreibt ihn tatsächlich. Unabhängig davon, wie die AllowStandardUserControl-Richtlinie festgelegt ist, steht diese Funktion auch Standardbenutzern nicht zur programmgesteuerten Nutzung zur Verfügung.
--norestart	Optionaler: Dieser Parameter muss entweder mit den Parametern --passive oder --quiet gekoppelt werden. Bei einer Installation, Aktualisierung oder Änderung des Befehls verzögert das Hinzufügen des --norestart Parameters alle erforderlichen Neustarts.
--force	Optionaler: Dieser Parameter erzwingt das Schließen von Visual Studio, selbst wenn ein Visual Studio-Prozess in Verwendung ist. Das Erzwingen des Schließens von Visual Studio kann zu Arbeitsverlusten führen. Verwenden Sie sie daher mit Vorsicht.
--installWhileDownloading	Optionaler: Während eines Installations-, Update- oder Änderungsbefehls ermöglicht dieser Parameter, dass Visual Studio das Produkt gleichzeitig herunterladen und installieren kann. Dies ist das Standarderlebnis.
--downloadThenInstall	Optionaler: Während eines Installations-, Update- oder Änderungsbefehls zwingt dieser Parameter Visual Studio, alle Dateien herunterzuladen, bevor sie installiert werden. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus.
--nickname <name>	Optionaler: Während eines Installationsbefehls definiert dieser Parameter den Spitznamen, der einem installierten Produkt zugewiesen werden soll. Der Spitzname darf maximal 10 Zeichen lang sein.
--productKey	Optionaler: Während eines Installationsbefehls definiert dieser Parameter den Product Key, der für ein installiertes Produkt verwendet werden soll. Der Product Key besteht aus 25 alphanumerischen Zeichen im Format xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Optionaler: Während eines Installations-, Update- oder Änderungsbefehls weist dieser Parameter, gefolgt von true oder false, dem Visual Studio-Installer an, ob alle installierten Komponenten entfernt werden sollen, die in einen Nicht-Support-Zustand übergegangen sind. Dieses Verhalten gilt für ein einzelnes Ereignis. Wenn Sie dieses Verhalten dauerhaft gestalten möchten, wenden Sie diesen Parameter auf den Befehl modifySettings an, der später beschrieben wird, oder die globale RemoveOOS-Richtliniekonfigurieren. Nützlich, um die Sicherheit des Computers zu gewährleisten.
--config <path to *.vsconfig file>	Optional: Während eines Installations- oder Änderungsvorgangs können Sie eine Konfigurationsdatei mithilfe des Parameters --config übergeben, um die Workloads, Komponenten oder Erweiterungen anzugeben, die basierend auf einer zuvor gespeicherten Installationskonfigurationsdatei hinzugefügt werden sollen. Dieser Vorgang ist nur additiv; sie entfernt nichts, das in der Datei nicht angegeben ist. Außerdem werden elemente, die in der Konfigurationsdatei angegeben sind, die nicht für das Produkt gelten, nicht hinzugefügt. Es wird dringend empfohlen, den vollqualifizierten Pfad zur Konfigurationsdatei anzugeben. Während eines Exportvorgangs bestimmt dieser Parameter den Speicherort zum Speichern der Installationskonfigurationsdatei.
--allowUnsignedExtensions	Optional: Wenn während eines Installations- oder Änderungsvorgangs, der im --passive- oder --quiet-Kontext mit einer --config-Datei ausgeführt wird, Erweiterungen in der Konfigurationsdatei angegeben sind, ist dieser Parameter erforderlich, um Erweiterungen ohne digitale Signatur zu laden.
--installerOnly	Optionaler: Während eines Installations- oder Aktualisierungsvorgangs weist dieser Parameter dem Visual Studio Installer an, sich nur selbst (das Installationsprogramm) und nicht das Visual Studio-Produkt zu installieren. Seine Funktionalität entspricht dem --update Parameter, aber intuitiver. Dient zum Vorbereiten und Vorkonfigurieren von Clientcomputern.
--help, --?, -h, -?	Zeigt eine Offlineversion dieser Seite an.

Befehl für Layout und Befehlszeilenparameter

Alle Layoutverwaltungsvorgänge, z. B. das Erstellen oder Aktualisieren eines Layouts, werden mit der Bootstrapper-Exe ausgeführt und gehen davon aus, dass der Befehl die Standardinstallation ist (leer). Alle Layoutverwaltungsvorgänge sollten mit dem erforderlichen --layout anfänglichen Parameter beginnen. In der folgenden Tabelle werden die anderen Parameter beschrieben, die Sie zum Erstellen oder Aktualisieren eines Layouts mithilfe der Befehlszeile verwenden können.

Layoutparameter	Beschreibung
--layout <dir>	Gibt ein Verzeichnis zum Erstellen oder Aktualisieren eines Offlineinstallationscaches an. Weitere Informationen finden Sie unter Erstellen einer netzwerkbasierten Installation von Visual Studio.
--lang <one or more language-locales>	Optional: Wird mit --layout verwendet, um einen Offlineinstallationscache mit Ressourcenpaketen für eine oder mehrere der angegebenen Sprachen vorzubereiten. Weitere Informationen finden Sie im Abschnitt Liste der Gebietsschemas dieser Seite.
--add <one or more workload or component IDs>	Optional: Eine oder mehrere hinzuzufügende Arbeitsauslastungs- oder Komponenten-IDs. Die erforderlichen Komponenten des Artefakts werden installiert, aber nicht die empfohlenen oder optionalen Komponenten. Sie können mehr Komponenten global steuern, indem Sie --includeRecommended und/oder --includeOptionalverwenden. Bei feinerer Steuerung können Sie ;includeRecommended oder ;includeOptional an die ID anfügen (z. B. --add Workload1;includeRecommended oder --add Workload2;includeOptional). Weitere Informationen finden Sie auf der Seite Arbeitsauslastungs- und Komponenten-IDs. Hinweis: Wenn --add verwendet wird, werden nur die angegebenen Workloads und Komponenten und deren Abhängigkeiten heruntergeladen. Wenn --add nicht angegeben ist, werden alle Workloads und Komponenten in das Layout heruntergeladen.
--includeRecommended	Optionaler: Enthält die empfohlenen Komponenten für alle installierten Workloads, aber nicht die optionalen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --addangegeben.
--includeOptional	Optional: Enthält die empfohlenen -Komponenten und die optionalen-Komponenten für alle Arbeitslasten, die im Layout enthalten sind. Die Workloads werden mit --addangegeben.
--wait	Optionaler: Der Vorgang wartet, bis die Installation abgeschlossen ist, bevor ein Ausgangscode zurückgegeben wird. wait ist nützlich beim Automatisieren von Installationen, wenn man darauf warten muss, dass diese abgeschlossen sind, um den Rückgabecode zu verarbeiten. Der parameter --wait kann nur an den Bootstrapper übergeben werden; das Installationsprogramm (setup.exe) unterstützt es nicht. Es ist nützlich, wenn Layouts aktualisiert werden. Weitere Beispiele finden Sie hier.
--useLatestInstaller	Optional: Legacyfunktionen, die nur für Visual Studio-Bootstrapper gelten, die älter als April 2023 sind Alles, was nach April 2023 ausgeliefert wurde, verwendet standardmäßig das neueste Installationsprogramm. Wenn dieser Parameter vorhanden ist, ist die neueste Version des Visual Studio Installer in Ihrem Layout enthalten, auch wenn er zu einer neueren Hauptversion des Produkts gehört. Das neueste Installationsprogramm kann nützlich sein, wenn Sie neue Features oder Bugfixes nutzen möchten, die in der neuesten Version verfügbar sind. Weitere Informationen finden Sie unter Konfigurieren des Layouts, um immer das neueste Installationsprogramm Dokumentation zu verwenden.
--config <path to *.vsconfig file>	Optional: Falls vorhanden, verwendet Visual Studio den Inhalt der Konfigurationsdatei, um das Layout zu konfigurieren. Stellen Sie sicher, dass Sie den vollqualifizierten Pfad zur Konfigurationsdatei angeben.
--noWeb	Optional: Das Visual Studio-Setup verwendet ggf. die Dateien in Ihrem Layoutverzeichnis, um Visual Studio zu installieren, und es werden keine Pakete aus dem Web heruntergeladen. Wenn ein Benutzer versucht, Komponenten zu installieren, die sich nicht im Layout befinden, schlägt das Setup fehl. Verwenden Sie diesen Parameter nicht, wenn Sie versuchen, ein layout bereitzustellen, das auf einer internen Intranetwebsite gehostet wird. Weitere Informationen finden Sie unter Installation auf einem Client, der keinen Internetzugang hat. Wichtig: Der parameter --noWeb verhindert nicht, dass der Visual Studio Installer auf einem mit dem Internet verbundenen Clientcomputer nach Updates sucht, wenn der Client so konfiguriert ist, dass er auf von Microsoft gehosteten Servern nach Updates sucht. In diesem Fall verhindert --noWeb einfach, dass der Client die Produktpakete herunter lädt.
--verify	Optional: Überprüfen Sie die Inhalte eines Layouts. Alle beschädigten oder fehlenden Dateien werden aufgelistet.
--fix	Optional: Überprüft den Inhalt eines Layouts. Wenn Dateien beschädigt oder fehlen, werden sie erneut heruntergeladen. Internetzugriff ist erforderlich, um ein Layout zu beheben.
--clean <one or more paths to catalogs>	Optionaler: Entfernt alte Versionen von Komponenten aus einem Layout, das auf eine neuere Version aktualisiert wird.

Erweiterte Layoutparameter	Beschreibung
--channelId <id>	Optional: Die ID des Kanals für die Instanz, die installiert wird. Dargestellt wie VisualStudio.17.Release channelId ist für den Installationsbefehl erforderlich und wird für andere Befehle ignoriert, wenn --installPath angegeben ist. Siehe Syntaxbeispiele für --channelId.
--channelUri <uri>	Optional: Der URI des Kanalmanifests. Dieser Wert steuert den Quellspeicherort der Updates und der Anfangswert wird in der response.json-Datei des Layouts konfiguriert. Mögliche Werte finden Sie in den Syntaxbeispielen zu --channelUri. Wenn Keine Aktualisierungen gewünscht werden, kann --channelUri auf eine nicht vorhandene Datei verweisen (z. B. "-channelUri C:\doesntExist.chman"). Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
--installChannelUri <uri>	Optional: Der URI des Kanalmanifests, der für die Installation verwendet werden soll. Der durch --channelUri angegebene URI (der anzugeben ist, wenn --installChannelUri angegeben wird) dient dazu, Updates zu erkennen. Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
--installCatalogUri <uri>	Optional: Der URI des Katalogmanifests, der für die Installation verwendet werden soll. Wenn angegeben, versucht der Kanal-Manager, das Katalogmanifest aus diesem URI herunterzuladen, bevor der URI im Installationskanalmanifest verwendet wird. Dieser Parameter wird verwendet, um die Offlineinstallation zu unterstützen, bei der der Layoutcache mit dem bereits heruntergeladenen Produktkatalog erstellt wird. Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
--productId <id>	Optionaler: Die ID des Produkts für die installierte Instanz Dieser Parameter ist in normalen Installationsbedingungen vorinstalliert. Die productID ist etwa "Microsoft.VisualStudio.Product.Enterprise".
--arch all	Optional: Standardmäßig werden Layouts nur mit x64-Produktbinärdateien erstellt Um ARM-Binärdateien für anwendbare Workloads zusammen mit den x64-Binärdateien in ein Layout einzuschließen, verwenden Sie den parameter --arch all oder --arch *. Um ein Layout von nur ARM-Binärdateien zu erstellen, verwenden Sie --arch arm64
--keepLayoutVersion	Optionaler: Änderungen auf das Layout anwenden, ohne die im Layout enthaltene Produktversion zu aktualisieren.
--locale <language-locale>	Optional: Ändert die Anzeigesprache der Benutzeroberfläche für den Installer selbst. Die Einstellung wird beibehalten. Weitere Informationen finden Sie im Abschnitt Liste der Gebietsschemas dieser Seite.
--cache	Optional: Vorhandene Pakete werden ggf. nach ihrer Installation für nachfolgende Reparaturen gespeichert. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie besteht darin, Pakete zwischenzuspeichern. Dies wird für den Deinstallationsbefehl ignoriert. Weitere Informationen finden Sie unter Deaktivieren oder Verschieben des Paketcaches.
--nocache	Optional: Wenn vorhanden, werden Pakete entweder nach der Installation oder Reparatur gelöscht. Sie werden nur bei Bedarf erneut heruntergeladen und nach der Verwendung erneut gelöscht. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie besteht darin, Pakete zwischenzuspeichern. Dies wird für den Deinstallationsbefehl ignoriert. Weitere Informationen finden Sie unter Deaktivieren oder Verschieben des Paketcaches.
--noUpdateInstaller	Optional: Hindert den Installer ggf. daran, sich bei Angabe von „quiet“ selbst zu aktualisieren. Der Befehl wird für den Installer einen Fehler auslösen, und der Installer gibt einen Exitcode ungleich 0 (null) zurück, falls „noUpdateInstaller“ mit „quiet“ angegeben wird, wenn ein Installerupdate erforderlich ist.
--path <name>=<path>	Optional: Wird zur Angabe der Standardinstallationspfade für die Installation verwendet. Unterstützte Pfadnamen lauten: „shared“, „cache“ und „install“.
--path cache=<path>	Optional: Verwendet den Speicherort, den Sie beim Herunterladen der Installationsdateien angeben Dieser Speicherort kann nur beim ersten Installieren von Visual Studio festgelegt werden. Beispiel: --path cache="C:\VS\cache"
--path shared=<path>	Optional: Enthält freigegebene Dateien für parallele Visual Studio-Installationen Einige Tools und SDKs werden an einem Speicherort auf diesem Laufwerk installiert, während andere diese Einstellung überschreiben und auf einem anderen Laufwerk installieren können. Beispiel: --path shared="C:\VS\shared" Wichtig: Dies kann nur einmal und bei der ersten Installation von Visual Studio festgelegt werden.
--path install=<path>	Optionaler: Entspricht –-installPath. Insbesondere sind --installPath "C:\VS" und --path install="C:\VS" gleichwertig. Es kann jeweils nur einer dieser Befehle verwendet werden.

ModifySettings-Befehl und Parameter der Befehlszeile

Sie können die Updateeinstellungen ändern und den Quellspeicherort von Updates für eine bestimmte Instanz von Visual Studio programmgesteuert konfigurieren, indem Sie entweder das Installationsprogramm oder den Bootstrapper auf dem Clientcomputer verwenden und den Befehl modifySettings und den gewünschten Updatekanal übergeben.

Befehl	Beschreibung
modifySettings	Verb, das zum Ändern der Aktualisierungseinstellungen einer bestimmten Instanz von Visual Studio verwendet wird.

modifySettings-Parameter	Beschreibung
--installPath <dir>	Empfohlen, um anzugeben, mit welcher Instanz von Visual Studio agiert werden soll
--newChannelUri	Erforderlich: Der URI des Kanalmanifests. Dieser Wert gibt an, wo sich der nächste Quellspeicherort von Updates befindet. Siehe Syntaxbeispiele für von --channelUri für mögliche Werte. Wenn Keine Aktualisierungen gewünscht werden, kann --channelUri auf eine nicht vorhandene Datei verweisen (z. B. "-channelUri C:\doesntExist.chman").
--channelUri	Der URI des alten Kanalmanifests Kann verwendet werden, wenn der --installPath nicht bekannt ist. Muss in Verbindung mit productID verwendet werden, um die richtige Instanz zu identifizieren, auf die zu reagieren ist.
--productId <id>	Muss verwendet werden, wenn --channelUri angegeben ist und verwendet wird, um die richtige Instanz zu identifizieren, auf die zu reagieren ist. Die productID ist etwa "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	Optional: Während eines modifySettings-Befehls weist dieser Parameter (der das Wort „true“ oder „false“ unmittelbar danach haben muss) den Visual Studio-Installer an, die Funktionalität „Empfohlene Komponenten für installierte Workloads bei Update hinzufügen“ im Dialogfeld „Updateeinstellung“ zu deaktivieren.
--quiet	Optionaler: Dieser Parameter verhindert, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzende verfügbar.
--removeOos true	Optional: Im Rahmen eines modifySettings-Befehls weist dieser Parameter (der unmittelbar danach das Wort „true“ oder „false“ aufweisen muss) den Visual Studio-Installer an, alle installierten Komponenten endgültig zu entfernen (oder nicht zu entfernen), die in einen Zustand nach dem Supportende übergehen. Nützlich, um die Sicherheit des Computers zu gewährleisten.

Syntaxbeispiele:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Rollback-Befehl und Befehlszeilenparameter

Ab Visual Studio 2022 können Sie ein Update programmgesteuert zurücksetzen, indem Sie das Installationsprogramm auf dem Clientcomputer verwenden und den Rollbackbefehl zusammen mit der Installationspfadinstanz übergeben.

Befehl	Beschreibung
rollback	Befehl zum Zurücksetzen einer bestimmten Instanz von Visual Studio auf das zuvor installierte Update. Dieser Befehl funktioniert nicht, wenn die DisableRollback aktiviert ist.

Rollbackparameter	Beschreibung
--installPath <dir>	Empfohlen, um anzugeben, mit welcher Instanz von Visual Studio agiert werden soll

Syntaxbeispiele:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Befehl zur Administratoraktualisierung und zugehörige Befehlszeilenparameter

Sie können ein Administratorupdate aus dem Microsoft Update-Katalog herunterladen und verwenden, um entweder Ihre Clientinstallation oder Ihr Layout zu aktualisieren.

Aktualisieren eines Layouts

Wenn Sie ein Layout auf eine bestimmte Version von Visual Studio aktualisieren, laden Sie einfach das Administratorupdate auf den Computer herunter, auf dem das Layout gehostet wird, öffnen Sie eine Eingabeaufforderung auf diesem Computer, und führen Sie einen Befehl wie folgt aus:

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

Aktualisieren eines Clients

Wenn Sie das Administratorupdate in Ihr Installationsverzeichnis auf Ihrem Clientcomputer herunterladen, können Sie einfach auf die Datei doppelklicken, um das Update anzuwenden. Sie können auch ein Befehlsfenster öffnen und einige der folgenden Parameter übergeben, um das Standardverhalten zu ändern.

Konfigurieren des Administratorupdates in SCCM

Wenn Sie das Administratorupdate über Microsoft Endpoint Manager (SCCM) bereitstellen, können Sie das Paket ändern, um das Verhalten mithilfe der folgenden Parameter anzupassen. Sie können die Parameter auch über eine Konfigurationsdatei auf dem Clientcomputer steuern. Weitere Informationen finden Sie unter Methoden zum Konfigurieren eines Administratorupdates

Beachten Sie, dass alle Parameter für Administratorupdates standardmäßig im „Updatekontext“ ausgeführt werden, es sei denn, das Layoutverb wird angegeben.

Administratoraktualisierungsparameter	Beschreibung
--installerUpdateArgs [optional parameters]	Dieser Parameter fungiert als "Pass-Through-Array" bestimmter Parameter, die für Administratoraktualisierungsszenarien relevant sind. Optionale Parameter, die für diesen Zweck aktiviert sind, sind: --quiet: Dies ist die Standardoberfläche für Administratorupdates und wird hier zur Vollständigkeit aufgeführt. --passive: Dieser Parameter überschreibt den --quiet-Parameter. Dadurch wird die Benutzeroberfläche nicht interaktiv angezeigt. --norestart: Dieser Parameter muss in Verbindung mit --quiet oder --passive verwendet werden und bewirkt, dass alle erforderlichen Neustarts verzögert werden. --noWeb: Dieser Parameter verhindert, dass Visual Studio im Internet nach Updates für das Produkt sucht. --force: Dieser Parameter erzwingt, dass Visual Studio geschlossen wird, auch wenn Visual Studio verwendet wird. Verwenden Sie diesen Parameter mit Vorsicht, da er zu Arbeitsverlusten führen kann. Dieser Parameter darf nur verwendet werden, wenn die Administratoraktualisierung im Benutzerkontext ausgeführt wird. sie wird ignoriert, wenn das Administratorupdate im Systemkontext ausgeführt wird. --installWhileDownloading: Mit diesem Parameter kann Visual Studio das Produkt parallel herunterladen und installieren. Dies ist die Standardumgebung für Administratorupdates und wird hier zur Vollständigkeit aufgeführt. --keepWindowsUpdateOn: Dieser Parameter verhindert, dass der Installationsprogramm den Windows Update-Agent auf dem Client deaktiviert. Sie sollten diesen Parameter verwenden, wenn Sie ein Administratorupdate aus dem Katalog in SCCM importieren. Möglicherweise müssen Sie auch festlegen, dass das SCCM-Paket-Timeout länger als die Standard 10 Minuten ist. Das Ändern des SCCM-Bereitstellungstyps als erforderlich macht diesen Parameter unnötig. --downloadThenInstall: Dieser Parameter zwingt Visual Studio, alle Dateien herunterzuladen, bevor sie installiert werden. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus.
--checkPendingReboot	Das Update wird abgebrochen, wenn ein ausstehender Neustart auf dem Computer vorhanden ist, unabhängig davon, welche Anwendung dies verursacht hat. Standardmäßig wird nicht auf ausstehende Neustarts überprüft.

Syntaxbeispiel zum Übergeben von Parametern an ein Administratorupdate:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Entfernen Sie Kanalbefehls- und Befehlszeilenparameter

Kanäle, die zum Aktualisieren zur Verfügung stehen, werden auf dem Client zwischengespeichert und können mit der Zeit Unordnung verursachen. Sie können Update-Kanäle manuell entfernen, indem Sie den Visual Studio-Installer aufrufen, zur Registerkarte Verfügbar wechseln und in der oberen rechten Ecke der Produktkarte auf das X klicken. Sie können Kanäle programmgesteuert entfernen (z. B. ältere Layoutpositionen), indem Sie den Befehl removeChannel verwenden. Sie können vswhere programmgesteuert auf dem Clientcomputer ausführen, um zu bestimmen, welche Kanäle auf dem Clientcomputer zwischengespeichert werden.

Befehl	Beschreibung
removeChannel	Befehl zum Entfernen eines Kanals vom Clientcomputer.

removeChannel-Parameter	Beschreibung
--channelUri	Erforderlich: Der URI des alten Kanalmanifests
--quiet	Optional Dieser Parameter verhindert, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird.
--passive	Optional Dieser Parameter überschreibt den --quiet-Parameter. Dadurch wird die Benutzeroberfläche nicht interaktiv angezeigt.

Syntaxbeispiel:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Verwenden von Winget zum Installieren oder Ändern von Visual Studio

Sie können das Windows-Paket-Manager "winget"-Tool verwenden, um Visual Studio programmgesteuert auf Ihrem Computer zusammen mit anderen Paketen zu installieren, zu ändern oder zu aktualisieren, die von winget verwaltet werden.

Standardmäßig installiert winget einfach die Visual Studio-Kernarbeitsauslastung.

winget install --id Microsoft.VisualStudio.2022.Community

Wenn Sie die Installation jedoch anpassen und zusätzliche Workloads und Komponenten angeben möchten, die während der Erstinstallation abgerufen werden sollen, können Sie den --override Switch von winget neben dem befehl install winget verwenden und eine exportierten vsconfig-Datei übergeben, die die Workloads und Komponenten enthält, um Folgendes hinzuzufügen:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

Natürlich können Sie komponenten direkt während der Erstinstallation wie folgt einschließen:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Wenn Sie Visual Studio bereits auf Ihrem Computer installiert haben, können Sie Winget-Befehl configure zusammen mit dem Visual Studio PowerShell DSC-Anbieter, einer Yaml-Datei und einer VSCONFIG-Datei verwenden, um Komponenten zu einer vorhandenen Visual Studio-Installation hinzuzufügen. Der configure-Befehl von winget fungiert im Wesentlichen als „Änderungsvorgang“ von Visual Studio. Weitere Informationen zum Erstellen einer WinGet-Konfigurationsdatei finden Sie unter Erstellen einer WinGet-Konfigurationsdatei.

Es ist nicht möglich, den --override Switch oder den Visual Studio DSC-Anbieter neben dem upgrade Befehl von Winget zu verwenden, da upgrade im Wesentlichen nur als Visual Studio-Vorgang "Update" fungiert und die neueste Version von Komponenten installiert, die Sie bereits ausgewählt haben. Sie können keine Komponenten über ein Update/Upgrade hinzufügen. Sie müssen die configure von winget verwenden, um Komponenten hinzuzufügen.

Beachten Sie, dass Visual Studio Installer-Vorgänge derzeit Administratorrechte erfordern. Daher werden Sie vom Winget aufgefordert, Ihre Berechtigungen bei Bedarf zu erhöhen, um den Befehl abzuschließen. Außerdem ist es derzeit nicht möglich, winget zum Installieren mehrerer Editionen (d. h. verschiedener SKUs) oder mehrerer Instanzen derselben SKU gleichzeitig auf einem Clientcomputer zu verwenden. Schließlich muss Visual Studio geschlossen werden, wenn Sie es so konfigurieren (ändern) möchten, dass Komponenten hinzugefügt werden oder auf die neueste Version aktualisiert werden.

Liste der Workload-IDs und Komponenten-IDs

Eine Liste der Workload- und Komponenten-IDs, die nach Visual Studio-Produkten sortiert sind, finden Sie auf der Seite Visual Studio-Workload- und Komponenten-IDs.

Liste der Sprachregionen

Gebietsschema	Sprache
cs-CZ	Tschechisch
De-de	Deutsch
en-US	Englisch
Es-es	Spanisch
fr-FR	Französisch
it-IT	Italienisch
Ja-jp	Japanisch
Ko-kr	Koreanisch
pl-PL	Polnisch
pt-BR	Portugiesisch - Brasilien
Ru-ru	Russisch
tr-TR	Türkisch
zh-CN	Chinesisch - vereinfacht
zh-TW	Chinesisch - traditionell

Fehlercodes

Abhängig vom Ergebnis des Vorgangs wird 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	Ein weiterer Installationsvorgang läuft
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 Systemanforderungen
-1073720687	Konnektivitätsfehler
-1073741510	Microsoft Visual Studio Installer wurde beendet (vom Benutzer oder externen Prozess)
Andere (Beispiel: -1, 1, 1603)	Ein Fehlerzustand ist aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen.

Jeder Vorgang generiert mehrere Protokolldateien im %TEMP% Verzeichnis, die den Fortschritt der Installation angeben. Sortieren Sie den Ordner nach Datum, und suchen Sie nach Dateien, die mit dd_bootstrapper, dd_clientund dd_setup für den Bootstrapper, die Installationsprogramm-App bzw. das Setupmodul beginnen.

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

• Befehlszeilenparameterbeispiele für visual Studio-Installation
• Erstellen einer Offlineinstallation von Visual Studio
• Automatisieren der Visual Studio-Installation mit einer Antwortdatei
• Visual Studio-Arbeitsauslastung und Komponenten-IDs