dotnet-Befehldotnet command

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: Ein Tool für das Verwalten von .NET-Quellcode und Binärdateien.dotnet - A tool for managing .NET source code and binaries.

ÜbersichtSynopsis

dotnet [command] [arguments] [--additional-deps] [--additionalprobingpath] [-d|--diagnostics] [--fx-version]
    [-h|--help] [--info] [--list-runtimes] [--list-sdks] [--roll-forward-on-no-candidate-fx] [-v|--verbosity] [--version]

BeschreibungDescription

dotnet ist ein Tool für das Verwalten von .NET-Quellcode und Binärdateien.dotnet is a tool for managing .NET source code and binaries. Es stellt Befehle zur Verfügung, die bestimmte Aufgaben erfüllen, z.B. dotnet build und dotnet run.It exposes commands that perform specific tasks, such as dotnet build and dotnet run. Jeder Befehl definiert seine eigenen Argumente.Each command defines its own arguments. Geben Sie nach jedem Befehl --help ein, um auf eine kurze Hilfsdokumentation zuzugreifen.Type --help after each command to access brief help documentation.

dotnet kann zum Ausführen von Anwendungen verwendet werden, indem eine Anwendungs-DLL angegeben wird, z.B. dotnet myapp.dll.dotnet can be used to run applications, by specifying an application DLL, such as dotnet myapp.dll. Weitere Informationen über Bereitstellungsoptionen finden Sie unter .NET Core-Anwendungsbereitstellung.See .NET Core application deployment for to learn about deployment options.

OptionenOptions

--additional-deps <PATH>

Pfad zur zusätzlichen deps.json-Datei.Path to additional deps.json file.

--additionalprobingpath <PATH>

Pfad, der die Suchrichtlinie und die zu suchenden Assemblys enthält.Path containing probing policy and assemblies to probe.

-d|--diagnostics

Ermöglicht die diagnostische Ausgabe.Enables diagnostic output.

--fx-version <VERSION>

Version der .NET Core-Runtime, die zum Ausführen der Anwendung verwendet werden soll.Version of the .NET Core runtime to use to run the application.

-h|--help

Gibt Dokumentation für einen bestimmten Befehl aus, z.B. dotnet build --help.Prints out documentation for a given command, such as dotnet build --help. dotnet --help gibt eine Liste der verfügbaren Befehle zurück.dotnet --help prints a list of available commands.

--info

Gibt ausführliche Informationen über eine .NET Core-Installation und die Computerumgebung aus, z.B. das aktuelle Betriebssystem und den Commit-SHA für die .NET Core-Version.Prints out detailed information about a .NET Core installation and the machine environment, such as the current operating system, and commit SHA of the .NET Core version.

--list-runtimes

Zeigt die installierten .NET Core-Runtimes an.Displays the installed .NET Core runtimes.

--list-sdks

Zeigt die installierten .NET Core-SDKs an.Displays the installed .NET Core SDKs.

--roll-forward-on-no-candidate-fx <N>

Definiert ein Verhalten, wenn das erforderliche freigegebene Framework nicht verfügbar ist.Defines behavior when the required shared framework is not available. N kann Folgendes sein:N can be:

  • 0 - Das Ausführen von Rollforward ist auch für die Nebenversion deaktiviert.0 - Disable even minor version roll forward.
  • 1 - Rollforward wird in der Nebenversion, nicht aber in der Hauptversion, ausgeführt.1 - Roll forward on minor version, but not on major version. Dies ist das Standardverhalten.This is the default behavior.
  • 2 - Rollforward wird in Neben- und Hauptversionen ausgeführt.2 - Roll forward on minor and major versions.

Weitere Informationen finden Sie unter Rollforward.For more information, see Roll forward.

-v|--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]. Nicht in jedem Befehl unterstützt. Auf der Seite der einzelnen Befehle finden Sie heraus, ob diese Option verfügbar ist.Not supported in every command; see specific command page to determine if this option is available.

--version

Druckt die Version des verwendeten .NET Core-SDK aus.Prints out the version of the .NET Core SDK in use.

dotnet-Befehledotnet commands

AllgemeinGeneral

BefehlCommand FunktionFunction
dotnet builddotnet build Erstellt eine .NET Core-Anwendung.Builds a .NET Core application.
dotnet build-serverdotnet build-server Interagiert mit Servern, die von einem Build gestartet wurden.Interacts with servers started by a build.
dotnet cleandotnet clean Bereinigen von Buildausgaben.Clean build outputs.
dotnet helpdotnet help Zeigt eine ausführlichere Onlinedokumentation für den Befehl.Shows more detailed documentation online for the command.
dotnet migratedotnet migrate Migriert ein gültiges Preview 2-Projekt in ein .NET Core SDK 1.0-Projekt.Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project.
dotnet msbuilddotnet msbuild Ermöglicht den Zugriff auf die MSBuild-BefehlszeileProvides access to the MSBuild command line.
dotnet newdotnet new Initialisiert ein C#- oder F#-Projekt für eine bestimmte Vorlage.Initializes a C# or F# project for a given template.
dotnet packdotnet pack Erstellt ein NuGet-Paket aus Ihrem Code.Creates a NuGet package of your code.
dotnet publishdotnet publish Veröffentlicht eine .NET Framework-abhängige oder eigenständige Anwendung.Publishes a .NET framework-dependent or self-contained application.
dotnet restoredotnet restore Stellt die Abhängigkeiten für eine bestimmte Anwendung wieder her.Restores the dependencies for a given application.
dotnet rundotnet run Führt die Anwendung aus der Quelle aus.Runs the application from source.
dotnet slndotnet sln Optionen zum Hinzufügen, Entfernen und Listen von Projekten in einer Projektmappendatei.Options to add, remove, and list projects in a solution file.
dotnet storedotnet store Speichert Assemblys im Laufzeitpaketspeicher.Stores assemblies in the runtime package store.
dotnet testdotnet test Führt Tests mit einem Test Runner aus.Runs tests using a test runner.

ProjektverweiseProject references

BefehlCommand FunktionFunction
dotnet add referencedotnet add reference Fügt einen Projektverweis hinzu.Adds a project reference.
dotnet list referencedotnet list reference Listet Projektverweise auf.Lists project references.
dotnet remove referencedotnet remove reference Entfernt einen Projektverweis.Removes a project reference.

NuGet-PaketeNuGet packages

BefehlCommand FunktionFunction
dotnet add packagedotnet add package Fügt ein NuGet-Paket hinzu.Adds a NuGet package.
dotnet remove packagedotnet remove package Entfernt ein NuGet-Paket.Removes a NuGet package.

NuGet-BefehleNuGet commands

BefehlCommand FunktionFunction
dotnet nuget deletedotnet nuget delete Löscht ein Paket vom Server oder hebt dessen Auflistung auf.Deletes or unlists a package from the server.
dotnet nuget localsdotnet nuget locals Löscht lokale NuGet-Ressourcen, z.B. den http-Anforderungscache, den temporären Cache oder den Ordner mit globalen Paketen auf dem Computer, oder listet diese Ressourcen auf.Clears or lists local NuGet resources such as http-request cache, temporary cache, or machine-wide global packages folder.
dotnet nuget pushdotnet nuget push Überträgt ein Paket auf den Server und veröffentlicht es.Pushes a package to the server and publishes it.

Befehle für globale ToolsGlobal Tools commands

Globale .NET Core-Tools sind beginnend mit .NET Core SDK 2.1.300 verfügbar:.NET Core Global Tools are available starting with .NET Core SDK 2.1.300:

BefehlCommand FunktionFunction
dotnet tool installdotnet tool install Installiert ein Global Tool auf dem Computer.Installs a Global Tool on your machine.
dotnet tool listdotnet tool list Listet alle globalen Tools auf, die derzeit im Standardverzeichnis oder unter dem angegebenen Pfad auf Ihrem Computer installiert sind.Lists all Global Tools currently installed in the default directory on your machine or in the specified path.
dotnet tool uninstalldotnet tool uninstall Deinstalliert ein Global-Tool von Ihrem Computer.Uninstalls a Global Tool from your machine.
dotnet tool updatedotnet tool update Aktualisiert ein Global Tool auf dem Computer.Updates a Global Tool on your machine.

Weitere ToolsAdditional tools

Beginnend mit .NET Core SDK 2.1.300 steht eine Reihe von Tools, die nur auf Projektbasis unter Verwendung von DotnetCliToolReference verfügbar waren, jetzt als Teil des .NET Core SDK zur Verfügung.Starting with .NET Core SDK 2.1.300, a number of tools that were available only on a per project basis using DotnetCliToolReference are now available as part of the .NET Core SDK. Diese Tools werden in der folgenden Tabelle aufgeführt:These tools are listed in the following table:

ToolTool FunktionFunction
dev-certsdev-certs Erstellt und verwaltet Entwicklungszertifikate.Creates and manages development certificates.
efef Entity Framework Core-Befehlszeilentools.Entity Framework Core command-line tools.
sql-cachesql-cache SQL Server-Cache-Befehlszeilentools.SQL Server cache command-line tools.
user-secretsuser-secrets Verwaltet die Entwicklung von Benutzergeheimnissen.Manages development user secrets.
watchwatch Startet einen Datei-Watcher, der einen Befehl ausführt, wenn sich Dateien ändern.Starts a file watcher that runs a command when files change.

Geben Sie dotnet <tool-name> --help ein, um weitere Informationen zu den einzelnen Tools zu erhalten.For more information about each tool, type dotnet <tool-name> --help.

BeispieleExamples

Erstellt eine neue .NET Core-Konsolenanwendung:Creates a new .NET Core console application:

dotnet new console

Wiederherstellen von Abhängigkeiten für eine bestimmte Anwendung:Restore dependencies for a given application:

dotnet restore

Hinweis

Ab .NET Core 2.0 SDK müssen Sie dotnet restore nicht mehr ausführen, da der Befehl implizit von allen Befehlen, z.B. dotnet new, dotnet build und dotnet run, ausgeführt wird, die eine Wiederherstellung erfordern.Starting with .NET Core 2.0 SDK, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build and dotnet run. In bestimmten Fällen eignet sich der Befehl dennoch. Dies ist etwa bei Szenarios der Fall, in denen das Ausführen einer expliziten Wiederherstellung sinnvoll ist. Beispiele hierfür sind Continuous Integration-Builds in Azure DevOps Services oder Buildsystemen, die den Zeitpunkt für die Wiederherstellung explizit festlegen müssen.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

Erstellen eines Projekts und seiner Abhängigkeiten in einem vorgegebenen Verzeichnis:Build a project and its dependencies in a given directory:

dotnet build

Führen Sie eine Anwendungs-DLL aus, z.B. myapp.dll:Run an application DLL, such as myapp.dll:

dotnet myapp.dll

UmgebungsvariablenEnvironment variables

DOTNET_PACKAGES

Der Cache des primären Pakets.The primary package cache. Wenn er nicht festgelegt wird, wird standardmäßig $HOME/.nuget/packages unter Unix oder %HOME%\NuGet\Packages unter Windows verwendet.If not set, it defaults to $HOME/.nuget/packages on Unix or %HOME%\NuGet\Packages on Windows.

DOTNET_SERVICING

Gibt den Speicherort des Wartungsindex an, der vom freigegebenen Host verwendet wird, wenn die Laufzeit geladen wird.Specifies the location of the servicing index to use by the shared host when loading the runtime.

DOTNET_CLI_TELEMETRY_OPTOUT

Gibt an, ob Daten zur Nutzung von .NET Core-Tools gesammelt und an Microsoft gesendet werden.Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft. Legen Sie true fest, um die Telemetriefunktion zu deaktivieren (Wert true, 1 oder yes wird akzeptiert).Set to true to opt-out of the telemetry feature (values true, 1, or yes accepted). Legen Sie andernfalls false fest, um die Telemetriefunktionen zu aktivieren (Wert false, 0 oder no wird akzeptiert).Otherwise, set to false to opt into the telemetry features (values false, 0, or no accepted). Ohne Festlegung ist der Standardwert false, und die Telemetriefunktion ist aktiviert.If not set, the default is false and the telemetry feature is active.

DOTNET_MULTILEVEL_LOOKUP

Gibt an, ob die .NET Core-Runtime, das freigegebene Framework oder das SDK vom globalen Speicherort aus aufgelöst werden.Specifies whether .NET Core runtime, shared framework, or SDK are resolved from the global location. Wenn nicht, ist der Standardwert true.If not set, it defaults to true. Wenn der Wert auf false festgelegt wird, wird nicht vom globalen Speicherort aus aufgelöst und es gibt isolierte .NET Core-Installationen (die Werte 0 oder false werden akzeptiert).Set to false to not resolve from the global location and have isolated .NET Core installations (values 0 or false are accepted). Weitere Informationen zu Lookup mit mehreren Ebenen finden Sie unter Multi-level SharedFX lookup (SharedFX-Lookup mit mehreren Ebenen).For more information about multi-level lookup, see Multi-level SharedFX Lookup.

DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX

Deaktiviert Rollforward der Nebenversion, wenn 0 festgelegt ist.Disables minor version roll forward, if set to 0. Weitere Informationen finden Sie unter Rollforward.For more information, see Roll forward.