Compartir a través de

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 Windows 10, Windows 11 y Windows Server 2025. Esta herramienta es la interfaz de cliente para el servicio Windows Package Manager.

Instalación de WinGet

WinGet el Windows Package Manager está disponible en Windows 11, versiones modernas de Windows 10 y Windows Server 2025 como parte del instalador de App. El instalador de App es un componente del sistema entregado y actualizado por Microsoft Store en versiones de Windows Desktop 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 desencadena Microsoft Store para registrar el Windows Package Manager como parte de un proceso asincrónico. 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 de Windows Package Manager más recientes, puede instalar una compilación en versió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.

  • Usa una cuenta de Microsoft (MSA), de trabajo, educativa o Azure Active Directory (AAD) para inscribirse en el Windows Insider Program en los Canary o Dev Channels. Los canales de Windows Insider Canary y Dev incluyen actualizaciones automáticas de nuevas versiones preliminares de WinGet desde Microsoft Store.

Instalar WinGet en Windows Sandbox

Windows Sandbox proporciona un entorno de escritorio ligero para ejecutar aplicaciones de forma segura de forma aislada. El software instalado dentro del entorno de espacio aislado de Windows permanece "aislado" y se ejecuta por separado de la máquina host. Windows Sandbox no incluye WinGet ni la aplicación Microsoft Store, por lo que deberás descargar el paquete WinGet más reciente de la página de versiones de WinGet en GitHub, o usar el cmdlet llamado Repair-WinGetPackageManager.

Para instalar la versión estable de WinGet en Windows Sandbox, siga estos pasos desde un 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 Windows Sandbox, incluido cómo instalar un Sandbox y qué esperar de su uso, consulte los documentos de Windows Sandbox.

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 le pedirá que eleve. 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
install Instala la aplicación especificada.
show Muestra los detalles de la aplicación especificada.
de origen Agrega, quita y actualiza los repositorios de Windows Package Manager a los que accede WinGet.
buscar Busca una aplicación.
list 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 su envío al repositorio de Windows Package Manager.
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.
repair Repara la aplicación seleccionada.
dscv3 Comandos de recursos de powerShell Desired State Configuration (DSC) v3.

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.
--esperar Pide al usuario que presione cualquier tecla antes de salir.
--logs,--open-logs Abre la ubicación de registros predeterminada.
--verbose, --verbose-logs Habilita el registro detallado para winget.
--nowarn,--ignore-warnings Suprime las salidas de advertencia.
--disable-interactivity Deshabilita las solicitudes interactivas.
--proxy Establece un proxy que se va a usar para esta ejecución.
--no-proxy Deshabilita el uso de proxy para esta ejecución.

Formatos de instalador admitidos

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

El módulo Microsoft.WinGet.Client PowerShell está disponible en el PowerShell Gallery.

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 la herramienta o la aplicación, envíe un paquete a nuestro 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 open source software 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 se encuentra en una solución de C++ de Visual Studio 2022. Para compilar correctamente la solución, clone el repositorio y ejecute el archivo de configuración de WinGet adecuado ubicado en el directorio ".github".

Le animamos a contribuir al origen WinGet en GitHub. Primero debes aceptar y firmar el Contrato de licencia de colaborador (CLA) de Microsoft. Las solicitudes de incorporación de cambios deben provenir de una rama de su propia bifurcación.

Solución de problemas

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

  • Last updated on