dotnet-Befehl

Name

dotnet: Allgemeiner Treiber für das Ausführen der Befehlszeilenbefehle.

Übersicht

dotnet [command] [arguments] [--version] [--info] [-d|--diagnostics] [-v|--verbose] [--fx-version] [--additionalprobingpath] [-h|--help]

Beschreibung

dotnet ist ein generischer Treiber für die Befehlszeilenschnittstellen-Toolkette (CLI). Bietet bei eigenständigem Aufruf kurze Anweisungen.

Jede bestimmte Funktion ist als Befehl implementiert. Um die Funktion zu verwenden, wird der Befehl nach dotnet angegeben, wie z.B. dotnet build. Alle Argumente nach dem Befehl sind die eigenen Argumente.

Nur bei Framework-abhängigen Apps wird dotnet als eigenständiger Befehl verwendet. Geben Sie eine Anwendungs-DLL nach dem Verb dotnet an, um die Anwendung auszuführen (zum Beispiel dotnet myapp.dll).

Optionen

-v|--verbose

Aktiviert die ausführliche Ausgabe.

-d|--diagnostics

Ermöglicht die diagnostische Ausgabe.

--fx-version <VERSION>

Version des installierten freigegebenen Frameworks, die für die Ausführung der Anwendung verwendet werden soll.

--additionalprobingpath <PATH>

Pfad, der die Suchrichtlinie und die zu suchenden Assemblys enthält.

--version

Druckt die Version der CLI-Tools.

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

-h|--help

Druckt eine kurze Hilfe für den Befehl. Bei Verwendung mit dotnet wird auch eine Liste der verfügbaren Befehle gedruckt.

dotnet-Befehle

Allgemein

Befehl Funktion
dotnet-build Erstellt eine .NET Core-Anwendung.
dotnet-clean Bereinigen Sie Buildausgabe(n).
dotnet-migrate Migriert ein gültiges Preview 2-Projekt in ein .NET Core SDK 1.0-Projekt.
dotnet-msbuild Ermöglicht den Zugriff auf die MSBuild-Befehlszeile
dotnet-new Initialisiert ein C#- oder F#-Projekt für eine bestimmte Vorlage.
dotnet-pack Erstellt ein NuGet-Paket aus Ihrem Code.
dotnet-publish Veröffentlicht eine .NET Framework-abhängige oder eigenständige Anwendung.
dotnet-restore Stellt die Abhängigkeiten für eine bestimmte Anwendung wieder her.
dotnet-run Führt die Anwendung aus der Quelle aus.
dotnet-sln Optionen zum Hinzufügen, Entfernen und Listen von Projekten in einer Projektmappendatei.
dotnet-test Führt Tests mit einem Test Runner aus.

Projektverweise

Befehl Funktion
dotnet-add-Verweis Projektverweis hinzufügen.
dotnet-list-Verweis Projektverweise auflisten.
dotnet-remove-Verweis Einen Projektverweis entfernen.

NuGet-Pakete

Befehl Funktion
dotnet-add-Paket Ein NuGet-Paket hinzufügen.
dotnet-remove-Paket Ein NuGet-Paket entfernen.

NuGet-Befehle

Befehl Funktion
dotnet-nuget delete Löscht ein Paket vom Server oder hebt dessen Auflistung auf.
dotnet-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.
dotnet-nuget push Überträgt ein Paket auf den Server und veröffentlicht es.

Beispiele

Initialisieren einer .NET Core-Konsolenanwendung, die kompiliert und ausgeführt werden kann:

dotnet new console

Wiederherstellen von Abhängigkeiten für eine bestimmte Anwendung:

dotnet restore

Erstellen eines Projekts und seiner Abhängigkeiten in einem vorgegebenen Verzeichnis:

dotnet build

Führen Sie eine Framework-abhängige Anwendung mit dem Namen myapp.dll aus:

dotnet myapp.dll

Umgebungsvariablen

DOTNET_PACKAGES

Der Cache des primären Pakets. Wenn er nicht festgelegt wird, wird standardmäßig $HOME/.nuget/packages unter Unix oder %HOME%\NuGet\Packages unter Windows verwendet.

DOTNET_SERVICING

Gibt den Speicherort des Wartungsindex an, der vom freigegebenen Host verwendet wird, wenn die Laufzeit geladen wird.

DOTNET_CLI_TELEMETRY_OPTOUT

Gibt an, ob Daten zur Nutzung von .NET Core-Tools gesammelt und an Microsoft gesendet werden. 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). Wenn sie nicht festgelegt wird, ist der Standardwert false, und die Telemetriefunktion ist aktiviert.