Uso de la herramienta winget para instalar y administrar aplicaciones

La herramienta de línea de comandos winget permite a los usuarios detectar, instalar, actualizar, quitar y configurar aplicaciones en equipos con Windows 10 y Windows 11. Esta herramienta es la interfaz cliente para el servicio del Administrador de paquetes de Windows.

Instalación de winget

La herramienta de línea de comandos WinGet del Administrador de paquetes de Windows se incluye con Windows 11 y las versiones modernas de Windows 10 de forma predeterminada como Instalador de aplicación.

Si ejecuta una versión anterior de Windows y el Instalador de aplicaciones no está instalado, puede obtener el Instalador de aplicaciones en Microsoft Store. Si ya está instalado, asegúrese de lo tiene actualizado a la versión más reciente.

El Instalador de aplicaciones incluye la versión de producción de la herramienta WinGet.

Nota

Actualmente, la herramienta de línea de comandos winget solo se admite en Windows 10 1709 (compilación 16299) o posterior.

Instalación de la versión preliminar de WinGet [solo para desarrolladores]

Para probar las características del Administrador de paquetes de Windows más recientes, instale la versión preliminar más reciente de la herramienta de línea de comandos WinGet de una de las maneras siguientes:

Consideraciones para administradores

El comportamiento del instalador puede variar en función de si ejecutas winget con privilegios de administrador.

  • Al ejecutar winget sin privilegios de administrador, es posible que algunas aplicaciones requieran una elevación de privilegios para instalarse. Cuando se ejecute el instalador, Windows te pedirá que eleves los privilegios. Si decides no elevar los privilegios, la aplicación no se instalará.

  • Al ejecutar winget en un símbolo del sistema de administrador, no verás peticiones de elevación si la aplicación lo requiere. Siempre debes tener cuidado al ejecutar el símbolo del sistema como administrador y solo instalar las aplicaciones en las que confíes.

Uso de winget

Después de instalar Instalador de aplicación, puedes ejecutar winget si escribes "winget" desde un símbolo del sistema.

Uno de los escenarios de uso más comunes es buscar e instalar una herramienta favorita.

  1. Para buscar una herramienta, escribe winget search <appname>.

  2. Una vez que hayas confirmado que la herramienta que quieres está disponible, puedes instalar la herramienta escribiendo winget install <appname>. La herramienta winget iniciará el instalador e instalará la aplicación en tu PC. Línea de comandos de winget

  3. Además de instalar y buscar, winget ofrece una serie de comandos que te permiten mostrar los detalles de las aplicaciones, cambiar de orígenes y validar los paquetes. Para obtener una lista completa de comandos, escribe: winget --help. Ayuda de winget

Algunos usuarios han notificado problemas con el cliente, ya que no estaba en su ruta de acceso correspondiente.

Comandos

La versión preliminar actual de la herramienta winget admite los siguientes comandos.

Comando Descripción
info Muestra metadatos sobre el sistema (números de versión, arquitectura, ubicación de registro, etc.). Resulta útil para solucionar problemas.
install Instala la aplicación especificada.
show Muestra los detalles de la aplicación especificada.
source Agrega, quita y actualiza los repositorios del Administrador de paquetes de Windows a los que accede la herramienta winget.
search Busca una aplicación.
list Muestra los paquetes instalados.
upgrade Actualiza el paquete dado.
uninstall Desinstala el paquete dado.
hash Genera el hash SHA256 para el instalador.
validate Valida un archivo de manifiesto para enviarlo al repositorio del Administrador de paquetes de Windows.
settings Abre la configuración.
features Muestra el estado de las características experimentales.
export Exporta una lista de los paquetes instalados.
import Instala todos los paquetes de un archivo.

Opciones

La herramienta winget admite las opciones siguientes.

Opción Descripción
-v, --version Devuelve la versión actual de winget.
--info Brinda toda la información detallada sobre winget, incluidos los vínculos a la licencia, la declaración de privacidad y las directivas de grupo configuradas.
-?, --help Muestra ayuda adicional para winget.

Formatos de instalador admitidos

La herramienta winget admite los siguientes tipos de instaladores:

  • EXE (con las marcas Silent y SilentWithProgress)
  • INNO
  • NULLSOFT
  • MSI
  • APPX
  • MSIX
  • BURN
  • PORTABLE

Scripting en winget

Puede crear scripts por lotes y scripts de PowerShell para instalar varias aplicaciones.

@echo off  
Echo Install Powertoys and Terminal  
REM Powertoys  
winget install Microsoft.Powertoys  
if %ERRORLEVEL% EQU 0 Echo Powertoys installed successfully.  
REM Terminal  
winget install Microsoft.WindowsTerminal  
if %ERRORLEVEL% EQU 0 Echo Terminal installed successfully.   %ERRORLEVEL%

Nota

Al crear el script, winget iniciará las aplicaciones en el orden especificado. Cuando un instalador devuelva un estado correcto o de error, winget iniciará el siguiente instalador. Si un instalador inicia otro proceso, es posible que vuelva a winget de forma prematura. Esto hará que winget instale el siguiente instalador antes de que se haya completado el instalador anterior.

Depuración y solución de problemas

winget ofrece información de registro para ayudar a diagnosticar problemas. Para la solución de problemas y los detalles sobre el registro, vea Depuración y solución de problemas.

Herramientas que faltan

Si el repositorio de la comunidad no incluye su herramienta o aplicación, envíe un paquete al repositorio. Al agregar tu herramienta favorita, estará disponible para ti y para todos los demás usuarios.

Personalización de la configuración de winget

Para configurar la experiencia con la línea de comandos de winget, puede modificar el archivo settings.json. Para obtener más información, vea https://aka.ms/winget-settings. Tenga en cuenta que la configuración aún está en estado experimental y todavía no se ha completado para la versión preliminar de la herramienta.

Detalles del código abierto

La herramienta winget es un software de código abierto disponible en GitHub en el repositorio https://github.com/microsoft/winget-cli/. El origen para compilar el cliente se encuentra en la carpeta src.

El origen de winget está contenido en una solución de C++ en Visual Studio 2019. Para compilar la solución correctamente, instala la versión más reciente de Visual Studio con la carga de trabajo de C++.

Te recomendamos que contribuyas al origen de winget en GitHub. Primero debes aceptar y firmar el Contrato de licencia de colaborador (CLA) de Microsoft.

Solucionar problemas

El repositorio winget-cli mantiene una lista de problemas y errores comunes, junto con recomendaciones sobre cómo resolver: