Vue d’ensemble de l’interface CLI .NET.NET CLI overview

Cet article s’applique à : ✔️ le kit de développement logiciel (SDK) .net Core 2,1 et versions ultérieuresThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

L’interface de ligne de commande (CLI) .NET est un chaîne d’outils multiplateforme pour le développement, la génération, l’exécution et la publication d’applications .NET.The .NET command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET applications.

L’interface CLI .NET est incluse avec le Kit de développement logiciel (SDK) .net.The .NET CLI is included with the .NET SDK. Pour savoir comment installer le kit de développement logiciel (SDK) .NET, consultez installer .net Core.To learn how to install the .NET SDK, see Install .NET Core.

Commandes CLICLI commands

Les commandes suivantes sont installées par défaut :The following commands are installed by default:

Commandes de baseBasic commands

Commandes de modification de projetProject modification commands

Commandes avancéesAdvanced commands

Commandes de gestion des outilsTool management commands

Les outils sont des applications console qui sont installées à partir de packages NuGet et sont appelées à partir de l’invite de commandes.Tools are console applications that are installed from NuGet packages and are invoked from the command prompt. Vous pouvez écrire vous-même des outils ou installer des outils écrits par des tiers.You can write tools yourself or install tools written by third parties. Les outils sont également appelés outils globaux, outils de chemin d’accès d’outil et outils locaux.Tools are also known as global tools, tool-path tools, and local tools. Pour plus d’informations, consultez vue d’ensemble des outils .net.For more information, see .NET tools overview.

Structure de commandeCommand structure

La structure de commande CLI se compose du pilote (« dotnet »), de la commande et éventuellement des arguments et options de la commande.CLI command structure consists of the driver ("dotnet"), the command, and possibly command arguments and options. Ce modèle apparaît dans la plupart des opérations de l’interface CLI, notamment la création d’une application console et son exécution à partir de la ligne de commande, comme le montrent les commandes suivantes, exécutées à partir d’un répertoire nommé my_app :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

PiloteDriver

Le pilote s’intitule dotnet et gère deux tâches : l’exécution d’une application dépendant du framework ou l’exécution d’une commande.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command.

Pour exécuter une application dépendant du framework, spécifiez l’application après le pilote, par exemple 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. Lors de l’exécution de la commande à partir du dossier où se trouve la DLL de l’application, vous devez simplement exécuter dotnet my_app.dll.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll. Si vous souhaitez utiliser une version spécifique du Runtime .NET, utilisez l' --fx-version <VERSION> option (consultez la référence de la commande dotnet ).If you want to use a specific version of the .NET Runtime, use the --fx-version <VERSION> option (see the dotnet command reference).

Lorsque vous fournissez une commande au pilote, dotnet.exe démarre le processus d’exécution de la commande CLI.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. Par exemple :For example:

dotnet build

D’abord, le pilote détermine la version du kit SDK à utiliser.First, the driver determines the version of the SDK to use. Si aucunglobal.jsn’est présent dans le fichier, la version la plus récente du kit de développement logiciel (SDK) disponible est utilisée.If there is no global.json file, the latest version of the SDK available is used. Il s’agit peut-être d’une préversion ou d’une version stable, selon la plus récente qui se trouve sur l’ordinateur.This might be either a preview or stable version, depending on what is latest on the machine. Une fois que la version du SDK est déterminée, elle exécute la commande.Once the SDK version is determined, it executes the command.

CommandeCommand

La commande exécute une action.The command performs an action. Par exemple, dotnet build génère le code.For example, dotnet build builds code. dotnet publish publie le code.dotnet publish publishes code. Les commandes sont implémentées comme une application console à l’aide d’une convention dotnet {command}.The commands are implemented as a console application using a dotnet {command} convention.

ArgumentsArguments

Les arguments que vous passez sur la ligne de commande sont les arguments de la commande appelée.The arguments you pass on the command line are the arguments to the command invoked. Par exemple, lorsque vous exécutez dotnet publish my_app.csproj , l' my_app.csproj argument indique le projet à publier et est passé à la publish commande.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.

OptionsOptions

Les options que vous passez sur la ligne de commande sont les options de la commande appelée.The options you pass on the command line are the options to the command invoked. Par exemple, lorsque vous exécutez dotnet publish --output /build_output , l' --output option et sa valeur sont passées à la publish commande.For example, when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

Voir aussiSee also