Beispiele für Befehlszeilenparameter für die Installation von Visual Studio

Zur Veranschaulichung, wie Befehlszeilenparameter zur Installation von Visual Studio verwendet werden, sind hier einige Beispiele aufgeführt, die sie Ihren Bedürfnissen anpassen können.

In jedem Beispiel stehen vs_enterprise.exe, vs_professional.exe und vs_community.exe für die jeweilige Ausgabe des Visual Studio Bootstrappers, der kleinen (~ 1MB) Datei, die den Download-Prozess einleitet. Wenn Sie eine andere Edition verwenden, setzen Sie die entsprechenden Bootstrappernamen ein.

Alle Befehle erfordern administrative Erhöhung, und ein Befehl der Benutzerkontensteuerung wird angezeigt, wenn der Prozess nicht von einer erhöhten Aufforderung gestartet wurde.

Sie können die ^-Zeichen am Ende einer Befehlszeile zum Verketten mehrerer Zeilen in einem einzigen Befehl verwenden. Alternativ können Sie diese Zeilen zusammen in einer einzelnen Zeile platzieren. Die Entsprechung in PowerShell ist das Graviszeichen (`).

Listen der Workloads und Komponenten, die Sie über die Befehlszeile installieren können, finden Sie auf der Seite Visual Studio-Workload und Komponenten-IDs.

Installieren mit --installPath und --add neben dem Bootstrapper

• Installieren Sie eine Minimalinstanz von Visual Studio, ohne interaktive Eingabeaufforderungen, aber mit Fortschrittsanzeige:

  vs_enterprise.exe --installPath C:\minVS ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  --passive --norestart
  

• Installieren Sie automatisch eine Desktopinstanz von Visual Studio mit dem französischen Sprachpaket, die nur zurückgegeben wird, wenn das Produkt aufgerufen wird.

  vs_enterprise.exe --installPath C:\desktopVS ^
  --addProductLang fr-FR ^
  --add Microsoft.VisualStudio.Workload.ManagedDesktop ^
  --includeRecommended --quiet --wait
  

Aktualisieren

• Sie können eine Visual Studio-Instanz über die Befehlszeile aktualisieren. Dabei wird der jeweilige Status angezeigt, aber es sind keine interaktiven Eingabeaufforderungen zu sehen. Sie können diese Reihe von Befehlen in zwei Schritten ausführen, indem Sie einen Bootstrapper verwenden, der sich entweder auf dem Client oder in einem Layout befindet. Der erste Befehl aktualisiert das Installationsprogramm auf dem Client, der zweite das Visual Studio-Produkt. Sie müssen diese Befehle in einer erweiterten Eingabeaufforderung ausführen, da für die Aktualisierung des Installationsprogramms Administratorrechte erforderlich sind. Im folgenden Beispiel wird das Aktualisieren eines Clients mithilfe eines Evergreen-Bootstrappers im Layout simuliert:

  \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
  \\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
  

Alternativ können Sie Ihre Visual Studio-Instanz auch in einem Schritt aktualisieren, indem Sie das Installationsprogramm auf dem Client verwenden. Standardbenutzer*innen, denen entsprechende Berechtigungen erteilt wurden, können den Updatebefehl programmgesteuert mit dem Installationsprogramm ausführen, dürfen jedoch nicht die Optionen --passive oder --quiet verwenden. Beachten Sie, dass Sie das Installationsprogramm nicht programmgesteuert aus demselben Verzeichnis initiieren können, in dem es gespeichert ist.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Verwenden von „--wait“

• Verwenden Sie --wait in Batchdateien oder Skripts, um den Abschluss des ursprünglichen Befehls abzuwarten, bevor der nächste Befehl ausgeführt wird. Für Batchdateien enthält die %ERRORLEVEL%-Umgebungsvariable den Rückgabewert des Befehls, so wie auf der Seite Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio dokumentiert. Bei einigen Befehlszeilen-Hilfsprogrammen sind zusätzliche Parameter erforderlich, damit der Abschluss abgewartet und der Rückgabewert des Installers abgerufen wird.

Der --wait-Parameter wird nur vom Bootstrapper unterstützt.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

Der folgende Befehl ist ein Beispiel für die Verwendung von --wait mit dem PowerShell-Skriptbefehl Start-Process:

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode 

oder

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()

• Der erste Parameter --wait wird vom Visual Studio-Bootstrapper und der zweite Parameter -Wait von „Start-Process“ verwendet, um den Abschluss abzuwarten. Der Parameter -PassThru wird von Start-Process verwendet, um den Exitcode des Installationsprogramms für seinen Rückgabewert zu verwenden.

Verwenden von „--layout“ zum Erstellen eines Netzwerklayouts oder eines lokalen Caches

• Erstellen Sie ein Layout, das nur den Visual Studio Core-Editor (die minimalste Visual Studio-Konfiguration) und das englische Language Pack enthält. Weitere Beispiele für die Layouterstellung finden Sie auf der Seite zum Erstellen einer Netzwerkinstallation von Visual Studio.

  vs_professional.exe --layout "C:\VS" ^
  --lang en-US ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  

Verwenden von „--all“ zum Erwerben des kompletten Produkts

• Starten Sie eine interaktive Installation aller Workloads und Komponenten, die in der Visual Studio Enterprise-Edition verfügbar sind:

  vs_enterprise.exe --all
  

Verwenden von „--includeRecommended“

• Installieren Sie eine zweite, mit einem Spitznamen versehene Instanz von Visual Studio Professional auf einem Computer, auf dem die Visual Studio Community-Edition bereits mit der Unterstützung für die Node.js-Entwicklung vorhanden ist:

  vs_professional.exe --installPath C:\VSforNode ^
  --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
  

Verwenden von „--channelURI“

Mit dem aktuellen Installationsprogramm können Sie konfigurieren, wo Visual Studio nach Updates sucht. Der --channelUri wird auch als Updatekanal oder Quellspeicherort von Updates bezeichnet. Die folgende Tabelle enthält Beispielwerte für channelId und channelUri und deren Bedeutung.

Wenn Sie ein benutzerdefiniertes Layout als Updatekanal verwenden möchten, beachten Sie die folgenden Richtlinien:

• --channelUri muss auf die Datei „channelmanifest.json“ im benutzerdefinierten Layout verweisen.
• Administratoren können konfigurieren, wie das benutzerdefinierte Layout „Privater Kanal“ in der Benutzeroberfläche für Updateeinstellungen angezeigt wird, indem sie die Registrierungseinstellungen des Clients konfigurieren.

Verwenden von „--remove“

• Entfernen Sie die Komponente des Profilerstellungstools von der Standardinstanz, die auf Visual Studio installiert ist. In diesem Beispiel wird das Installationsprogramm verwendet, das bereits auf dem Clientcomputer installiert ist. Standardbenutzer mit den entsprechenden Berechtigungen können den modify-Befehl mit dem Installationsprogramm programmatisch ausführen, dürfen aber nicht den Schalter --passive oder --quiet verwenden. Beachten Sie, dass Sie das Installationsprogramm nicht programmgesteuert aus demselben Verzeichnis initiieren können, in dem es gespeichert ist.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
  --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
  --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
  --passive
  

Sie können --remove nicht im gleichen Befehl wie --layout verwenden. Anders ausgedrückt: Es ist nicht möglich, Komponenten aus einem Layout zu entfernen.

Verwenden von --removeOos

Mit dem aktuellen Installationsprogramm können Sie eine Installation ändern und alle Komponenten, die in einen Zustand nach dem Supportende übergegangen sind, aus der standardmäßig installierten Visual Studio-Instanz entfernen. In diesem Beispiel wird das Installationsprogramm verwendet, das bereits auf dem Clientcomputer installiert ist, um die removeOos-Einstellung zu konfigurieren. Standardbenutzer*innen, denen entsprechende Berechtigungen erteilt wurden, können den Änderungsbefehl programmgesteuert mit dem Installationsprogramm ausführen, dürfen jedoch nicht die Optionen --passive oder --quiet verwenden. Sie können das Installationsprogramm nicht programmatisch aus demselben Verzeichnis starten, in dem sich das Installationsprogramm befindet.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

• Passen Sie die Update-Einstellungen so an, dass alle Komponenten, die in einen nicht mehr unterstützten Status übergegangen sind, bei jeder Aktualisierung des Produkts dauerhaft entfernt werden:

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --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  
  

Verwenden von „--path“

Bei allen diesen Beispielen wird davon ausgegangen, dass Sie ein neues Produkt mithilfe eines Bootstrappers installieren.

• Verwenden der Pfade „install“, „cache“ und „shared“:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

• Ausschließliches Verwenden der Pfade „install“ und „cache“:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

• Ausschließliches Verwenden der Pfade „install“ und „shared“:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

• Ausschließliches Verwenden des Pfads „install“:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Verwenden von „export“

• Speichern der Auswahl aus einer Installation mit „export“. In diesem Beispiel wird das Installationsprogramm verwendet, das bereits auf dem Clientcomputer installiert ist.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Speichern der benutzerdefinierten Auswahl von Grund auf mit „export“. In diesem Beispiel wird das Installationsprogramm verwendet, das bereits auf dem Clientcomputer installiert ist.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"
  

Verwenden von „--config“

• Verwenden von „--config“ zum Installieren der Workloads und der Komponenten aus einer kürzlich gespeicherten Installationskonfigurationsdatei:

  vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
  

• Hinzufügen von Workloads und Komponenten zu einer bereits vorhandenen Installation mit „--config“. In diesem Beispiel wird das Installationsprogramm verwendet, das bereits auf dem Clientcomputer installiert ist. Standardbenutzer mit den entsprechenden Berechtigungen können den modify-Befehl mit dem Installationsprogramm programmatisch ausführen, dürfen aber nicht den Schalter --passive oder --quiet verwenden. Sie können das Installationsprogramm nicht programmatisch aus demselben Verzeichnis starten, in dem sich das Installationsprogramm befindet.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Verwenden Sie „--config“, um den Inhalt eines Layouts zu konfigurieren:

  vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig" 
  

Verwenden von „winget“

Verwenden Sie das „winget“-Tool von Windows-Paket-Manager, um Visual Studio programmgesteuert auf Ihren Computern zusammen mit anderen Paketen zu installieren oder zu aktualisieren, die von „winget“ verwaltet werden. Um die Installation anzupassen und andere Workloads und Komponenten zu spezifizieren, können Sie neben dem winget-Befehl install auch den Schalter --override verwenden und eine exportierte vsconfig-Datei wie folgt übergeben:

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

Sie können auch eine winget configure Datei verwenden .yaml und übergeben, um eine vorhandene Visual Studio-Installation zu ändern. Dieser Ansatz verwendet den Visual Studio PowerShell DSC-Anbieter, der hier dokumentiert ist.

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

• Administratorhandbuch für Visual Studio
• Verwenden von Befehlszeilenparametern zum Installieren von Visual Studio
• Erstellen einer Netzwerkinstallation von Visual Studio
• Arbeitsauslastung und Komponenten-IDs von Visual Studio