dotnet tool install

  • Artículo
  • 2 minutos para leer

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

NOMBRE

dotnet tool install: instala la herramienta de .NET especificada en el equipo.

Sinopsis

dotnet tool install <PACKAGE_NAME> -g|--global
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Descripción

El comando dotnet tool install permite instalar herramientas de .NET en el equipo. Para usar el comando, especifique una de las siguientes opciones de instalación:

  • Para instalar una herramienta global en la ubicación predeterminada, use la opción --global.
  • Para instalar una herramienta global en una ubicación personalizada, use la opción --tool-path.
  • Para instalar una herramienta local, omita las opciones --global y --tool-path.

Las herramientas locales están disponibles a partir del SDK de .NET Core 3.0.

Las herramientas globales se instalan en los siguientes directorios de forma predeterminada cuando se especifica la opción -g o --global:

SO Ruta de acceso
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Las herramientas locales se agregan a un archivo dotnet-tools.json en un directorio .config en el directorio actual. Si aún no existe un archivo de manifiesto, créelo ejecutando el siguiente comando:

dotnet new tool-manifest

Para obtener más información, vea Instalación de una herramienta local.

Argumentos

  • PACKAGE_NAME

    Nombre o identificador del paquete NuGet que contiene la herramienta de .NET que se va a instalar.

Opciones

  • --add-source <SOURCE>

    Agrega un origen de paquete NuGet adicional que se usará durante la instalación. Se accede a las fuentes en paralelo, y no de forma secuencial en un orden de prioridad. Si el mismo paquete y versión se encuentra en varias fuentes, se usa la fuente más rápida. Para obtener más información, consulte ¿Qué ocurre cuando se instala un paquete NuGet?.

  • --configfile <FILE>

    Archivo de configuración de NuGet (nuget.config) que se va a usar. Si se especifica, solo se usará la configuración de este archivo. Si no se especifica, se utilizará la jerarquía de archivos de configuración del directorio actual. Para más información, consulte Configuraciones comunes de NuGet.

  • --disable-parallel

    Impide que se restauren varios proyectos en paralelo.

  • --framework <FRAMEWORK>

    Especifica el marco de destino para instalar la herramienta. De forma predeterminada, el SDK de .NET intenta elegir la plataforma de destino más apropiada.

  • -g|--global

    Especifica que la instalación se realiza en todos los usuarios. No se puede combinar con la opción --tool-path. Al omitir --global y --tool-path, se especifica la instalación de una herramienta local.

  • -?|-h|--help

    Imprime una descripción de cómo usar el comando.

  • --ignore-failed-sources

    Indica que los errores de origen de paquete se traten como advertencias.

  • --interactive

    Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación.

  • --local

    Actualice la herramienta y el manifiesto de la herramienta local. No se puede combinar con las opciones --global o --tool-path.

  • --no-cache

    Indica que no se almacenen en caché los paquetes ni las solicitudes HTTP.

  • --tool-manifest <PATH>

    Ruta de acceso al archivo de manifiesto.

  • --tool-path <PATH>

    Especifica la ubicación de donde se tiene que instalar la herramienta global. PATH puede ser una ruta absoluta o relativa. Si la ruta no existe, el comando intenta crearla. Al omitir --global y --tool-path, se especifica la instalación de una herramienta local.

  • -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]. Para obtener más información, vea LoggerVerbosity.

  • --version <VERSION_NUMBER>

    La versión de la herramienta que se va instalar. De forma predeterminada, se instala la versión estable más reciente del paquete. Utilice esta opción para instalar la versión preliminar o versiones anteriores de la herramienta.

Ejemplos

  • dotnet tool install -g dotnetsay

    Instala dotnetsay como herramienta global en la ubicación predeterminada.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Instala dotnetsay como herramienta global en un directorio específico de Windows.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Instala dotnetsay como herramienta global en un directorio específico de Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Instala la versión 2.0.0 de dotnetsay como la herramienta global.

  • dotnet tool install dotnetsay

    Instala dotnetsay como herramienta local del directorio actual.

Vea también