Freigeben über

dotnet workload restore

  • Artikel

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

Name

dotnet workload restore: Installiert Workloads, die für ein Projekt oder eine Projektmappe erforderlich sind.

Übersicht

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

dotnet workload restore -?|-h|--help

Beschreibung

Der Befehl dotnet workload restore analysiert ein Projekt oder eine Projektmappe, um zu ermitteln, welche Workloads erforderlich sind, und installiert dann alle fehlenden Workloads.

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

Argumente

  • PROJECT | SOLUTION

    Die Projekt- oder Projektmappendatei, für die Workloads installiert werden sollen. Wenn keine Datei angegeben ist, sucht der Befehl im aktuellen Verzeichnis nach einer Projektdatei.

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. Weitere Informationen finden Sie unter LoggerVerbosity.

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

Beispiel

  • Wiederherstellen von Workloads, die von „MyApp.csproj“ benötigt werden:

    dotnet workload restore MyApp.csproj