dotnet tool update

Artículo
03/19/2024

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

NOMBRE

dotnet tool update: actualiza la herramienta de .NET especificada en el equipo.

Sinopsis

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Descripción

El comando dotnet tool update permite actualizar las herramientas de .NET en el equipo a la versión estable más reciente del paquete. El comando desinstala y vuelve a instalar una herramienta, actualizándola de facto. Para usar el comando, especifique una de las siguientes opciones:

Para actualizar una herramienta global que se instaló en la ubicación predeterminada, use la opción --global.
Para actualizar una herramienta global que se instaló en una ubicación personalizada, use la opción --tool-path.
Para actualizar una herramienta local, use la opción --local.

Argumentos

PACKAGE_ID

Nombre o identificador del paquete NuGet que contiene la herramienta global de .NET que se va a actualizar. Para conocer el nombre el paquete, use el comando dotnet tool list.

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?.

--allow-downgrade

Permitir la degradación del paquete al instalar o actualizar un paquete de herramientas de .NET. Suprime la advertencia " La versión solicitada x.x.x es inferior a la versión x.x.x.x existente".

--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 la plataforma de destino para la que se actualiza la herramienta.
-g|--global

Especifica que la actualización es para una herramienta del ámbito de los usuarios. No se puede combinar con la opción --tool-path. Al omitir --global y --tool-path, se especifica que la herramienta que se va a actualizar es 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.
--prerelease

Incluir versiones preliminares.
--tool-manifest <PATH>

Ruta de acceso al archivo de manifiesto.
--tool-path <PATH>

Especifica la ubicación en la que está instalada la herramienta global. PATH puede ser una ruta absoluta o relativa. No se puede combinar con la opción --global. Al omitir --global y --tool-path, se especifica que la herramienta que se va a actualizar es 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>

El intervalo de versiones del paquete de herramientas al que se actualiza. Esto no se puede usar para degradar versiones, primero debe uninstall versiones más recientes.

A partir de .NET 8.0, --version Major.Minor.Patch hace referencia a una versión específica principal.secundaria.revisión, incluidas las versiones no incluidas en la lista. Para obtener la última versión de una determinada versión principal.secundaria en su lugar, use --version Major.Minor.*.

Ejemplos

dotnet tool update -g dotnetsay

Actualiza la herramienta global dotnetsay.
dotnet tool update dotnetsay --tool-path c:\global-tools

Actualiza la herramienta global dotnetsay ubicada en un directorio específico de Windows.
dotnet tool update dotnetsay --tool-path ~/bin

Actualiza la herramienta global dotnetsay ubicada en un directorio específico de Linux/macOS.
dotnet tool update dotnetsay

Actualiza la herramienta local dotnetsay instalada para el directorio actual.
dotnet tool update -g dotnetsay --version 2.0.*

Actualiza la herramienta global dotnetsay a la última versión de revisión, con una versión principal de 2 y una versión secundaria de 0.
dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

Actualiza la herramienta global dotnetsay a la versión más baja del intervalo especificado (> 2.0.0 && < 2.1.4); se instalará la versión 2.1.0. Para obtener más información sobre los intervalos de versiones semánticas, consulte Intervalos de versiones de empaquetado de NuGet.