dotnet tool update (actualizar herramienta de dotnet)

2025-06-19

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

Nombre

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

Sinopsis

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--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>] [--all] [--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>] [--all] [--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 dotnet tool update comando proporciona una manera de 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, lo actualiza de forma eficaz. 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 --tool-path opción .
Para actualizar una herramienta local, use la --local opción .

Argumentos

PACKAGE_ID

Nombre o identificador del paquete NuGet que contiene la herramienta global de .NET que se va a actualizar. Puede encontrar el nombre del paquete mediante 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?.

--all

Actualice todas las herramientas.

--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 va a actualizar la herramienta.
-g|--global

Especifica que la actualización es para una herramienta de todo el usuario. No se puede combinar con la opción --tool-path. Omitir y --global--tool-path 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

No almacene en caché paquetes ni solicitudes HTTP.
--prerelease

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

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

Especifica la ubicación donde está instalada la herramienta global. PATH puede ser una ruta absoluta o relativa. No se puede combinar con la opción --global. Omitir y --global--tool-path 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, consulte LoggerVerbosity.

--version <VERSION>

Intervalo de versiones del paquete de herramientas al que se va a actualizar. No se puede usar para degradar las versiones, primero debe uninstall realizar versiones más recientes.

A partir de .NET 8.0, --version Major.Minor.Patch hace referencia a una versión principal.secundaria.patch específica, incluidas las versiones no incluidas en la lista. Para obtener la versión más reciente de una versión principal.secundaria determinada, 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 versión de revisión más reciente, con una versión principal de 2y 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 dentro del intervalo (> 2.0.0 && < 2.1.4)especificado, se instalaría la versión 2.1.0 . Para obtener más información sobre los intervalos de control de versiones semánticos, consulte Intervalos de versiones de empaquetado de NuGet.

Compartir vía