Verwenden von Befehlszeilenparametern zum Installieren, Aktualisieren und Verwalten von Visual Studio
Wenn Sie Visual Studio programmgesteuert oder über eine Eingabeaufforderung installieren, können Sie mithilfe verschiedener Befehlszeilenparametern die Installation für folgende Aktionen steuern und anpassen:
- Starten der Installation auf dem Client mit bestimmten, vorab ausgewählten Optionen und Verhaltensweisen
- Automatisieren des Installations- oder Updateprozesses.
- 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.
- Mit dem 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 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-Switch „--override“ verwendet.
- Mit einem Administratorupdatepaket, das aus dem Microsoft Update-Katalog heruntergeladen 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. Außerdem kann es vorkommen, dass Sie in manchen Szenarien nicht auf alle der zuvor beschriebenen ausführbaren Dateien Zugriff haben. Beispielsweise ist auf Clientcomputern möglicherweise nur das Installationsprogramm für programmgesteuerte Ausführung verfügbar, wenn Visual Studio über ein Layout installiert wurde.
Sie können die Visual Studio 2019-Bootstrapper aus der folgenden Tabelle abrufen. Wenn Sie eine bestimmte Version von Visual Studio 2019 wünschen, können Sie alternativ die Seite Visual Studio 2019 Releases aufrufen. Diese Seite enthält Links zu den Bootstrappern der festen Version für die von Ihnen gewählte Version und Edition von Visual Studio.
| Edition | Bootstrapper |
|---|---|
| Visual Studio 2019 Enterprise, Version 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional, Version 16.11 | vs_professional.exe |
| Visual Studio 2019 Build Tools, Version 16.11 | vs_buildtools.exe |
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 eine bestimmte Version oder einen bestimmten Kanal von Visual Studio 2022 installieren möchten, können Sie auch die Seite Visual Studio 2022 Release History aufrufen. Diese Seite enthält Links zu den Bootstrappern der festen Versionen für jede Wartungsversion.
| 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 Bootstrapperdatei heruntergeladen haben und deren Version überprüfen möchten, 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, wählen Sie die Registerkarte Details aus, und sehen Sie sich dann die Nummer der Produktversion an. Informationen dazu, wie Sie diese Nummer mit einem Release von Visual Studio abgleichen, finden Sie in der Tabelle am unteren Rand der Seite mit den Visual Studio 2019-Releases.
Tipp
Wenn Sie zuvor eine Bootstrapper-Datei heruntergeladen haben und nun überprüfen möchten, welche Version heruntergeladen wird, erfahren Sie es hier. Öffnen Sie in Windows den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapper-Datei, wählen Sie Eigenschaften aus, um dann auf der Registerkarte Details auszuwählen. Das Feld Produktversion beschreibt Kanal und Version, welche der Bootstrapper installieren wird. Die Versionsnummer sollte immer als „neueste Wartungsversion des angegebenen Werts“ gelesen werden, und der Kanal ist Aktuell, sofern nicht explizit angegeben. Daher installiert ein Bootstrapper mit der Produktversion LTSC 17.0 die neueste 17.0.x-Wartungsversion, die im LTSC-Kanal 17.0 verfügbar ist. Ein Bootstrapper mit einer Produktversion, die einfach Visual Studio 2022 besagt, installiert die neueste Version von Visual Studio 2022 auf dem aktuellen Kanal.
Befehle und Befehlszeilenparameter zum Installieren, Aktualisieren, Ändern, Reparieren, Deinstallieren und Exportieren
Wenn Sie den Visual Studio Bootstrapper oder das Installationsprogramm programmatisch aufrufen, um das Produkt zu installieren oder ein Layout zu pflegen:
- Der erste Parameter ist der Befehl (das Verb), der den auszuführenden Vorgang beschreibt.
- Die nachfolgenden optionalen Befehlszeilenparameter, denen jeweils zwei Bindestriche (--) vorangestellt sind, legen fest, wie der Vorgang ablaufen soll.
Bei allen Visual Studio-Befehlszeilenparametern wird die Groß-/Kleinschreibung nicht beachtet. Weitere Beispiele finden Sie auf der Seite Beispiele für Befehlszeilenparameter für die Installation von Visual Studio.
Syntaxbeispiel: vs_enterprise.exe [command] <optional parameters>...
| Befehl | Beschreibung |
|---|---|
| (leer) | Der Standardbefehl installiert das Produkt und wird für alle Vorgänge zur Layoutverwaltung verwendet. |
modify |
Ändert ein installiertes Produkt. |
update |
Aktualisiert ein installiertes Produkt. |
updateall |
Aktualisiert der Reihe nach alle installierten Produkte. Funktioniert mit den Parametern --quiet und --passive. |
repair |
Repariert ein installiertes Produkt. |
uninstall |
Deinstalliert ein installiertes Produkt. |
export |
Exportiert die Installationskonfiguration in eine Datei *.vsconfig. |
Wichtig
Wenn Sie mehrere Workloads, Komponenten oder Sprachen angeben möchten, müssen Sie den Befehlszeilenswitch --add oder --remove für jedes Element wiederholen.
| Parameter | Beschreibung |
|---|---|
--installPath <dir> |
Für den Standard-Installationsbefehl lautet dieser Parameter Optional und beschreibt, wo die Instanz auf dem Client-Rechner installiert wird. Für andere Befehle wie „update“ oder „modify“ ist dieser Parameter erforderlich. Er gibt das Installationsverzeichnis für die Instanz an, für die der Befehl ausgeführt wird. |
--productId <id> |
Optional: Die ID der Produktinstanz, die geändert wird, und die mit --channelId verwendet wird. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten. |
--channelUri |
Optional: Während eines Aktualisierungsbefehls können Sie eine neue --channelUri eingeben, um den Speicherort der Aktualisierungseinstellungen zu ändern. Es wird empfohlen, den Parameter --installPath zu verwenden, damit klar ist, 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 von --channelId. channelId ist für Änderungsvorgänge erforderlich, zusammen mit --productID oder --installPath. |
--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, die empfohlenen oder optionalen Komponenten jedoch nicht. Mit den Parametern --includeRecommended und/oder --includeOptional können Sie andere Komponenten global steuern. Wiederholen Sie den --add-Befehl, um mehrere Workloads oder Komponenten einzuschließen (z.B. --add Workload1 --add Workload2). Für eine umfassendere 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 and component IDs (Arbeitsauslastungs- und Komponenten-IDs). |
--all |
Optional: Während eines install- oder modify-Befehls installiert dieser Parameter alle Workloads und Komponenten für das Produkt. |
--allWorkloads |
Optional: Während eines install- oder modify-Befehls installiert dieser Parameter alle Workloads und Komponenten. Dies gilt jedoch nicht für empfohlene oder optionale Komponenten. |
--includeRecommended |
Optional: Während eines Installations- oder Änderungsbefehls enthält dieser Parameter die empfohlenen Komponenten für alle Workloads, die installiert werden. Die optionalen Komponenten sind darin nicht enthalten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben. Bitte beachten Sie, dass Sie mit dem Parameter --includeRecommended das Dialogfeld „Einstellungen aktualisieren“ aktivieren, um „empfohlene Komponenten für installierte Workloads auf dem Update hinzuzufügen“. Informationen zum Ändern dieser Einstellung finden Sie unter Anpassen der Update-Einstellungen. |
--includeOptional |
Optional: Bei einem Installations- oder Änderungsbefehl 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 --add angegeben. |
--addProductLang <language-locale> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter die Sprachpakete für die Benutzeroberfläche an, die mit dem Produkt installiert werden sollen. Wird der Parameter nicht angegeben, wird bei der Installation das Sprachpaket verwendet, das dem Gebietsschema des Computers entspricht. Weitere Informationen finden Sie in der [Liste der Sprachumgebungen] |
--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. Er ergänzt den Parameter --add und verhält sich ähnlich wie dieser. |
| (#list-of-language-locales) auf dieser Seite. | |
--removeProductLang <language-locale> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter die Sprachpakete für die Benutzeroberfläche an, die aus dem Produkt entfernt werden sollen. Er ergänzt den Parameter --addProductLang und verhält sich ähnlich wie dieser. |
--in <path> |
Optional: Der URI oder Pfad zu einer Antwortdatei, die möglicherweise Konfigurationseinstellungen enthält. |
--quiet |
Optional: Dieser Parameter bewirkt bei jedem Befehl, dass während der Ausführung des Befehls keine Benutzeroberfläche angezeigt wird. Nicht verfügbar für die programmatische Verwendung durch Standardbenutzer, unabhängig davon, wie die Richtlinie AllowStandardUserControl eingestellt ist. |
--passive, -p |
Optional: Dieser Parameter bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. Dieser Parameter und der Parameter --quiet schließen sich gegenseitig aus (der Parameter „--quiet“ wird vom Parameter „--passive“ sogar überschreiben). Auch nicht für die programmatische Verwendung durch Standardbenutzer verfügbar, unabhängig davon, wie die Richtlinie AllowStandardUserControl eingestellt ist. |
--norestart |
Optional: Dieser Parameter muss mit dem Parameter --passive oder --quiet gekoppelt werden. Während eines install-, update- oder modify-Befehls verzögert das Hinzufügen des Parameters --norestart alle erforderlichen Neustarts. |
--force |
Optional: Mit diesem Parameter wird das Schließen von Visual Studio erzwungen. Dies gilt selbst dann, wenn Visual Studio-Prozesse noch verwendet werden. Wenn Sie das Schließen von Visual Studio erzwingen, kann es zum Verlust von Arbeit kommen. Verwenden Sie diese Möglichkeit also mit Vorsicht. |
--installWhileDownloading |
Optional: Während eines install-, update- oder modify-Befehls ermöglicht dieser Parameter, dass das Produkt von Visual Studio gleichzeitig heruntergeladen und installiert wird. Dies ist der Standardwert. |
--downloadThenInstall |
Optional: Während eines install-, update- oder modify-Befehls erzwingt dieser Parameter, dass Visual Studio alle Dateien vor der Installation herunterlädt. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus. |
--nickname <name> |
Optional: Während eines install-Befehls definiert dieser Parameter den Spitznamen, der einem installierten Produkt zugewiesen werden soll. Der Spitzname darf nicht länger als 10 Zeichen sein. |
--productKey |
Optional: Während eines install-Befehls definiert dieser Parameter den Product Key, der für ein installiertes Produkt verwendet werden soll. Der Produktschlüssel besteht aus 25 alphanumerischen Zeichen im Format xxxxxxxxxxxxxxxxxxxxxxxxx. |
--removeOos true |
Optional: Während eines Installations-, Aktualisierungs- oder Änderungsbefehls teilt dieser Parameter, gefolgt von true oder false, dem Visual Studio Installer mit, ob alle installierten Komponenten entfernt werden sollen, die in einen nicht mehr unterstützten Status übergegangen sind. Dieses Verhalten gilt für ein einzelnes Ereignis. Wenn Sie dieses Verhalten beibehalten möchten, wenden Sie diesen Parameter auf den Befehl modifySettings an, der später beschrieben wird, oder konfigurieren Sie die globale Richtlinie removeOOS. 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 mit dem Parameter --config eine Konfigurationsdatei übergeben, um die hinzuzufügenden Workloads, Komponenten oder Erweiterungen auf der Grundlage einer zuvor gespeicherten Installationskonfigurationsdatei anzugeben. Dieser Vorgang ist nur additiv; es wird nichts entfernt, was nicht in der Datei angegeben ist. Außerdem werden in der Konfigurationsdatei angegebene Elemente, die nicht auf das Produkt zutreffen, nicht hinzugefügt. Es wird dringend empfohlen, den vollständig qualifizierten Pfad zur Konfigurationsdatei anzugeben. Bei einem Exportvorgang bestimmt dieser Parameter den Speicherort der Installationskonfigurationsdatei. |
--allowUnsignedExtensions |
Optional: Wenn bei einem Installations- oder Änderungsvorgang in einem --passive- oder --quiet-Kontext unter Verwendung einer --config-Datei Erweiterungen in der Konfigurationsdatei angegeben sind, ist dieser Parameter erforderlich, um Erweiterungen ohne digitale Signatur zu laden. |
--installerOnly |
Optional: Während eines Installations- oder Aktualisierungsvorgangs weist dieser Parameter den Visual Studio Installer an, nur sich selbst (den Installer) 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, -? |
Es wird eine Offlineversion dieser Seite angezeigt. |
Layoutbefehle und Befehlszeilenparameter
Alle Layout-Verwaltungsvorgänge, wie z. B. das Erstellen oder Aktualisieren eines Layouts, werden mit der Bootstrapper-Exe ausgeführt, wobei davon ausgegangen wird, dass es sich bei dem Befehl um den Standardbefehl Install (blank) handelt. Alle Vorgänge der Layout-Verwaltung sollten mit dem erforderlichen Startparameter --layout beginnen. In der folgenden Tabelle werden die anderen Parameter beschrieben, die Sie verwenden können, um ein Layout über die Befehlszeile zu erstellen oder zu aktualisieren.
| Layoutparameter | Beschreibung |
|---|---|
--layout <dir> |
Gibt ein Verzeichnis an, in dem ein Offlineinstallationscache erstellt oder aktualisiert werden soll. Weitere Informationen finden Sie unter Erstellen einer Netzwerkinstallation von Visual Studio 2017. |
--lang <one or more language-locales> |
Optional: Wird zusammen mit --layout verwendet, um einen Offline-Installationscache mit Ressourcenpaketen mit der angegebenen Sprache oder mehreren 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, die empfohlenen oder optionalen Komponenten jedoch nicht. Mit --includeRecommended und/oder --includeOptional können Sie weitere Komponenten global steuern. Für eine umfassendere 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 Workload and component IDs (Arbeitsauslastungs- und Komponenten-IDs). Hinweis: Bei Verwenden von --add werden nur die angegebenen Workloads und Komponenten sowie deren Abhängigkeiten heruntergeladen. Wenn --add nicht angegeben ist, werden alle Workloads und Komponenten in das Layout heruntergeladen. |
--includeRecommended |
Optional: Enthält die empfohlenen Komponenten für alle zu installierenden Arbeitsauslastungen, aber keine optionalen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben. |
--includeOptional |
Optional: Schließt die empfohlenen und optionalen Komponenten für alle Workloads in das Layout ein. Die Workloads werden mit --add angegeben. |
--wait |
Optional: Der Prozess wartet, bis die Installation abgeschlossen ist, bevor er einen Exitcode zurückgibt. wait ist nützlich bei der Automatisierung von Installationen, bei denen man warten muss, bis die Installation beendet ist, um den Rückgabewert der Installation zu verarbeiten. Der Parameter --wait kann nur an den Bootstrapper übergeben werden; das Installationsprogramm (setup.exe) unterstützt ihn nicht. Er ist nützlich bei der Aktualisierung von Layouts. Weitere Beispiele finden Sie hier. |
--useLatestInstaller |
Optional: Legacyfunktionen, die nur für Visual Studio-Bootstrapper gelten, die älter als April 2023 sind. Alle Bootstrapper, die nach April 2023 ausgeliefert wurden, verwenden standardmäßig das neueste Installationsprogramm. Wenn dieser Parameter vorhanden ist, ist die aktuellste Version des Visual Studio-Installers in Ihrem Layout enthalten, auch wenn sie zu einer neueren Hauptversion des Produkts gehört. Das neueste Installationsprogramm kann nützlich sein, wenn Sie die Vorteile neuer Funktionen oder Fehlerbehebungen nutzen möchten, die in der neuesten Version verfügbar sind. Weitere Informationen finden Sie in der Dokumentation zum Konfigurieren des Layouts zur stetigen Verwendung des neuesten Installationsprogramms. |
--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 nicht im Layout enthalten sind, wird das Setup nicht abgeschlossen. Verwenden Sie diesen Parameter nicht, wenn Sie ein Layout bereitstellen möchten, das auf einer internen Intranetwebsite gehostet wird. Weitere Informationen finden Sie unter Installation auf einem Client ohne Internetzugriff. Wichtig: Der Parameter --noWeb hält der Visual Studio-Installer auf einem mit dem Internet verbundenen Clientcomputer nicht davon ab, nach Updates zu suchen, wenn der Client dazu konfiguriert wurde, auf von Microsoft gehosteten Servern nach Updates zu suchen. In diesem Fall wird von --noWeb einfach verhindert, dass der Client die Produktpakete herunterlädt. |
--verify |
Optional: Überprüft den Inhalt eines Layouts. Beschädigte oder fehlende Dateien werden aufgelistet. |
--fix |
Optional: Überprüft den Inhalt eines Layouts. Wenn Dateien beschädigt sein oder fehlen sollten, werden sie erneut heruntergeladen. Für die Korrektur eines Layout ist ein Internetzugriff erforderlich. |
--clean <one or more paths to catalogs> |
Optional: Entfernt alte Versionen von Komponenten aus einem Layout, das auf eine neuere Version aktualisiert wurde. |
| 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. Weitere Informationen finden Sie unter 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 Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei zeigen (z. B. --channelUri C:\doesntExist.chman). Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--installChannelUri <uri> |
Optional: Der URI des Kanalmanifests, der für die Installation verwendet werden soll. Der mit --channelUri festgelegte URI (der angegeben werden muss, wenn --installChannelUri angegeben ist) dient zum Ermitteln von Updates. Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--installCatalogUri <uri> |
Optional: Der URI des Katalogmanifests, der für die Installation verwendet werden soll. Wird diese Option angegeben, versucht der Kanal-Manager, das Katalogmanifest von diesem URI herunterzuladen, bevor der URI im Installationskanalmanifest verwendet wird. Dieser Parameter wird zur Unterstützung der Offline-Installation verwendet, bei der der Layout-Cache mit dem bereits heruntergeladenen Produktkatalog erstellt wird. Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--productId <id> |
Optional: Die ID des Produkts für die zu installierende Instanz. Dieser Parameter ist unter normalen Installationsbedingungen vorausgefüllt. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten. |
--arch all |
Optional: Standardmäßig werden Layouts nur mit x64-Produktbinärdateien erstellt. Zum Einbeziehen von ARM-Binärdateien für anwendbare Workloads neben den x64-Binärdateien in einem Layout verwenden Sie den Parameter --arch all oder --arch *. Verwenden Sie zum Erstellen eines Layouts nur aus ARM-Binärdateien --arch arm64. |
--keepLayoutVersion |
Optional: Wenden Sie Änderungen auf das Layout an, ohne die darin 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 sieht das Zwischenspeichern von Paketen im Cache vor. Dies wird für den Deinstallationsbefehl ignoriert. Unter Deaktivieren oder Verschieben des Paketcaches finden Sie weitere Informationen. |
--nocache |
Optional: Vorhandene Pakete werden ggf. nach ihrer Installation oder Reparatur gelöscht. Sie werden nur bei Bedarf erneut heruntergeladen und nach ihrer Verwendung wieder gelöscht. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie sieht das Zwischenspeichern von Paketen im Cache vor. Dies wird für den Deinstallationsbefehl ignoriert. Unter Deaktivieren oder Verschieben des Paketcaches finden Sie weitere Informationen. |
--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 bei der ersten Installation 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 einen Speicherort auf diesem Datenträger installiert. Andere überschreiben möglicherweise diese Einstellung und werden auf einen anderen Datenträger installiert. Beispiel: --path shared="C:\VS\shared" Wichtig: Dieser Parameter kann nur einmal, und zwar bei der ersten Installation von Visual Studio, festgelegt werden. |
--path install=<path> |
Optional: Entspricht –-installPath. Besonders --installPath "C:\VS" und --path install="C:\VS" sind gleichwertig. Es kann jeweils nur einer dieser Befehle verwendet werden. |
ModifySettings-Befehl und Befehlszeilenparameter
Sie können die Updateeinstellungen ändern und den Quellspeicherort von Updates für eine bestimmte Instanz von Visual Studio programmgesteuert konfigurieren, indem Sie entweder den Installer oder den Bootstrapper auf dem Clientcomputer verwenden und den modifySettings-Befehl zusammen mit dem gewünschten Updatekanal übergeben.
| Befehl | Beschreibung |
|---|---|
modifySettings |
Verb, das zum Ändern der Updateeinstellungen 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. Mögliche Werte finden Sie in den Syntaxbeispielen zu --channelUri. Wenn keine Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei zeigen (z. B. --channelUri C:\doesntExist.chman). |
--channelUri |
Der URI des alten Kanalmanifests. Kann verwendet werden, wenn --installPath nicht bekannt ist. Muss in Verbindung mit productID verwendet werden, um die richtige Instanz zu identifizieren, mit der agiert werden soll. |
--productId <id> |
Muss verwendet werden, wenn --channelUri angegeben ist und wird verwendet, um die richtige Instanz zu identifizieren, mitder agiert werden soll. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten. |
--includeRecommended |
Optional: Während eines „modifySettings“-Befehl weist dieser Parameter (auf den unmittelbar das Wort „true“ oder „false“ folgt) dem Visual Studio-Installer an, die Funktionalität „Empfohlene Komponenten für installierte Workloads bei Aktualisierung hinzufügen“ im Dialogfeld „Update-Einstellung“ zu deaktivieren. |
--quiet |
Optional: Dieser Parameter verhindert, dass während der Ausführung des Befehls eine Benutzeroberfläche angezeigt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzer*innen verfügbar. |
--removeOos true |
Optional: Im Rahmen eines modifySettings-Befehls weist dieser Parameter (der unmittelbar danach das Wort true oder false aufweisen muss) das Visual Studio-Installationsprogramm 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
Rollbackbefehle und Befehlszeilenparameter
Ab Visual Studio 2022 können Sie einen programmgesteuerten Rollback eines Updates ausführen, indem Sie das Installationsprogramm auf dem Clientcomputer verwenden und den Rollbackbefehl zusammen mit der Installationspfadinstanz übergeben.
| Befehl | Beschreibung |
|---|---|
rollback |
Befehl zum Rollback einer bestimmten Instanz von Visual Studio auf das zuvor installierte Update. Dieser Befehl funktioniert nicht, wenn 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"
Administratorupdatebefehl 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 auf diesem Computer eine Eingabeaufforderung, und führen Sie einen Befehl wie den folgenden aus:
visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout
Aktualisieren eines Clients
Wenn Sie das Administratorupdate in das 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 mit den unten angegebenen Parametern anzupassen. Sie können die Parameter auch über eine Konfigurationsdatei auf dem Clientcomputer verwalten. 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.
| Parameter für Administratorupdates | Beschreibung |
|---|---|
--installerUpdateArgs [optional parameters] |
Dieser Parameter dient als „Passthrough-Array“ bestimmter Parameter, die für Administratorupdateszenarios relevant sind. Folgende optionale Parameter können für diesen Zweck aktiviert werden: --quiet: Standardparameter für Administratorupdates (wird hier aus Gründen der Vollständigkeit aufgeführt). --passive: Überschreibt den Parameter --quiet. Bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. --norestart: Muss in Verbindung mit --quiet oder --passive verwendet werden und bewirkt, dass alle erforderlichen Neustarts verzögert werden. --noWeb: Verhindert, dass Visual Studio im Internet nach Updates für das Produkt sucht. --force: Erzwingt das Schließen von Visual Studio, selbst wenn Visual Studio gerade verwendet wird. Verwenden Sie diesen Parameter mit Vorsicht, da er zu Arbeitsverlusten führen kann. Dieser Parameter darf nur verwendet werden, wenn das Administratorupdate im Benutzerkontext ausgeführt wird. er wird ignoriert, wenn das Administratorupdate im Systemkontext ausgeführt wird. --installWhileDownloading: Ermöglicht, dass das Produkt von Visual Studio gleichzeitig heruntergeladen und installiert wird. Standardparameter für Administratorupdates (wird hier aus Gründen der Vollständigkeit aufgeführt). --keepWindowsUpdateOn: Dieser Parameter verhindert, dass das 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 außerdem das Timeout des SCCM-Pakets auf einen längeren Zeitraum als die Standardzeit von 10 Minuten festlegen. Wenn Sie den SCCM-Bereitstellungstyp in „Erforderlich“ ändern, wird dieser Parameter nicht benötigt.--downloadThenInstall: Erzwingt, dass Visual Studio alle Dateien vor der Installation herunterlädt. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus. |
--checkPendingReboot |
Das Update wird abgebrochen, wenn ein Neustart auf dem Computer aussteht. Dies gilt unabhängig davon, welche Anwendung das Update verursacht hat. Standardmäßig wird nicht nach ausstehenden Neustarts gesucht. |
Syntaxbeispiel für die Übergabe von Parametern an ein Administratorupdate:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
Befehl zum Entfernen von Kanälen und Befehlszeilenparameter
Kanäle, die für Updates zur Verfügung stehen, werden auf dem Client zwischengespeichert und können mit der Zeit das System unübersichtlich machen. 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 (z. B. ältere Layoutspeicherorte) programmgesteuert mit dem Befehl removeChannel entfernen. Sie können vswhere programmgesteuert auf dem Clientcomputer ausführen, um zu ermitteln, 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 während der Ausführung des Befehls eine Benutzeroberfläche angezeigt wird. |
--passive |
Optional Dieser Parameter setzt den Parameter --quiet außer Kraft. Bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. |
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 „winget“-Tool von des Windows-Paket-Managers verwenden, um Visual Studio programmgesteuert auf Ihren Computern zusammen mit anderen Paketen zu installieren, zu ändern oder zu aktualisieren, die von „winget“ verwaltet werden.
Standardmäßig installiert „winget“ einfach die Visual Studio-Kernworkload.
winget install --id Microsoft.VisualStudio.2022.Community
Wenn Sie jedoch die Installation 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 zusammen mit dem Winget-Befehl install verwenden und eine exportierte VSCONFIG-Datei übergeben, die die Workloads und Komponenten enthält, die hinzugefügt werden sollen:
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"
Natürlich können Sie Komponenten auch 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 den configure Befehl von winget zusammen mit den Visual Studio PowerShell DSC-Anbieter einer YAML-Datei und einer VSCONFIG-Datei verwenden, um einer vorhandenen Visual Studio-Installation Komponenten hinzuzufügen. Der configure-Befehl von winget fungiert im Wesentlichen als „Änderungsvorgang“ von Visual Studio. Unter Erstellen einer WinGet-Konfigurationsdatei erfahren Sie, wie Sie eine WinGet-Konfiguration erstellen.
Es ist nicht möglich, den --override-Switch oder den Visual Studio DSC-Anbieter zusammen mit dem upgrade-Befehl von winget zu verwenden, weil upgrade im Wesentlichen nur ein Visual Studio-Updatevorgang fungiert und die neueste Version der Komponenten installiert, die Sie bereits ausgewählt haben. Sie können keine Komponenten über ein Update/Upgrade hinzufügen. Sie müssen configure von winget verwenden, um Komponenten hinzuzufügen.
Beachten Sie, dass der Visual Studio-Installer derzeit Administratorrechte benötigt. winget wird Sie daher auffordern, Ihre Berechtigungen zu erhöhen, wenn dies notwendig sein sollte, um den Befehl auszuführen. Außerdem kann winget derzeit nicht verwendet werden, um mehrere Editionen (d. h. verschiedene SKUs) oder mehrere Instanzen derselben SKU gleichzeitig auf einem Clientcomputer zu installieren. Schließlich muss Visual Studio geschlossen werden, wenn Sie die Anwendung konfigurieren (ändern) möchten, um Komponenten hinzuzufügen oder ein Upgrade auf die neueste Version durchzuführen.
Liste der Arbeitsauslastungs-IDs und Komponenten-IDs
Eine Liste der Arbeitsauslastungs- und Komponenten-IDs, sortiert nach Visual Studio-Produkt, finden Sie auf der Seite Arbeitsauslastungs- und Komponenten-IDs in Visual Studio.
Liste der Gebietsschemas
| 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
Je nach Ergebnis des Vorgangs wird die Umgebungsvariable %ERRORLEVEL% auf einen der folgenden Werte festgelegt:
| Wert | Ergebnis |
|---|---|
| 0 | Der Vorgang wurde erfolgreich abgeschlossen. |
| 740 | Rechteerweiterung erforderlich |
| 1001 | Visual Studio-Installer wird ausgeführt. |
| 1003 | Visual Studio wird verwendet. |
| 1602 | Der Vorgang wurde abgebrochen. |
| 1618 | Eine andere Installation wird ausgeführt. |
| 1641 | Der Vorgang wurde erfolgreich abgeschlossen und ein Neustart wurde eingeleitet. |
| 3010 | Der Vorgang wurde erfolgreich abgeschlossen, für die Installation ist jedoch ein Neustart erforderlich, bevor sie verwendet werden kann. |
| 5003 | Fehler bei Bootstrapper beim Herunterladen des Installers |
| 5004 | Der Vorgang wurde abgebrochen. |
| 5005 | Bootstrapper-Befehlszeilen-Analysefehler |
| 5007 | Der Vorgang wurde blockiert – der Computer entspricht nicht den Anforderungen. |
| 8001 | Fehler bei ARM-Computerüberprüfung |
| 8002 | Fehler bei Vorabprüfung des Hintergrunddownloads |
| 8003 | Fehler wegen nicht mehr unterstützter Auswahl |
| 8004 | Zielverzeichnisfehler |
| 8005 | Fehler beim Überprüfen der Quellnutzlasten |
| 8006 | Visual Studio-Prozesse werden ausgeführt |
| 8010 | Das Betriebssystem wird nicht unterstützt. Verweis auf Systemanforderungen |
| -1073720687 | Konnektivitätsfehler |
| -1073741510 | Microsoft Visual Studio-Installer wurde beendet (durch den Benutzer oder einen externen Prozess) |
| Sonstiges (Beispiel: -1, 1, 1603) |
Es ist ein Fehler aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen |
Jeder Vorgang generiert mehrere Protokolldateien im %TEMP%-Verzeichnis, die den Status der Installation angeben. Sortieren Sie die Ordner nach Datum, und suchen Sie Dateien für jeweils den Bootstrapper, die Installer-App und die Setup-Engine, die mit dd_bootstrapper, dd_client und dd_setup beginnen.
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.