Comando upgrade (winget)

El comando de actualización de la herramienta WinGet actualiza la aplicación especificada. De manera opcional, puede usar el comando list para identificar la aplicación que quiere actualizar.

El comando upgrade requiere que especifique la cadena exacta que quiere actualizar. Si hay alguna ambigüedad, se le pedirá que filtre aún más el comando upgrade a una aplicación exacta.

Alias

Los alias siguientes están disponibles para este comando:

• actualización

Uso

winget upgrade [[-q] <query> ...] [<options>]

Argumentos

Están disponibles los siguientes argumentos.

Argumento	Descripción
-q,--query	Consulta usada para buscar una aplicación.

Nota

El argumento de consulta es posicional. No se admite la sintaxis de estilo de comodín. Esta suele ser la cadena de caracteres que espera que le ayude a encontrar el paquete que va a actualizar.

Opciones

Las opciones le permiten personalizar la experiencia de actualización para satisfacer sus necesidades.

Opción	Descripción
-m, --manifest	Debe ir seguido de la ruta de acceso al archivo de manifiesto (YAML). Puedes usar el manifiesto para ejecutar la experiencia de actualización desde un archivo YAML local.
--id	Limita la actualización al identificador de la aplicación.
--nombre	Limita la búsqueda al nombre de la aplicación.
--moniker	Limita la búsqueda al moniker que se muestra para la aplicación.
-v, --version	Le permite especificar la versión exacta que se va a actualizar. Si no se especifica, se actualizará a la aplicación con la versión más reciente.
-s,--source	Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen.
-e, --exact	Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena.
-i, --interactive	Ejecuta el instalador en modo interactivo. La experiencia predeterminada muestra el progreso del instalador.
-h, --silent	Ejecuta el instalador en modo silencioso. Suprime toda la interfaz de usuario. La experiencia predeterminada muestra el progreso del instalador.
--purge	Elimina todos los archivos y directorios del directorio del paquete (portable)
-o, --log	Dirige el registro a un archivo de registro. Tienes que indicar una ruta de acceso a un archivo al que tengas derechos de escritura.
--custom	Argumentos que se pasarán al instalador además de los predeterminados.
--override	Cadena que se pasará directamente al instalador.
-l, --ubicación	Ubicación donde se va a actualizar (si se admite).
--scope	Seleccione el filtro de ámbito de paquetes instalados (usuario o máquina).
a, --architecture	Permite seleccionar la arquitectura que se va a instalar.
--installer-type	Seleccione el tipo de instalador que se va a actualizar. Consulte los tipos de instalador admitidos para el cliente WinGet.
--locale	Especifica la configuración regional que se va a usar (formato BCP47).
--ignore-security-hash	Ignora el fallo de comprobación hash del instalador. No se recomienda.
--allow-reboot	Permite un reinicio si procede.
--skip-dependencies	Omite el procesamiento de dependencias del paquete y las características de Windows.
--ignore-local-archive-malware-scan	Ignora el análisis de malware realizado como parte de la instalación de un paquete de tipo archivo desde el manifiesto local.
--accept-package-agreements	Se usa para aceptar el contrato de licencia y evitar el aviso.
--accept-source-agreements	Se usa para aceptar el contrato de licencia de origen y evitar el aviso.
--cabecera	Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--authentication-mode	Especifique la preferencia de ventana de autenticación (silenciosa, PreferenciaSilenciosa o interactiva).
--authentication-account	Especifique la cuenta que se utilizará para la autenticación.
-r, --recurse, --all	Actualice todos los paquetes instalados a la versión más reciente si está disponible.
-u, --unknown, --include-unknown	Permite actualizar los paquetes incluso cuando no se puede determinar su versión actual.
--pinned,--include-pinned	Actualice los paquetes aunque tengan un pin de no bloqueo.
--uninstall-previous	Desinstale la versión anterior del paquete durante la actualización. El comportamiento dependerá del paquete individual. Algunos instaladores están diseñados para instalar nuevas versiones en paralelo. Algunos instaladores incluyen un manifiesto que especifica "uninstallPrevious", por lo que las versiones anteriores se desinstalan sin necesidad de usar esta marca de comando. En este caso, el uso del comando winget upgrade --uninstall-previous indicará a WinGet que desinstale la versión anterior independientemente de lo que se encuentra en el manifiesto del paquete. Si el manifiesto del paquete no incluye "uninstallPrevious" y no se usa la marca --uninstall-previous, se aplicará el comportamiento predeterminado del instalador.
--force	Ejecute directamente el comando y continúe con incidencias no relacionadas con la seguridad.
-?--Ayuda	Muestra la ayuda del comando seleccionado.
--esperar	Pide al usuario que presione cualquier tecla antes de salir.
--logs,--open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita los mensajes interactivos.
--proxy	Establezca un proxy que se usará para esta ejecución.
--no-proxy	Deshabilite el uso de proxy para esta ejecución.

Consultas de ejemplo

En el ejemplo siguiente se enumeran las aplicaciones con una actualización disponible.

winget upgrade

En el ejemplo siguiente se actualiza una versión específica de una aplicación.

winget upgrade powertoys --version 0.15.2

En el ejemplo siguiente se actualiza una aplicación a partir de su identificador.

winget upgrade --id Microsoft.PowerToys

En el ejemplo siguiente se muestra cómo actualizar todas las aplicaciones.

winget upgrade --all

En el ejemplo siguiente se actualizarán varias aplicaciones.

winget upgrade Microsoft.Edit Microsoft.NuGet

Uso de upgrade

Para identificar qué aplicaciones necesitan una actualización, simplemente use upgrade sin ningún argumento para mostrar todas las actualizaciones disponibles.

upgrade --all

upgrade --all detectará todas las aplicaciones con actualizaciones disponibles. Al ejecutar winglet upgrade --all, el Administrador de paquetes de Windows buscará todas las aplicaciones que tengan actualizaciones disponibles e intentará actualizarlas.

Nota

Algunas aplicaciones no indican una versión. Siempre son las más recientes. Dado que el Administrador de paquetes de Windows no puede identificar si hay una versión más reciente de la aplicación, no se podrá actualizar a menos que se especifique la opción -u, --unknown, --include-unknown

Nota

Es posible que algunas aplicaciones se hayan anclado mediante WinGet y no se actualizarán si se especifica la opción --all a menos que se especifique la opción --include-pinned . En este caso, solo se actualizarán los pines no bloqueantes de las aplicaciones.

upgrade --desinstalar-anterior

upgrade --uninstall-previous desinstalará la versión anterior antes de instalar la versión más reciente del paquete. Al usar --uninstall-previous, el comportamiento dependerá del paquete individual. Algunos instaladores están diseñados para instalar nuevas versiones en paralelo, mientras que otros instaladores incluyen un manifiesto que especifica uninstallPrevious como su comportamiento de actualización predeterminado (por lo que las versiones anteriores se desinstalan sin necesidad de usar la marca de comandos).

Si el manifiesto de paquete no incluye uninstallPrevious como comportamiento de actualización y la marca --uninstall-previous no se usa con el comando upgrade, se aplicará el comportamiento predeterminado para el instalador.