comando dotnet

  • Artículo

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

NOMBRE

dotnet: controlador genérico de la CLI de .NET.

Sinopsis

Para obtener información sobre los comandos disponibles y el entorno:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Para ejecutar un comando (se requiere la instalación de un SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Para ejecutar una aplicación:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Descripción

El comando dotnet tiene dos funciones:

  • Proporciona comandos para trabajar con proyectos de .NET.

    Por ejemplo, dotnet build compila un proyecto. Cada comando define sus propias opciones y argumentos. Todos los comandos admiten la opción --help para ver una breve documentación sobre cómo usar el comando.

  • Ejecuta aplicaciones de .NET.

    Hay que especificar la ruta de acceso al archivo .dll de una aplicación para poder ejecutarla. Ejecutar la aplicación significa buscar y ejecutar el punto de entrada, que en el caso de las aplicaciones de consola es el método Main. Por ejemplo, dotnet myapp.dll ejecuta la aplicación myapp. Vea Implementación de aplicaciones de .NET para obtener información sobre las opciones de implementación.

Opciones

Hay diferentes opciones disponibles para:

  • Mostrar información sobre el entorno.
  • Ejecutar un comando.
  • Ejecutar una aplicación.

Opciones para mostrar información del entorno y comandos disponibles

Las siguientes opciones están disponibles cuando dotnet se usa por sí mismo, sin especificar que se ejecute un comando o una aplicación.  Por ejemplo, dotnet --info o dotnet --version. Muestran información sobre el entorno.

  • --info

    Imprime información detallada sobre una instalación de .NET y el entorno del equipo, por ejemplo, el sistema operativo actual y el SHA de confirmación de la versión de .NET.

  • --version

Imprime la versión del SDK de .NET que usan los comandos dotnet, que pueden verse afectados por un archivo global.json. Esto solo está disponible cuando se instala el SDK.

  • --list-runtimes

    Imprime una lista de los entornos de ejecución de .NET instalados. Una versión x86 del SDK muestra solo los runtime x86 y una versión x64 solo los runtime x64.

  • --list-sdks

    Imprime una lista de los SDK de .NET instalados.

  • -?|-h|--help

    Muestra una lista de los comandos disponibles.

Opciones para ejecutar un comando

Las siguientes opciones son para usar dotnet con un comando.  Por ejemplo, dotnet build --help o dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Habilita la salida de diagnóstico.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. Estos no se admiten en todos los comandos. Vea la página específica de cada comando para asegurarse de que la opción está disponible.

  • -?|-h|--help

    Imprime la documentación de un comando determinado. Por ejemplo, dotnet build --help muestra ayuda para el comando build.

  • command options

    Cada comando define opciones específicas de ese comando. Vea la página de comandos específica para obtener una lista de las opciones disponibles.

Opciones para ejecutar una aplicación

Las siguientes opciones están disponibles cuando dotnet ejecuta una aplicación. Por ejemplo: dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Ruta de acceso que contiene directivas de sondeo y ensamblados para sondear. Repita la opción para especificar varias rutas de acceso.

  • --additional-deps <PATH>

    Ruta de acceso a un archivo .deps.json adicional. Un archivo deps.json contiene una lista de dependencias, dependencias de compilación e información de versión que se usa para resolver conflictos de ensamblado. Para más información, vea Runtime Configuration Files (Archivos de configuración en tiempo de ejecución) en GitHub.

  • --roll-forward <SETTING>

    Controla cómo se aplica la puesta al día en la aplicación. SETTING puede tener uno de los valores siguientes. Si no se especifica, el valor predeterminado es Minor.

    • LatestPatch: la aplicación se pone al día con la última versión de revisión. Se deshabilita la puesta al día de versiones secundarias.
    • Minor: la aplicación se pone al día con la versión secundaria mínima superior, si no se encuentra la versión secundaria solicitada. Si se encuentra la versión secundaria solicitada, se utiliza la directiva LatestPatch.
    • Major: la aplicación se pone al día con la versión secundaria mínima superior, y con la versión secundaria mínima si no se encuentra la versión secundaria solicitada. Si se encuentra la versión principal solicitada, se utiliza la directiva Minor.
    • LatestMinor: la aplicación e pone al día con la última versión secundaria, aunque la versión secundaria solicitada esté presente. Se destina a escenarios de hospedaje de componentes.
    • LatestMajor: la aplicación se pone al día con la última versión principal y la última versión secundaria, aunque la versión principal solicitada esté presente. Se destina a escenarios de hospedaje de componentes.
    • Disable: la aplicación no se pone al día. Solo se enlaza a la versión especificada. No se recomienda esta directiva para uso general, ya que deshabilita la capacidad de puesta al día con las revisiones más recientes. Este valor solo se recomienda a efectos de pruebas.

    A excepción de Disable, todos los valores usarán la última versión de revisión disponible.

    El comportamiento de puesta al día también se puede configurar en una propiedad de archivo de proyecto, en una propiedad de archivo de configuración de ejecución y en una variable de entorno. Para obtener más información, vea Puesta al día del runtime de versiones principales.

  • --fx-version <VERSION>

    Versión del entorno de ejecución de .NET que se va a usar para ejecutar la aplicación.

    Esta opción reemplaza la versión de la primera referencia de marco en el archivo .runtimeconfig.json de la aplicación. Esto significa que solo funciona según lo esperado si solo hay una referencia de marco. Si la aplicación tiene más de una referencia de marco, el uso de esta opción puede hacer que se produzcan errores.

Opciones para ejecutar una aplicación con el comando exec

Las siguientes opciones solo están disponibles cuando dotnet ejecuta una aplicación mediante el comando exec. Por ejemplo, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Ruta de acceso a un archivo deps.json. Un archivo deps.json es un archivo de configuración que contiene información sobre las dependencias necesarias para ejecutar la aplicación. El SDK de .NET genera este archivo.

  • --runtimeconfig <PATH>

    Ruta de acceso a un archivo runtimeconfig.json. Un archivo runtimeconfig.json contiene la configuración en tiempo de ejecución y normalmente se denomina <applicationname>.runtimeconfig.json. Para obtener más información, consulte Opciones de configuración de entornos de ejecución de .NET.

comandos de dotnet

General

Comando Función
dotnet build Compila una aplicación de .NET.
dotnet build-server Interactúa con servidores iniciados por una compilación.
dotnet clean Limpia las salidas de la compilación.
dotnet exec Ejecuta una aplicación de .NET.
dotnet help Muestra documentación más detallada en línea sobre el comando.
dotnet migrate Migra un proyecto de Preview 2 válido a un proyecto del SDK 1.0 de .NET Core.
dotnet msbuild Proporciona acceso a la línea de comandos de MSBuild.
dotnet new Inicializa un proyecto de C# o F# para una plantilla determinada.
dotnet pack Crea un paquete de NuGet de su código.
dotnet publish Publica una aplicación dependiente del maco .NET o autocontenida.
dotnet restore Restaura las dependencias de una aplicación determinada.
dotnet run Ejecuta la aplicación desde el origen.
dotnet sdk check Muestra el estado actualizado de las versiones instaladas del SDK y el entorno de ejecución.
dotnet sln Opciones para agregar, quitar y mostrar proyectos en un archivo de solución.
dotnet store Almacena ensamblados en el almacenamiento de paquetes en tiempo de ejecución.
dotnet test Ejecuta pruebas usando un ejecutor de pruebas.

Referencias de proyecto

Comando Función
dotnet add reference Agrega una referencia de proyecto.
dotnet list reference Enumera referencias de proyecto.
dotnet remove reference Quita una referencia de proyecto.

Paquetes NuGet

Comando Función
dotnet add package Agrega un paquete NuGet.
dotnet remove package Quita un paquete NuGet.

Comandos NuGet

Comando Función
dotnet nuget delete Elimina o quita de la lista un paquete del servidor.
dotnet nuget push Inserta un paquete en el servidor y lo publica.
dotnet nuget locals Borra o muestra los recursos de NuGet locales, como la caché de solicitudes http, la caché temporal o la carpeta de paquetes global de toda la máquina.
dotnet nuget add source Agrega un origen de NuGet.
dotnet nuget disable source Deshabilita un origen de NuGet.
dotnet nuget enable source Habilita un origen de NuGet.
dotnet nuget list source Enumera todos los orígenes de NuGet configurados.
dotnet nuget remove source Quita un origen de NuGet.
dotnet nuget update source Actualiza un origen de NuGet.

Comandos de cargas de trabajo

Comando Función
dotnet workload install Instala una carga de trabajo opcional.
dotnet workload list Enumera todas las cargas de trabajo instaladas.
dotnet workload repair Repara todas las cargas de trabajo instaladas.
dotnet workload search Enumera las cargas de trabajo seleccionadas o todas las cargas de trabajo disponibles.
dotnet workload uninstall Desinstala una carga de trabajo.
dotnet workload update Vuelve a instalar todas las cargas de trabajo instaladas.

Comandos de herramientas locales, globales y de ruta de acceso de herramientas

Las herramientas son aplicaciones de consola que se instalan mediante paquetes NuGet y se invocan desde el símbolo del sistema. Puede encargarse de escribir las herramientas o instalar las 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.

Get-Help Función
dotnet tool install Instala una herramienta en el equipo.
dotnet tool list Muestra todas las herramientas globales, de ruta de acceso de herramientas o locales instaladas actualmente en el equipo.
dotnet tool search Busca en NuGet.org herramientas que tengan el término de búsqueda especificado en el nombre o los metadatos.
dotnet tool uninstall Desinstala una herramienta del equipo.
dotnet tool update Actualiza una herramienta que está instalada en el equipo.

Herramientas adicionales

Las siguientes herramientas adicionales están disponibles como parte del SDK de .NET:

Herramienta Función
dev-certs Crea y administra certificados de desarrollo.
ef Herramientas de línea de comandos de Entity Framework Core.
user-secrets Administra los secretos del usuario de desarrollo.
watch Un monitor de archivos que reinicia o realiza una recarga activa de una aplicación cuando detecta cambios en el código fuente.

Para obtener más información sobre cada herramienta, escriba dotnet <tool-name> --help.

Ejemplos

Creación de una aplicación de consola de .NET:

dotnet new console

Compilación de un proyecto y sus dependencias en un directorio determinado:

dotnet build

Ejecute una aplicación:

dotnet exec myapp.dll

dotnet myapp.dll

Consulte también