dotnet workload install

  • Artikel

Dieser Artikel gilt für: ✔️ .NET 6 SDK und höhere Versionen

Name

dotnet workload install: Dieser Befehl installiert optionale Workloads.

Übersicht

dotnet workload install <WORKLOAD_ID>...
    [--configfile <FILE>] [--disable-parallel]
    [--ignore-failed-sources] [--include-previews] [--interactive]
    [--no-cache] [--skip-manifest-update] [--source <SOURCE>]
    [--temp-dir <PATH>] [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet workload install -?|-h|--help

Beschreibung

Der Befehl dotnet workload install installiert eine oder mehrere optionale Workloads. Optionale Workloads können zusätzlich zum .NET SDK installiert werden, um Unterstützung für verschiedene Anwendungstypen zu bieten, z. B. .NET MAUI und Blazor WebAssembly AOT.

Wenn sich der Befehl im workload-set Updatemodus befindet, installiert die Workloadversionen:

  • Stammen aus dem neuesten Workloadsatz oder einer Workload-Set-Version, die in einem global.json oder --version einer Option angegeben ist.
  • Die neueste Version ist möglicherweise nicht für jede einzelne Workload verfügbar. Der Befehl installiert z. B. keine neuere Workload, die festgelegt wurde, install wenn Sie zuvor das --version Flag verwendet haben.

Weitere Informationen finden Sie unter .NET SDK-Workloadsätze. workload-set Der Updatemodus ist seit 8.0.400 SDK verfügbar.

Verwenden Sie dotnet workload search, um zu ermitteln, welche Workloads installiert werden können.

Ausführung mit erhöhten Rechten

Bei macOS- und Linux-SDK-Installationen, die in einem geschützten Verzeichnis installiert sind, muss der Befehl mit erhöhten Rechten ausgeführt werden. Verwenden Sie dazu den Befehl sudo. Unter Windows muss der Befehl nicht mit erhöhten Rechten ausgeführt werden, auch nicht, wenn das SDK im Verzeichnis Programme installiert wurde. Unter Windows verwendet der Befehl MSI-Installationsprogramme für diesen Speicherort.

Variierende Ergebnisse nach SDK-Version

Die Befehle dotnet workload werden im Kontext bestimmter SDK-Versionen ausgeführt. Angenommen, Sie verfügen sowohl über eine Installation des SDK .NET 6.0.100 als auch des SDK .NET 6.0.200. Die Befehle dotnet workload führen zu unterschiedlichen Ergebnissen, je nachdem, welche SDK-Version Sie ausgewählt haben. Dieses Verhalten gilt für Unterschiede bei Haupt- und Nebenversionen sowie Featureleisten, nicht für Unterschiede bei der Patchversion. Für .NET SDK 6.0.101 und 6.0.102 erhalten Sie beispielsweise dieselben Ergebnisse, wohingegen 6.0.100 und 6.0.200 zu anderen Ergebnissen führen. Sie können die SDK-Version mithilfe der global.json Datei angeben.

Ankündigungsmanifeste

Die Namen und Versionen der Ressourcen, die für eine Workloadinstallation erforderlich sind, werden in Manifesten verwaltet. Standardmäßig lädt der Befehl dotnet workload install die aktuellen verfügbaren Manifeste herunter, bevor eine Workload installiert wird. Die lokale Kopie eines Manifests liefert dann die Informationen, die erforderlich sind, um die Ressourcen für eine Workload zu ermitteln und herunterzuladen.

Der Befehl dotnet workload list vergleicht die Versionen installierter Workloads mit den aktuell verfügbaren Versionen. Wenn festgestellt wird, dass eine Version verfügbar ist, die aktueller als die installierte Version ist, wird diese Tatsache in der Befehlsausgabe angekündigt. Diese Benachrichtigungen zu neueren Versionen in dotnet workload list sind ab .NET 6 verfügbar.

Damit diese Benachrichtigungen aktiviert werden, werden die aktuellen verfügbaren Versionen der Manifeste heruntergeladen und als Ankündigungsmanifeste gespeichert. Diese Downloads werden im Hintergrund asynchron durchgeführt, wenn einer der folgenden Befehle ausgeführt wird.

Wenn ein Befehl abgeschlossen ist, bevor der Download des Manifests abgeschlossen ist, wird der Download angehalten. Der Download wird beim nächsten Mal noch mal versucht, wenn einer dieser Befehle ausgeführt wird. Sie können Umgebungsvariablen festlegen, um diese Hintergrunddownloads zu deaktivieren oder ihre Häufigkeit zu steuern. Standardmäßig werden sie nicht häufiger als einmal täglich durchgeführt.

Sie können verhindern, dass der Befehl dotnet workload install Manifeste herunterlädt, indem Sie die Option --skip-manifest-update verwenden.

Der Befehl dotnet workload update lädt auch Ankündigungsmanifeste herunter. Die Downloads sind erforderlich, um zu ermitteln, ob ein Update verfügbar ist. Es gibt also keine Möglichkeit, ihre Ausführung zu verhindern. Sie können aber die Option --advertising-manifests-only verwenden, um Workloadupdates zu überspringen und nur die Manifestdownloads durchzuführen. Diese Option ist ab .NET 6 verfügbar.

Argumente

  • WORKLOAD_ID...

    Hierbei handelt es sich um die Workload-ID oder mehrere IDs, die installiert werden. Verwenden Sie dotnet workload search, um zu ermitteln, welche Workloads verfügbar sind.

Optionen

  • --configfile <FILE>

    Die zu verwendende NuGet-Konfigurationsdatei (nuget.config). Sofern angegeben, werden nur die Einstellungen aus dieser Datei verwendet. Falls nicht angegeben, wird die Hierarchie der Konfigurationsdateien aus dem aktuellen Verzeichnis verwendet. Weitere Informationen finden Sie unter Gängige NuGet-Konfigurationen.

  • --disable-parallel

    Diese Option verhindert die parallele Wiederherstellung mehrerer Projekte.

  • -?|-h|--help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

  • --ignore-failed-sources

    Paketquellenfehler werden als Warnungen behandelt.

  • --include-previews

    Diese Option erlaubt die Verwendung von Vorabversionen von Workloadmanifesten.

  • --interactive

    Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen.

  • --no-cache

    Diese Option verhindert, dass Pakete und HTTP-Anforderungen zwischengespeichert werden.

  • --skip-manifest-update

    Hierbei wird die Aktualisierung der Workloadmanifeste übersprungen. Die Workloadmanifeste definieren, welche Ressourcen und Versionen pro Workload installiert werden müssen.

  • -s|--source <SOURCE>

    Hiermit wird der URI der NuGet-Paketquelle angegeben, die verwendet wird. Diese Einstellung überschreibt alle Quellen, die in den nuget.config-Dateien angegeben sind. Es können mehrere Quellen bereitgestellt werden, indem diese Option mehrmals angegeben wird.

  • --temp-dir <PATH>

    Geben Sie das temporäre Verzeichnis an, das zum Herunterladen und Extrahieren von NuGet-Paketen verwendet wird (muss ein sicheres Verzeichnis sein).

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic]. Der Standardwert ist minimal. Wenn Sie als Ausführlichkeit detailed oder diagnostic angeben, zeigt der Befehl Informationen zu den heruntergeladenen NuGet-Paketen an.

  • --version

    Die Workload legt die Version fest, auf die sie installiert oder aktualisiert werden soll. Wenn Sie die Workload-Set-Version in global.json angeben, können Sie die --version Option nicht verwenden, um die Workload-Set-Version anzugeben. Um die --version Option in diesem Fall zu verwenden, führen Sie den Befehl außerhalb des Pfads aus, der die global.json Datei enthält. Verfügbar seit 8.0.400 SDK. Weitere Informationen finden Sie unter .NET SDK-Workloadsätze.

Beispiele

  • So wird die Workload maui installiert:

    dotnet workload install maui

  • Installieren Sie die maui-android- und maui-ios-Workloads:

    dotnet workload install maui-android maui-ios