Freigeben über


dotnet workload update

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

Name

dotnet workload update: Dieser Befehl aktualisiert installierte Workloads.

Übersicht

dotnet workload update
    [--advertising-manifests-only]
    [--configfile <FILE>] [--disable-parallel]
    [--from-previous-sdk] [--ignore-failed-sources]
    [--include-previews] [--interactive] [--no-cache]
    [-s|--source <SOURCE>] [--temp-dir <PATH>]
    [-v|--verbosity <LEVEL>] [--version]

dotnet workload update -?|-h|--help

Beschreibung

Der Befehl dotnet workload update aktualisiert alle installierten Workloads auf die aktuellen verfügbaren Versionen. Außerdem wird Nuget.org nach aktualisierten Workloadmanifesten abgefragt. Anschließend werden lokale Manifeste aktualisiert, neue Versionen der installierten Workloads werden heruntergeladen, und alle alten Versionen der einzelnen Workloads werden entfernt.

Wenn sich der Befehl im workload-set Updatemodus befindet, werden Workloads entsprechend der Workload-Set-Version aktualisiert, nicht die neueste Version jeder einzelnen Workload. Weitere Informationen finden Sie unter .NET SDK-Workloadsätze. workload-set der Modus ist seit 8.0.400 SDK verfügbar.

Weitere Informationen zu den dotnet workload-Befehlen finden Sie im Artikel zum Befehl dotnet workload install.

Optionen

  • --advertising-manifests-only

    Diese Option lädt Ankündigungsmanifeste, sie aktualisiert aber keine Workloads.

  • --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.

  • --from-previous-sdk

    Bei dieser Option werden Workloads, die mit früheren SDK-Versionen installiert wurden, in die Aktualisierung eingeschlossen.

  • -?|-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.

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

  • Aktualisieren Sie die installierten Workloads auf die neueste Version jeder einzelnen Workload:

    dotnet workload config --update-mode manifests
    dotnet workload update
    
  • Aktualisieren Sie die installierten Workloads auf die neueste Workloadsatzversion:

    dotnet workload config --update-mode workload-set
    dotnet workload update