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.
Comando winget list
El comando list de la herramienta winget muestra una lista de las aplicaciones instaladas actualmente en el equipo. El comando list mostrará las aplicaciones que se instalaron a través del Administrador de paquetes de Windows, así como las aplicaciones que se instalaron por otros medios.
El comando list también mostrará si hay disponible una actualización para una aplicación, además, se puede usar el comando upgrade para actualizar la aplicación.
El comando list también admite filtros que se pueden usar para limitar la consulta de enumeración.
Uso
winget list [[-q] \<query>] [\<options>]
Nota
Si desea enumerar todas las aplicaciones con actualizaciones disponibles, use winget upgrade (sin ningún argumento).
Argumentos
Están disponibles los siguientes argumentos.
| Argumento | Descripción |
|---|---|
| -q,–query | Consulta usada para buscar una aplicación. |
| -?, –help | Obtiene ayuda adicional sobre este comando. |
Nota
El argumento de consulta es posicional. No se admite la sintaxis de estilo de comodín. Esta suele ser la cadena de caracteres que espera que le ayude a encontrar el paquete instalado que busca.
Opciones
Las opciones le permiten personalizar la experiencia de enumeración para satisfacer sus necesidades.
| Opción | Descripción |
|---|---|
| –id | Limita la lista al identificador de la aplicación. |
| –name | Limita la lista al nombre de la aplicación. |
| –moniker | Limita la lista al moniker que se muestra para la aplicación. |
| -s, –source | Restringe la lista al nombre de origen indicado. Debe ir seguido del nombre del origen. |
| –tag | Filtra los resultados por etiquetas. |
| –command | Filtra los resultados por el comando especificado por la aplicación. |
| -n, –count | Limita el número de aplicaciones que se muestran en una consulta. |
| -e, –exact | Usa la cadena exacta en la consulta de enumeración, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena. |
| –accept-source-agreements | Se usa para aceptar el contrato de licencia de origen y evitar el aviso. |
| –header | Cabecera HTTP opcional de origen de REST de Windows-Package-Manager. |
| –verbose-logs | Se usa para invalidar la configuración de registro y crear un registro detallado. |
Consultas de ejemplo
En el ejemplo siguiente se enumera una versión específica de una aplicación.
En el ejemplo siguiente se enumeran todas las aplicaciones por identificador de un origen específico.
En el ejemplo siguiente se limita la salida de list a 9 aplicaciones.
Enumeración con actualización
Como se indicó anteriormente, el comando list le permite ver qué aplicaciones ha instalado que tienen actualizaciones disponibles.
En la imagen siguiente, podrá ver que la versión preliminar de Terminal tiene una actualización disponible.
El comando list mostrará no solo la versión de actualización disponible, sino también el origen desde el que está disponible la actualización.
Si no hay actualizaciones disponibles, list solo mostrará la versión instalada actualmente, y no se mostrará la columna de actualización.
Comando winget upgrade
El comando upgrade de la herramienta winget actualiza la aplicación especificada. De manera opcional, puede usar el comando list para identificar la aplicación que quiere actualizar.
El comando upgrade requiere que especifique la cadena exacta que quiere actualizar. Si hay alguna ambigüedad, se le pedirá que filtre aún más el comando upgrade a una aplicación exacta.
Uso
winget upgrade [[-q] \<query>] [\<options>]
Argumentos
Están disponibles los siguientes argumentos.
| Argumento | Descripción |
|---|---|
| -q,–query | Consulta usada para buscar una aplicación. |
| -?, –help | Obtiene ayuda adicional sobre este comando. |
Nota
El argumento de consulta es posicional. No se admite la sintaxis de estilo de comodín. Esta suele ser la cadena de caracteres que espera que le ayude a encontrar el paquete que va a actualizar.
Opciones
Las opciones le permiten personalizar la experiencia de actualización para satisfacer sus necesidades.
| Opción | Descripción |
|---|---|
| -m, –manifest | Debe ir seguido de la ruta de acceso al archivo de manifiesto (YAML). Puedes usar el manifiesto para ejecutar la experiencia de actualización desde un archivo YAML local. |
| –id | Limita la actualización al identificador de la aplicación. |
| –name | Limita la búsqueda al nombre de la aplicación. |
| –moniker | Limita la búsqueda al moniker que se muestra para la aplicación. |
| -v, –version | Le permite especificar la versión exacta que se va a actualizar. Si no se especifica, se actualizará a la aplicación con la versión más reciente. |
| -s, –source | Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen. |
| -e, –exact | Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena. |
| -i, –interactive | Ejecuta el instalador en modo interactivo. La experiencia predeterminada muestra el progreso del instalador. |
| -h, –silent | Ejecuta el instalador en modo silencioso. Suprime toda la interfaz de usuario. La experiencia predeterminada muestra el progreso del instalador. |
| –purge | Elimina todos los archivos y directorios del directorio del paquete (portable) |
| -o, –log | Dirige el registro a un archivo de registro. Tienes que indicar una ruta de acceso a un archivo al que tengas derechos de escritura. |
| –override | Cadena que se pasará directamente al instalador. |
| -l, –location | Ubicación donde se va a actualizar (si se admite). |
| –force | Cuando se detecta un error de coincidencia de hash, se omitirá el error y se intentará instalar el paquete. |
| –accept-package-agreements | Se usa para aceptar el contrato de licencia y evitar el aviso. |
| –accept-source-agreements | Se usa para aceptar el contrato de licencia de origen y evitar el aviso. |
| –header | Cabecera HTTP opcional de origen de REST de Windows-Package-Manager. |
| –all | Actualiza todos los paquetes disponibles a la aplicación más reciente. |
| –include-unknown | Permite actualizar los paquetes incluso cuando no se puede determinar su versión actual. |
| –verbose-logs | Se usa para invalidar la configuración de registro y crear un registro detallado. |
Consultas de ejemplo
En el ejemplo siguiente se actualiza una versión específica de una aplicación.
winget upgrade powertoys --version 0.15.2
En el ejemplo siguiente se actualiza una aplicación a partir de su identificador.
winget upgrade --id Microsoft.PowerToys
En el ejemplo siguiente se muestra cómo actualizar todas las aplicaciones.
Uso de upgrade
Para identificar qué aplicaciones necesitan una actualización, simplemente use upgrade sin ningún argumento para mostrar todas las actualizaciones disponibles.
En el ejemplo siguiente, verá que winget upgrade muestra al usuario qué aplicaciones tienen una actualización disponible. En las actualizaciones disponibles, el usuario identifica que hay una actualización disponible para JanDeDobbeleer.OhMyPosh y usa la upgrade para actualizar la aplicación.
Uso de list y upgrade
Para buscar una actualización disponible para una aplicación específica, use el comando list. Una vez que haya identificado que hay una actualización disponible para su aplicación específica, use upgrade para instalar la versión más reciente.
En el ejemplo siguiente se muestra el comando list que se usa para identificar que hay una actualización disponible para Microsoft.WindowsTerminalPreview. A continuación, el usuario utiliza upgrade para actualizar la aplicación.
upgrade –all
upgrade –all detectará todas las aplicaciones con actualizaciones disponibles. Al ejecutar winglet upgrade --all, el Administrador de paquetes de Windows buscará todas las aplicaciones que tengan actualizaciones disponibles e intentará actualizarlas.
Nota
Algunas aplicaciones no indican una versión. Siempre son las más recientes. Dado que el Administrador de paquetes de Windows no puede detectar si hay una versión más reciente de la aplicación, no será posible realizar una actualización.
Comando winget install
El comando install de la herramienta winget instala la aplicación especificada. Usa el comando search para identificar la aplicación que quieres instalar.
El comando install requiere que especifiques la cadena exacta que quieres instalar. Si hay alguna ambigüedad, se le pedirá que filtre aún más el comando install a una aplicación exacta.
Uso
winget install [[-q] \<query>] [\<options>]
Argumentos
Están disponibles los siguientes argumentos.
| Argumento | Descripción |
|---|---|
| -q,–query | Consulta usada para buscar una aplicación. |
| -?, –help | Obtiene ayuda adicional sobre este comando. |
Nota
El argumento de consulta es posicional. No se admite la sintaxis de estilo de comodín. Suele ser la cadena de caracteres que espera que identifique de forma única el paquete que quiere instalar.
Opciones
Las opciones te permiten personalizar la experiencia de instalación para satisfacer tus necesidades.
| Opción | Descripción |
|---|---|
| -m, –manifest | Debe ir seguido de la ruta de acceso al archivo de manifiesto (YAML). Puedes usar el manifiesto para ejecutar la experiencia de instalación desde un archivo YAML local. |
| –id | Limita la instalación al identificador de la aplicación. |
| –name | Limita la búsqueda al nombre de la aplicación. |
| –moniker | Limita la búsqueda al moniker que se muestra para la aplicación. |
| -v, –version | Te permite especificar la versión exacta que se va a instalar. Si no se especifica, se instalará la aplicación con la versión superior. |
| -s, –source | Restringe la búsqueda al nombre de origen indicado. Debe ir seguido del nombre del origen. |
| –scope | Permite especificar si el instalador debe tener como destino el ámbito de usuario o máquina. |
| -a, –architecture | Permite seleccionar la arquitectura que se va a instalar. |
| -e, –exact | Usa la cadena exacta en la consulta, incluso distingue mayúsculas y minúsculas. No usará el comportamiento predeterminado de una subcadena. |
| -i, –interactive | Ejecuta el instalador en modo interactivo. La experiencia predeterminada muestra el progreso del instalador. |
| -h, –silent | Ejecuta el instalador en modo silencioso. Suprime toda la interfaz de usuario. La experiencia predeterminada muestra el progreso del instalador. |
| –locale | Especifica la configuración regional que se va a usar (formato BCP47). |
| -o, –log | Dirige el registro a un archivo de registro. Tienes que indicar una ruta de acceso a un archivo al que tengas derechos de escritura. |
| –override | Cadena que se pasará directamente al instalador. |
| -l, –location | Ubicación donde se va a instalar (si se admite). |
| –force | Invalida la comprobación hash del instalador. No se recomienda. |
| –accept-package-agreements | Se usa para aceptar el contrato de licencia y evitar el aviso. |
| –accept-source-agreements | Se usa para aceptar el contrato de licencia de origen y evitar el aviso. |
| –header | Cabecera HTTP opcional de origen de REST de Windows-Package-Manager. |
| -r, –rename | Valor para cambiar el nombre del archivo ejecutable (portable) |
| –verbose-logs | Se usa para invalidar la configuración de registro y crear un registro detallado. |
Consultas de ejemplo
En el ejemplo siguiente se instala una versión específica de una aplicación.
winget install powertoys --version 0.15.2
En el ejemplo siguiente se instala una aplicación a partir de su identificador.
winget install --id Microsoft.PowerToys
En el ejemplo siguiente se instala una aplicación por su versión e identificador.
winget install --id Microsoft.PowerToys --version 0.15.2
Selección múltiple
Si la consulta enviada a winget no da como resultado una sola aplicación, winget mostrará los resultados de la búsqueda. Esto te dará los datos adicionales necesarios para refinar la búsqueda para una instalación correcta.