Información general sobre la CLI de .NET Core.NET Core CLI overview

Este artículo se aplica a: ✔️ SDK de .NET Core 2.1 y versiones posterioresThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

La interfaz de la línea de comandos (CLI) de .NET Core es una cadena de herramientas multiplataforma para desarrollar, compilar, ejecutar y publicar aplicaciones .NET Core.The .NET Core command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET Core applications.

La CLI de .NET Core se incluye con el SDK de .NET Core.The .NET Core CLI is included with the .NET Core SDK. Para más información sobre cómo instalar el SDK de .NET Core, consulte Instalación de .NET Core.To learn how to install the .NET Core SDK, see Install .NET Core.

Comandos de la CLICLI commands

De forma predeterminada, se instalan los siguientes comandos:The following commands are installed by default:

Comandos básicosBasic commands

Comandos de modificación del proyectoProject modification commands

Comandos avanzadosAdvanced commands

Comandos de administración de herramientasTool management commands

Las herramientas son aplicaciones de consola que se instalan mediante paquetes NuGet y se invocan desde el símbolo del sistema.Tools are console applications that are installed from NuGet packages and are invoked from the command prompt. Puede encargarse de escribir las herramientas o instalar las escritas por terceros.You can write tools yourself or install tools written by third parties. Las herramientas también se denominan herramientas globales, herramientas de ruta de acceso de herramientas y herramientas locales.Tools are also known as global tools, tool-path tools, and local tools. Para obtener más información, vea Información general sobre las herramientas de .NET Core.For more information, see .NET Core tools overview.

Estructura de comandosCommand structure

La estructura de comandos de la CLI consta del controlador ("dotnet"), el comando y posiblemente de los argumentos de comandos y otras opciones.CLI command structure consists of the driver ("dotnet"), the command, and possibly command arguments and options. Este patrón se puede ver en la mayoría de las operaciones de la CLI, como la creación de una nueva aplicación de consola y su ejecución desde la línea de comandos, como muestran los siguientes comandos cuando se ejecutan desde un directorio denominado 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

ControladorDriver

El controlador se denomina dotnet y tiene dos responsabilidades, ejecutar una aplicación dependiente del marco o ejecutar un comando.The driver is named dotnet and has two responsibilities, either running a framework-dependent app or executing a command.

Para ejecutar una aplicación dependiente del marco, especifique la aplicación después del controlador, por ejemplo, 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. Cuando ejecute el comando desde la carpeta donde reside la DLL de la aplicación, simplemente ejecute dotnet my_app.dll.When executing the command from the folder where the app's DLL resides, simply execute dotnet my_app.dll. Si quiere usar una versión específica del entorno de ejecución .NET Core, use la opción --fx-version <VERSION> (consulte la referencia del comando dotnet).If you want to use a specific version of the .NET Core Runtime, use the --fx-version <VERSION> option (see the dotnet command reference).

Cuando se proporciona un comando para el controlador, dotnet.exe inicia el proceso de ejecución del comando de la CLI.When you supply a command to the driver, dotnet.exe starts the CLI command execution process. Por ejemplo:For example:

dotnet build

En primer lugar, el controlador determina la versión de SDK que se debe usar.First, the driver determines the version of the SDK to use. Si no hay ningún archivo global.json, se usa la última versión del SDK disponible.If there is no global.json file, the latest version of the SDK available is used. Podría tratarse de una versión preliminar o de una versión estable, en función de lo último que esté disponible en el equipo.This might be either a preview or stable version, depending on what is latest on the machine. Una vez determinada la versión del SDK, se ejecutará el comando.Once the SDK version is determined, it executes the command.

ComandoCommand

El comando realiza una acción.The command performs an action. Por ejemplo, dotnet build compila código.For example, dotnet build builds code. dotnet publish publica el código.dotnet publish publishes code. Los comandos se implementan como una aplicación de consola usando una convención dotnet {command}.The commands are implemented as a console application using a dotnet {command} convention.

ArgumentosArguments

Los argumentos que se pasan en la línea de comandos son los argumentos para el comando invocado.The arguments you pass on the command line are the arguments to the command invoked. Por ejemplo, cuando ejecuta dotnet publish my_app.csproj, el argumento my_app.csproj indica el proyecto que se publicará y se pasa al comando publish.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.

OpcionesOptions

Las opciones que se pasan en la línea de comandos son las opciones para el comando que se invoca.The options you pass on the command line are the options to the command invoked. Por ejemplo, cuando ejecuta dotnet publish --output /build_output, la opción --output y su valor se pasan al comando publish.For example, when you execute dotnet publish --output /build_output, the --output option and its value are passed to the publish command.

Vea tambiénSee also