Compartir vía

Uso de la herramienta WinGet para instalar y administrar aplicaciones

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

Instalación de WinGet

WinGet: el Administrador de paquetes de Windows está disponible en Windows 11, versiones modernas de Windows 10 y Windows Server 2025 dentro del Instalador de aplicaciones. El Instalador de aplicaciones es un componente del sistema provisto y actualizado por Microsoft Store en versiones de escritorio de Windows y a través de actualizaciones en Windows Server 2025.

Nota

La herramienta de línea de comandos WinGet solo se admite en Windows 10 versión 1809 (compilación 17763) o posterior. WinGet no estará disponible hasta que haya iniciado sesión en Windows como usuario por primera vez, lo que hace que Microsoft Store registre el Administrador de paquetes de Windows como parte de un proceso asíncrono. Si ha iniciado sesión recientemente como usuario por primera vez y ve que la herramienta WinGet sigue sin estar disponible, puede abrir PowerShell y escribir el siguiente comando para solicitar el 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 aplicaciones. 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.

  • Utilice una cuenta de Microsoft (MSA), una cuenta profesional, educativa o de Azure Active Directory (AAD) para registrarse en el Programa Windows Insider en los canales Canary o de desarrollo Channels. Los canales Canary y Dev de Windows Insider incluyen actualizaciones automáticas de las nuevas versiones preliminares de WinGet desde la 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 constituye un entorno de escritorio ligero para ejecutar aplicaciones de forma segura y de forma aislada. El software instalado dentro del entorno del espacio aislado de Windows sigue siendo parte del "espacio aislado" y se ejecuta por separado de la máquina host. Windows Sandbox no incluye WinGet ni la aplicación de Microsoft Store, por lo que tendrás que descargar el paquete WinGet más reciente de la página de versiones de WinGet en GitHub o usar el cmdlet Repair-WinGetPackageManager.

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

$progressPreference = 'silentlyContinue'
Write-Host "Installing WinGet PowerShell module from PSGallery..."
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager -AllUsers
Write-Host "Done."

Para instalar el módulo WinGet de PowerShell en la máquina, puede usar el parámetro -Scope AllUsers con el cmdlet Install-Module. Si desea una versión preliminar de WinGet, puede agregar el parámetro -IncludePrerelease con el cmdlet Repair-WinGetPackageManager. Para ver los parámetros disponibles en el cmdlet Repair-WinGetPackageManager, puede ejecutar Get-Help Repair-WinGetPackageManager -Full.

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 instalador puede funcionar de modo distinto en función de si se ejecuta WinGet con privilegios de administrador.

  • Al ejecutar WinGet sin privilegios de administrador, es posible que algunas aplicaciones necesiten que se eleven los 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 el símbolo del sistema del administrador, no verá ninguna petición de elevación de privilegio 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 el Instalador de aplicaciones, puede ejecutar WinGet si escribe "winget" en el editor de comandos.

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 hará que se inicie el instalador e instalará la aplicación en el PC. Línea de comandos de winget

  3. Además de instalar y buscar, WinGet ofrece una serie de comandos que le permiten mostrar los detalles de las aplicaciones, cambiar de origen 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.
de origen Agrega, quita y actualiza los repositorios del Administrador de paquetes de Windows a los que accede la herramienta WinGet.
búsqueda Busca una aplicación.
lista Muestra los paquetes instalados.
upgrade Actualiza la aplicación especificada.
uninstall Desinstala la aplicación especificada.
hash Genera el hash SHA256 para el instalador.
validate Valida un archivo de manifiesto para enviarlo al repositorio del Administrador de paquetes de Windows.
configuración 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 Ofrece 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.
-?--Ayuda Muestra ayuda adicional de 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
  • PORTÁTIL

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

Cuando se crea un script, WinGet instalará 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 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 el uso de la línea de comandos de WinGet, puede modificar el archivo settings.json. Para obtener más información, consulte la página del comando de configuración.

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

Le recomendamos que contribuya al código de origen de WinGet en GitHub. Primero debes aceptar y firmar el Contrato de licencia de colaborador (CLA) de Microsoft.

Solución de problemas

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