Tools für die .NET Core-Befehlszeilenschnittstelle (command-line interface, CLI).NET Core command-line interface (CLI) tools

Die .NET Core-Befehlszeilenschnittstelle (CLI) ist eine neue plattformübergreifende Toolkette zur Entwicklung von .NET-Anwendungen.The .NET Core command-line interface (CLI) is a new cross-platform toolchain for developing .NET applications. Die CLI ist eine Grundlage, auf der Tools höherer Ebene wie z.B. integrierte Entwicklungsumgebungen (Integrated Development Environments, IDEs), Editoren und Build-Koordinatoren aufbauen können.The CLI is a foundation upon which higher-level tools, such as Integrated Development Environments (IDEs), editors, and build orchestrators, can rest.

InstallationInstallation

Verwenden Sie entweder die nativen Installer oder die Installations-Shellskripts:Either use the native installers or use the installation shell scripts:

  • Die nativen Installer werden vor allem auf Entwicklercomputern verwendet und verwenden den nativen Installationsmechanismus der jeweiligen unterstützten Plattform, z.B. DEB-Pakete unter Ubuntu oder MSI-Bündel unter Windows.The native installers are primarily used on developer's machines and use each supported platform's native install mechanism, for instance, DEB packages on Ubuntu or MSI bundles on Windows. Diese Installer installieren und konfigurieren die Umgebung für sofortige Verwendung durch den Entwickler, erfordern jedoch Administratorrechte auf dem Computer.These installers install and configure the environment for immediate use by the developer but require administrative privileges on the machine. Die Installationsanweisungen finden Sie im .NET Core-Installationshandbuch.You can view the installation instructions in the .NET Core installation guide.
  • Shellskripts werden hauptsächlich für die Einrichtung von Buildservern verwendet, oder wenn Sie die Tools ohne Administratorrechte installieren möchten.Shell scripts are primarily used for setting up build servers or when you wish to install the tools without administrative privileges. Installationsskripts installieren keine erforderlichen Komponenten auf dem Computer, diese müssen manuell installiert werden.Install scripts don't install prerequisites on the machine, which must be installed manually. Weitere Informationen finden Sie unter install script reference (Referenz zu Installationsskripts).For more information, see the install script reference topic. Informationen zum Einrichten der CLI auf dem Buildserver der fortlaufenden Integration (Continuous Integration, CI) finden Sie unter Verwenden des .NET Core SDK und der entsprechenden Tools in Continuous Integration (CI).For information on how to set up CLI on your continuous integration (CI) build server, see Using .NET Core SDK and tools in Continuous Integration (CI).

Standardmäßig installiert die CLI in paralleler Ausführung (side-by-side, SxS), sodass mehrere Versionen der CLI-Tools auf einem einzelnen Computer gleichzeitig vorhanden sein können.By default, the CLI installs in a side-by-side (SxS) manner, so multiple versions of the CLI tools can coexist on a single machine. Wie bestimmt wird, welche Version auf einem Computer verwendet wird, auf dem mehrere Versionen installiert sind, wird im Abschnitt Treiber ausführlicher erklärt.Determining which version is used on a machine where multiple versions are installed is explained in more detail in the Driver section.

CLI-BefehleCLI commands

Die folgenden Befehle werden standardmäßig erstellt:The following commands are installed by default:

Die CLI übernimmt ein Erweiterbarkeitsmodell, mit dem Sie zusätzliche Tools für Ihre Projekte angeben können.The CLI adopts an extensibility model that allows you to specify additional tools for your projects. Weitere Informationen finden Sie im Thema .NET Core CLI extensibility model (.NET Core-CLI-Erweiterbarkeitsmodell).For more information, see the .NET Core CLI extensibility model topic.

BefehlsstrukturCommand structure

Die CLI-Befehlsstruktur besteht aus dem Treiber („dotnet“), dem Befehl (oder „Verb“) und möglicherweise aus Argumenten und Optionen.CLI command structure consists of the the driver ("dotnet"), the command (or "verb"), and possibly command arguments and options. Sie sehen dieses Muster in den meisten CLI-Vorgängen wie z.B. beim Erstellen einer neuen Konsolenanwendung und deren Ausführung von der Befehlszeile aus, wie die folgenden Befehle zeigen, wenn sie aus einem Verzeichnis mit dem Namen my_app ausgeführt werden:You see this pattern in most CLI operations, such as creating a new console app and running it from the command line as the following commands show when executed from a directory named my_app:

dotnet new console
dotnet build --output /build_output
dotnet /build_output/my_app.dll

TreiberDriver

Der Treiber trägt den Namen dotnet und hat zwei Aufgaben, entweder die Ausführung einer Framework-abhängigen Anwendung oder die Ausführung eines Befehls.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command. dotnet wird nur ohne Befehl verwendet, wenn damit eine Anwendung gestartet wird.The only time dotnet is used without a command is when it's used to start an application.

Geben Sie zur Ausführung einer Framework-abhängigen Anwendung nach dem Treiber die Anwendung an, z.B. dotnet /path/to/my_app.dll.To run a framework-dependent app, specify the app after the driver, for example, dotnet /path/to/my_app.dll. Führen Sie beim Ausführen des Befehls aus dem Ordner, in dem sich die DLL der Anwendung befindet, einfach dotnet my_app.dll aus.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll.

Wenn Sie einen Befehl an den Treiber geben, startet dotnet.exe den Ausführungsprozess des CLI-Befehls.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. Zunächst bestimmt der Treiber die zu verwendende SDK-Version.First, the driver determines the version of the SDK to use. Wenn die Version in den Befehlsoptionen nicht angegeben ist, verwendet der Treiber die neueste verfügbare Version.If the version isn't specified in the command options, the driver uses the latest version available. Verwenden Sie zum Angeben einer anderen Version als der neuesten installierten Version die Option --fx-version <VERSION> (siehe Referenz dotnet-Befehl).To specify a version other than the latest installed version, use the --fx-version <VERSION> option (see the dotnet command reference). Sobald die SDK-Version bestimmt wurde, führt der Treiber den Befehl aus.Once the SDK version is determined, the driver executes the command.

Befehl („Verb“)Command ("verb")

Der Befehl (oder das „Verb“) ist einfach ein Befehl, der eine Aktion ausführt.The command (or "verb") is simply a command that performs an action. dotnet build erstellt z.B. den Code.For example, dotnet build builds your code. dotnet publish veröffentlicht Ihren Code.dotnet publish publishes your code. Die Befehle werden mit einer dotnet {verb}-Konvention als Konsolenanwendung implementiert.The commands are implemented as a console application using a dotnet {verb} convention.

ArgumenteArguments

Die Argumente, die Sie in der Befehlszeile übergeben, sind die Argumente für den aufgerufenen Befehl.The arguments you pass on the command line are the arguments to the command invoked. Wenn Sie z.B. dotnet publish my_app.csproj ausführen, gibt das my_app.csproj-Argument das zu veröffentlichende Projekt an und wird an den publish-Befehl übergeben.For example when you execute dotnet publish my_app.csproj, the my_app.csproj argument indicates the project to publish and is passed to the publish command.

OptionenOptions

Die Optionen, die Sie in der Befehlszeile übergeben, sind die Optionen für den aufgerufenen Befehl.The options you pass on the command line are the options to the command invoked. Wenn Sie z.B. dotnet publish --output /build_output ausführen, werden die --output-Option und ihr Wert an den publish-Befehl übergeben.For example when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

Migration von project.jsonMigration from project.json

Wenn Sie Preview 2-Tools verwendet haben, um project.json-basierte Projekte zu erzeugen, finden Sie im Thema dotnet-migrate Informationen zur Migration eines Projekts zu MSBuild/.csproj für die Verwendung mit Versionstools.If you used Preview 2 tooling to produce project.json-based projects, consult the dotnet migrate topic for information on migrating your project to MSBuild/.csproj for use with release tooling. Für .NET Core-Projekte, die vor der Veröffentlichung der Preview 2-Tools erstellt wurden, aktualisieren Sie das Projekt entweder manuell anhand der Anweisungen in Migrieren von DNX zur .NET Core-CLI (project.json) und verwenden dann dotnet migrate oder führen direkt ein Upgrade für die Projekte durch.For .NET Core projects created prior to the release of Preview 2 tooling, either manually update the the project following the guidance in Migrating from DNX to .NET Core CLI (project.json) and then use dotnet migrate or directly upgrade your projects.

Siehe auchSee also

dotnet/CLI GitHub Repository (dotnet/CLI-GitHub-Repository)dotnet/CLI GitHub Repository
.NET Core installation guide (.NET Core-Installationshandbuch).NET Core installation guide