dotnet restoredotnet restore

Dieses Thema gilt für: ✓ .NET Core SDK 1.x .NET Core SDK 2.xThis topic applies to: ✓ .NET Core SDK 1.x .NET Core SDK 2.x

NameName

dotnet restore: Stellt die Abhängigkeiten und Tools eines Projekts wieder herdotnet restore - Restores the dependencies and tools of a project.

ÜbersichtSynopsis

dotnet restore [<ROOT>] [--configfile] [--disable-parallel] [--force] [--ignore-failed-sources] [--no-cache] [--no-dependencies] [--packages] [-r|--runtime] [-s|--source] [-v|--verbosity]
dotnet restore [-h|--help]

BeschreibungDescription

Der Befehl dotnet restore verwendet NuGet zum Wiederherstellen von Abhängigkeiten sowie projektspezifischen Tools, die in der Projektdatei angegeben sind.The dotnet restore command uses NuGet to restore dependencies as well as project-specific tools that are specified in the project file. Standardmäßig wird die Wiederherstellung von Abhängigkeiten und Tools parallel ausgeführt.By default, the restoration of dependencies and tools are performed in parallel.

Hinweis

Starting with .NET Core 2.0, you don't have to run dotnet restore because it's run implicitly by all commands, such as dotnet build and dotnet run, that require a restore to occur. It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Visual Studio Team Services or in build systems that need to explicitly control the time at which the restore occurs.

Zum Wiederherstellen der Abhängigkeiten benötigt NuGet die Feeds, wo sich die Pakete befinden.In order to restore the dependencies, NuGet needs the feeds where the packages are located. Feeds werden in der Regel über die Konfigurationsdatei NuGet.config bereitgestellt.Feeds are usually provided via the NuGet.config configuration file. Eine standardmäßige Konfigurationsdatei wird bereitgestellt, wenn die CLI-Tools installiert sind.A default configuration file is provided when the CLI tools are installed. Sie geben zusätzliche Feeds an, indem Sie eine eigene NuGet.config-Datei im Projektverzeichnis erstellen.You specify additional feeds by creating your own NuGet.config file in the project directory. Sie können auch zusätzliche Feeds pro Aufruf an der Eingabeaufforderung angeben.You also specify additional feeds per invocation at a command prompt.

Für Abhängigkeiten geben Sie mithilfe des Arguments --packages an, wo die wiederhergestellten Pakete während der Wiederherstellung platziert werden.For dependencies, you specify where the restored packages are placed during the restore operation using the --packages argument. Wenn nichts angegeben wurde, wird der Standardcache des NuGet-Pakets verwendet. Er befindet sich im Verzeichnis .nuget/packages im Basisverzeichnis des Benutzers auf allen Betriebssystemen (z.B. /home/user1 unter Linux oder C:\Users\user1 unter Windows).If not specified, the default NuGet package cache is used, which is found in the .nuget/packages directory in the user's home directory on all operating systems (for example, /home/user1 on Linux or C:\Users\user1 on Windows).

Für projektspezifische Tools stellt dotnet restore zunächst das Paket wieder her, in dem sich das Tool befindet, und danach die Abhängigkeiten des Tools gemäß seiner Projektdatei.For project-specific tooling, dotnet restore first restores the package in which the tool is packed, and then proceeds to restore the tool's dependencies as specified in its project file.

Das Verhalten des Befehls dotnet restore wird durch einige Einstellungen in der NuGet.Config-Datei (falls vorhanden) beeinflusst.The behavior of the dotnet restore command is affected by some of the settings in the Nuget.Config file, if present. Das Festlegen von globalPackagesFolder in NuGet.Config platziert z.B. die wiederhergestellten NuGet-Pakete in den angegebenen Ordner.For example, setting the globalPackagesFolder in NuGet.Config places the restored NuGet packages in the specified folder. Dies ist eine Alternative zur Angabe der Option --packages im dotnet restore-Befehl.This is an alternative to specifying the --packages option on the dotnet restore command. Weitere Informationen finden Sie im NuGet.Config-Referenzthema.For more information, see the NuGet.Config reference.

Impliziter dotnet restoreImplicit dotnet restore

Ab .NET Core 2.0 wird dotnet restore bei Bedarf implizit ausgeführt, wenn Sie die folgenden Befehle ausführen:Starting with .NET Core 2.0, dotnet restore is run implicitly if necessary when you issue the following commands:

In den meisten Fällen müssen Sie den dotnet restore-Befehl nicht länger explizit verwenden.In most cases, you no longer need to explicitly use the dotnet restore command.

In einigen Fällen ist eine implizite Ausführung von dotnet restore unpraktisch.In some cases, it is inconvenient for dotnet restore to run implicitly. Zum Beispiel müssen einige automatisierte Systeme, wie etwa Buildsysteme, dotnet restore explizit aufrufen, um zu kontrollieren, wann die Wiederherstellung stattfindet, damit sie die Netzwerknutzung steuern können.For example, some automated systems, such as build systems, need to call dotnet restore explicitly to control when the restore occurs so that they can control network usage. Um eine implizite Ausführung von dotnet restore zu verhindern, können Sie die Option --no-restore mit einem beliebigen dieser Befehle verwenden, um die implizite Wiederherstellung zu deaktivieren.To prevent dotnet restore from running implicitly, you can use the --no-restore switch with any of these commands to disable implicit restore.

ArgumenteArguments

ROOT

Optionaler Pfad zur wiederherzustellenden Projektdatei.Optional path to the project file to restore.

OptionenOptions

--configfile <FILE>

Die NuGet-Konfigurationsdatei (NuGet.config) für den Wiederherstellungsvorgang.The NuGet configuration file (NuGet.config) to use for the restore operation.

--disable-parallel

Deaktiviert paralleles Erstellen von mehreren Projekten.Disables restoring multiple projects in parallel.

--force

Erzwingt das Auflösen aller Abhängigkeiten, auch wenn die letzte Wiederherstellung erfolgreich war.Forces all dependencies to be resolved even if the last restore was successful. Dies entspricht dem Löschen der Datei project.assets.json.This is equivalent to deleting the project.assets.json file.

-h|--help

Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

--ignore-failed-sources

Bei fehlerhaften Quellen nur warnen, wenn Pakete die Versionsanforderung erfüllen.Only warn about failed sources if there are packages meeting the version requirement.

--no-cache

Gibt an, dass Pakete und HTTP-Anfragen nicht zwischengespeichert werden.Specifies to not cache packages and HTTP requests.

--no-dependencies

Wenn Sie ein Projekt mit Projekt-zu-Projekt-Verweisen (P2P) wiederherstellen, stellen Sie das Stammprojekt wieder her und nicht die Verweise.When restoring a project with project-to-project (P2P) references, restores the root project and not the references.

--packages <PACKAGES_DIRECTORY>

Gibt das Verzeichnis für wiederhergestellte Pakete an.Specifies the directory for restored packages.

-r|--runtime <RUNTIME_IDENTIFIER>

Gibt eine Laufzeit für die Wiederherstellung des Pakets an.Specifies a runtime for the package restore. Wird für das Wiederherstellen von Paketen für Laufzeiten verwendet, die nicht explizit im <RuntimeIdentifiers>-Tag in der .csproj-Datei aufgeführt sind.This is used to restore packages for runtimes not explicitly listed in the <RuntimeIdentifiers> tag in the .csproj file. Eine Liste der Runtime-IDs (RIDs) finden Sie unter RID-Katalog.For a list of Runtime Identifiers (RIDs), see the RID catalog. Es können mehrere RIDs bereitgestellt werden, indem diese Option mehrmals angegeben wird.Provide multiple RIDs by specifying this option multiple times.

-s|--source <SOURCE>

Gibt eine NuGet-Paketquelle an, die während des Wiederherstellungsvorgangs zu verwenden ist.Specifies a NuGet package source to use during the restore operation. Dies überschreibt alle Quellen, die in der/den NuGet.config-Datei(en) angegeben sind.This overrides all of the sources specified in the NuGet.config file(s). Es können mehrere Quellen bereitgestellt werden, indem diese Option mehrmals angegeben wird.Multiple sources can be provided by specifying this option multiple times.

--verbosity <LEVEL>

Legt den Ausführlichkeitsgrad für den Befehl fest.Sets the verbosity level of the command. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].