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: Allgemeiner Treiber für das Ausführen der Befehlszeilenbefehle.dotnet - General driver for running the command-line commands.

ÜbersichtSynopsis

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

BeschreibungDescription

dotnet ist ein generischer Treiber für die Befehlszeilenschnittstellen-Toolkette (CLI).dotnet is a generic driver for the Command Line Interface (CLI) toolchain. Bietet bei eigenständigem Aufruf kurze Anweisungen.Invoked on its own, it provides brief usage instructions.

Jede bestimmte Funktion ist als Befehl implementiert.Each specific feature is implemented as a command. Um die Funktion zu verwenden, wird der Befehl nach dotnet angegeben, wie z.B. dotnet build.In order to use the feature, the command is specified after dotnet, such as dotnet build. Alle Argumente nach dem Befehl sind die eigenen Argumente.All of the arguments following the command are its own arguments.

Nur bei Framework-abhängigen Apps wird dotnet als eigenständiger Befehl verwendet.The only time dotnet is used as a command on its own is to run framework-dependent apps. Geben Sie eine Anwendungs-DLL nach dem Verb dotnet an, um die Anwendung auszuführen (zum Beispiel dotnet myapp.dll).Specify an application DLL after the dotnet verb to execute the application (for example, dotnet myapp.dll).

OptionenOptions

--additionaldeps <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 installierten .NET Core-Laufzeit, die für die Ausführung der Anwendung verwendet werden soll.Version of the installed .NET Core runtime to use to run the application.

-h|--help

Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command. Bei Verwendung mit dotnet wird auch eine Liste der verfügbaren Befehle gedruckt.If using with dotnet, it also prints a list of the available commands.

--info

Druckt nähere Informationen zu den CLI-Tools und der Umgebung, z.B. das aktuelle Betriebssystem, den Commit-SHA für die Version und weitere Informationen.Prints out detailed information about the CLI tooling and the environment, such as the current operating system, commit SHA for the version, and other information.

--roll-forward-on-no-candidate-fx

Führt ein Rollforward auf ein geteiltes Framework ohne Kandidaten durch.Rolls forward on no candidate shared framework.

-v|--verbose

Aktiviert die ausführliche Ausgabe.Enables verbose output.

--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 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 Projektverweis hinzufügen.Add a project reference.
dotnet list referencedotnet list reference Projektverweise auflisten.List project references.
dotnet remove referencedotnet remove reference Einen Projektverweis entfernen.Remove a project reference.

NuGet-PaketeNuGet packages

BefehlCommand FunktionFunction
dotnet add packagedotnet add package Ein NuGet-Paket hinzufügen.Add a NuGet package.
dotnet remove packagedotnet remove package Ein NuGet-Paket entfernen.Remove 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.

BeispieleExamples

Initialisieren einer .NET Core-Konsolenanwendung, die kompiliert und ausgeführt werden kann:Initialize a sample .NET Core console application that can be compiled and run:

dotnet new console

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

dotnet restore

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.

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 Framework-abhängige Anwendung mit dem Namen myapp.dll aus:Run a framework-dependent app named 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 sie auf true fest, um die Telemetriefunktion zu deaktivieren (Werte true, 1 oder yes werden akzeptiert); legen Sie sie andernfalls auf false fest, um die Telemetriefunktionen zu aktivieren (Werte false, 0 oder no werden akzeptiert).Set to true to opt-out of the telemetry feature (values true, 1, or yes accepted); otherwise, set to false to opt-in to the telemetry features (values false, 0, or no accepted). Wenn sie nicht festgelegt wird, ist der Standardwert false, und die Telemetriefunktion ist aktiviert.If not set, the defaults is false, and the telemetry feature is active.