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.

Puede obtener el Instalador de aplicaciones de Microsoft Store. Si ya está instalado, asegúrese de lo tiene actualizado a la versión más reciente.

Nota

Actualmente, la herramienta de línea de comandos winget solo se admite en Windows 10 1709 (compilación 16299) o posterior. La herramienta winget no estará disponible hasta que haya iniciado sesión en Windows como usuario por primera vez, lo que desencadena Microsoft Store para registrar el Administrador de paquetes de Windows como parte de un proceso asincrónico. Si ha iniciado sesión recientemente como usuario por primera vez y encuentra que la herramienta winget aún no está disponible, puede abrir PowerShell y escribir el siguiente comando para solicitar este registro de winget: Add-AppxPackage -RegisterByFamilyName -MainPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.

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

WinGet se incluye en el Instalador de aplicación de Windows. Para probar las características del Administrador de paquetes de Windows más recientes, puede instalar una compilación preliminar de una de las maneras siguientes:

  • Descargue la versión preliminar de winget más reciente. Lea las notas de la versión de la versión preliminar de winget para obtener información sobre las nuevas características. La instalación de este paquete le proporcionará la versión preliminar del cliente WinGet, pero no habilitará las actualizaciones automáticas de las nuevas versiones preliminares de desde Microsoft Store.

  • Use una cuenta de Microsoft (MSA), una cuenta de trabajo, educativa o de Azure Active Directory (AAD) para registrarse en el canal de desarrolladores de Windows Insider. El canal de desarrolladores de Windows Insider incluye actualizaciones automáticas de las nuevas versiones preliminares de Microsoft Store.

  • Use una cuenta de Microsoft (MSA) para registrarse en el programa de usuarios de Insider del Administrador de paquetes de Windows. Una vez agregada la cuenta Microsoft (MSA) (unos días después de recibir una notificación por correo electrónico), recibirá actualizaciones automáticas de las nuevas versiones preliminares de Microsoft Store.

Instalación de winget en Espacio aislado de Windows

Espacio aislado de Windows proporciona un entorno de escritorio ligero para ejecutar aplicaciones de forma segura y de forma aislada. El software instalado dentro del entorno de Espacio aislado de Windows permanece "aislado" y se ejecuta por separado desde el equipo host. El Espacio aislado de Windows no dispone de winget ni de la aplicación de Microsoft Store, por lo que tendrá que descargar el paquete winget más reciente de la página de versiones de winget en GitHub.

Para instalar la versión estable de winget en Espacio aislado de Windows, siga estos pasos desde un símbolo del sistema de Windows PowerShell:

$progressPreference = 'silentlyContinue'
Write-Information "Downloading WinGet and its dependencies..."
Invoke-WebRequest -Uri https://aka.ms/getwinget -OutFile Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle
Invoke-WebRequest -Uri https://aka.ms/Microsoft.VCLibs.x64.14.00.Desktop.appx -OutFile Microsoft.VCLibs.x64.14.00.Desktop.appx
Invoke-WebRequest -Uri https://github.com/microsoft/microsoft-ui-xaml/releases/download/v2.7.3/Microsoft.UI.Xaml.2.7.x64.appx -OutFile Microsoft.UI.Xaml.2.7.x64.appx
Add-AppxPackage Microsoft.VCLibs.x64.14.00.Desktop.appx
Add-AppxPackage Microsoft.UI.Xaml.2.7.x64.appx
Add-AppxPackage Microsoft.DesktopAppInstaller_8wekyb3d8bbwe.msixbundle

Si prefiere una versión preliminar o una versión diferente del Administrador de paquetes, vaya a https://github.com/microsoft/winget-cli/releases. Copie la dirección URL de la versión que prefiera y actualice el URI anterior.

Para obtener más información sobre el Espacio aislado de Windows, incluido cómo instalar un espacio aislado y qué esperar de su uso, consulte los documentos del Espacio aislado de Windows.

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. winget commandline

  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. winget help

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.
pin Administrar marcadores de paquete.
configure Configurar el sistema en un estado deseado.
download Descargar el instalador de la aplicación especificada.

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)
  • ZIP
  • INNO
  • NULLSOFT
  • MSI
  • WIX
  • APPX
  • MSIX
  • BURN
  • PORTABLE

Scripting en winget

Puede usar la siguiente sintaxis para instalar varias aplicaciones en un solo comando.

USAGE: winget install <query1> <query2> ...

Ejemplo

winget install Microsoft.WindowsTerminal Microsoft.PowerToys Microsoft.VisualStudioCode

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: