Compartir vía

Información general sobre la CLI de .NET

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

La interfaz de la línea de comandos (CLI) de .NET es una cadena de herramientas multiplataforma que sirve para desarrollar, compilar, ejecutar y publicar aplicaciones .NET.

La CLI de .NET se incluye con el SDK de .NET. Para obtener más información sobre cómo instalar el SDK de .NET, consulte Instalación de .NET. Después de instalar el SDK, puede ejecutar comandos de la CLI abriendo una terminal y escribiendo los comandos en el terminal de comandos.

Estructura de comandos

La estructura de comandos de la CLI consta del controlador ("dotnet"),el comando y, posiblemente, los argumentos y opciones de comando. Verá este patrón en la mayoría de las operaciones de la CLI, como crear una nueva aplicación de consola y ejecutarlo desde la línea de comandos. Los siguientes comandos muestran cuándo se ejecutó la aplicación de consola desde un directorio denominado my_app:

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

Controlador

El controlador se denomina dotnet y tiene dos responsabilidades, ya sea ejecutando una aplicación dependiente del marco o ejecutando un comando.

Para ejecutar una aplicación dependiente del marco, especifique la ruta de acceso al archivo .dll de la aplicación después del controlador sin especificar un comando, por ejemplo, dotnet /path/to/my_app.dll. Al ejecutar el comando desde la carpeta donde reside el archivo DLL de la aplicación, simplemente ejecute dotnet my_app.dll. Para obtener más información, consulte el comando dotnet.

Al proporcionar un comando al controlador, dotnet.exe inicia el proceso de ejecución de comandos de la CLI. Por ejemplo:

dotnet build

En primer lugar, el controlador determina la versión del SDK que se va a usar. Si no hay ningún archivo global.json , se usa la versión más reciente del SDK disponible. Una vez determinada la versión del SDK, ejecuta el comando .

Comando

El comando realiza una acción. Por ejemplo, dotnet build compila código. dotnet publish publica código. Consulte la sección Comandos de la CLI para obtener una lista de comandos.

Argumentos

Los argumentos que se pasan en la línea de comandos son los argumentos al comando invocado o a las opciones especificadas con el comando . Por ejemplo, cuando se ejecuta dotnet publish my_app.csproj, el my_app.csproj argumento indica el proyecto que se va a publicar y se pasa al publish comando .

Opciones

Las opciones que se pasan en la línea de comandos son las opciones para el comando invocado. Por ejemplo, al ejecutar dotnet publish --output /build_output, la --output opción y su valor proporcionado por el /build_output argumento se pasan al publish comando .

Comandos de la CLI

Los siguientes comandos se instalan de forma predeterminada:

Comandos básicos

Comandos de modificación del proyecto

Comandos de NuGet

Comandos de administración de cargas de trabajo

Comandos avanzados

Comandos de administración de herramientas

Las herramientas son aplicaciones de consola que se instalan mediante paquetes NuGet y se invocan desde el símbolo del sistema. Puede escribir herramientas usted mismo o instalar herramientas escritas por terceros. Las herramientas también se denominan herramientas globales, herramientas de ruta de acceso de herramientas y herramientas locales. Para obtener más información, vea la información general sobre las herramientas de .NET.

Consulte también