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 es compatible 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 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 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 de 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 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
Write-Host "Done."

Para instalar el módulo de PowerShell en el ámbito de la máquina, puede usar el -Scope AllUsers parámetro con el Install-Module cmdlet . Si desea una versión preliminar de WinGet, puede agregar -IncludePrerelease parámetro con el cmdlet Repair-WinGetPackageManager. Para ver los parámetros disponibles para 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 le pedirá que eleve 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 aplicación, puede ejecutar WinGet si escribe "WinGet" en 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 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.
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 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.
-?, --help 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
  • 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 indicado. 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, 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++.

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.

Solucionar problemas

El repositorio WinGet-cli registra una lista de problemas y errores comunes, así como recomendaciones sobre cómo resolver: