Compartir vía

Comando dotnet

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

Nombre

#D0: 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 (requiere la instalación del 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 <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Descripción

El dotnet comando 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 --help opción para imprimir una breve documentación sobre cómo usar el comando.

  • Ejecuta aplicaciones de .NET.

    Especifique la ruta de acceso a un archivo de aplicación .dll para ejecutar la aplicación. Para 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 #D0. Por ejemplo, dotnet myapp.dll ejecuta la myapp aplicación. Consulte Implementación de aplicaciones .NET para obtener información sobre las opciones de implementación.

Opciones

Hay diferentes opciones disponibles para:

  • Mostrar información sobre el entorno.
  • Ejecución de un comando.
  • Ejecución de 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í misma, sin especificar un comando o una aplicación que se va a ejecutar. Por ejemplo, dotnet --info o dotnet --version. Imprimen información sobre el entorno.

  • --info

    Imprime información detallada sobre una instalación de .NET y el entorno de máquina, como el sistema operativo actual, y confirma SHA de la versión de .NET.

  • --version

Imprime la versión del SDK de .NET que usan dotnet los comandos, lo que puede verse afectado por un archivo global.json . Solo está disponible cuando se instala el SDK.

  • --list-runtimes [--arch <ARCH>]

    Imprime una lista de los entornos de ejecución de .NET instalados para la arquitectura del invocado dotnet. Una versión x86 de dotnet solo enumera los entornos de ejecución x86 y una versión x64 de listas solo los entornos de dotnet ejecución x64.

    .NET 10 y versiones posteriores admiten el --arch argumento . Si se especifica y no es el mismo que la dotnet arquitectura, busca una instalación de .NET de la arquitectura especificada e imprime los tiempos de ejecución instalados allí. Los valores permitidos incluyen arm64, x64 y x86. El repositorio dotnet/runtime tiene la lista completa de valores de arquitectura válidos.

  • --list-sdks [--arch <ARCH>]

    Imprime una lista de los SDK de .NET instalados para la arquitectura del objeto invocado dotnet. Una versión x86 de dotnet listas solo sdk x86 y una versión x64 de dotnet listas solo SDK x64.

    .NET 10 y versiones posteriores admiten el --arch argumento . Si se especifica y no es el mismo que la dotnet arquitectura, busca una instalación de .NET de la arquitectura especificada e imprime los SDK instalados allí. Los valores permitidos incluyen arm64, x64 y x86. El repositorio dotnet/runtime tiene la lista completa de valores de arquitectura válidos.

  • -?|-h|--help

    Imprime una lista de comandos disponibles.

Opciones para ejecutar un comando

Las siguientes opciones son para 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]. No se admite en todos los comandos. Consulte la página de comandos específica para determinar si esta opción está disponible.

  • -?|-h|--help

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

  • command options

    Cada comando define opciones específicas de ese comando. Consulte 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 se ejecuta una aplicación. Por ejemplo: dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Ruta de acceso que contiene la directiva de sondeo y los ensamblados que se van a sondear. Repita la opción para especificar varias rutas de acceso.

  • --additional-deps <PATH>

    Ruta de acceso a un archivo de.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 abordar conflictos de ensamblados. Para obtener más información, consulte Archivos de configuración en tiempo de ejecución en GitHub.

  • --roll-forward <SETTING>

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

    • #D0: puesta al día a la versión de revisión más alta. Esto deshabilita la puesta al día de la versión secundaria.
    • #D0: reenvíe a la versión secundaria más baja, si falta la versión secundaria solicitada. Si la versión secundaria solicitada está presente, se usa la directiva LatestPatch.
    • #D0: reenvíe a la versión principal más baja y a la versión secundaria más baja, si falta la versión principal solicitada. Si la versión principal solicitada está presente, se usa la directiva Secundaria.
    • #D0: puesta al día a la versión secundaria más alta, incluso si está presente la versión secundaria solicitada. Diseñado para escenarios de hospedaje de componentes.
    • #D0: puesta al día a la versión principal y secundaria más alta, incluso si está presente la principal solicitada. Diseñado para escenarios de hospedaje de componentes.
    • #D0: no avance. Enlace solo a la versión especificada. Esta directiva no se recomienda para uso general, ya que deshabilita la capacidad de poner al día las revisiones más recientes. Este valor solo se recomienda para las pruebas.

    Con la excepción de Disable, toda la configuración usará la versión de revisión más alta disponible.

    El comportamiento de puesta al día también se puede configurar en una propiedad de archivo de proyecto, una propiedad de archivo de configuración en tiempo de ejecución y una variable de entorno. Para obtener más información, consulte Implementación del entorno de ejecución de la versión principal.

  • --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 invalida la versión de la primera referencia de marco en el archivo de .runtimeconfig.json 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 provocar errores.

Opciones para ejecutar una aplicación con el exec comando

Las siguientes opciones solo están disponibles cuando dotnet se ejecuta una aplicación mediante el exec comando . 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 dotnet

General

Comando Función
dotnet build Compila una aplicación .NET.
dotnet build-server Interactúa con los servidores iniciados por una compilación.
dotnet clean Limpiar las salidas de compilación.
dotnet exec Ejecuta una aplicación .NET.
dotnet help Muestra documentación más detallada en línea para el comando.
dotnet migrate Migra un proyecto de versión preliminar 2 válido a un proyecto de SDK de .NET Core 1.0.
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 NuGet del código.
dotnet publish Publica una aplicación independiente o dependiente de .NET Framework.
dotnet restore Restaura las dependencias de una aplicación determinada.
dotnet run Ejecuta la aplicación desde el origen.
comprobación del SDK de dotnet Muestra up-toestado de fecha del SDK instalado y las versiones en tiempo de ejecución.
dotnet sln Opciones para agregar, quitar y enumerar proyectos en un archivo de solución.
dotnet store Almacena ensamblados en el almacén de paquetes en tiempo de ejecución.
dotnet test Ejecuta pruebas mediante un ejecutor de pruebas.

Referencias de proyecto

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

Paquetes NuGet

Comando Función
dotnet package add Agrega un paquete NuGet.
dotnet package list Enumera los paquetes NuGet.
dotnet eliminar paquete Quita un paquete NuGet.
búsqueda de paquetes dotnet Busca un paquete NuGet.

Comandos de NuGet

Comando Función
dotnet nuget delete Elimina o anula la lista de un paquete del servidor.
inserción de dotnet nuget Inserta un paquete en el servidor y lo publica.
dotnet nuget locals Borra o enumera los recursos locales de NuGet, como la caché de solicitudes http, la caché temporal o la carpeta de paquetes globales 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.
origen de la lista de nuget dotnet Enumera todos los orígenes de NuGet configurados.
dotnet nuget remove source Quita un origen de NuGet.
origen de actualización de dotnet nuget Actualiza un origen de NuGet.

Comandos de carga de trabajo

Comando Función
dotnet workload install Instala una carga de trabajo opcional.
dotnet workload list Enumera todas las cargas de trabajo instaladas.
reparación de carga de trabajo dotnet Repara todas las cargas de trabajo instaladas.
búsqueda de carga de trabajo dotnet Enumere 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 globales, de ruta de acceso a herramientas y locales

Las herramientas son aplicaciones de consola que se instalan desde 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 conocen como herramientas globales, herramientas de ruta de herramientas y herramientas locales. Para obtener más información, vea la información general sobre las herramientas de .NET.

Comando Función
dotnet tool install Instala una herramienta en el equipo.
dotnet tool list Enumera todas las herramientas globales, de ruta de acceso de herramientas o locales instaladas actualmente en el equipo.
búsqueda de herramientas dotnet Busca NuGet.org herramientas que tengan el término de búsqueda especificado en su nombre o metadatos.
dotnet tool uninstall Desinstala una herramienta de la máquina.
dotnet tool update Actualiza una herramienta 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 secretos de usuario de desarrollo.
Reloj Un monitor de archivos que reinicia o recarga activa 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

Cree una nueva aplicación de consola de .NET:

dotnet new console

Compile 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