Comando install (winget)

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>]

Alias

Los alias siguientes están disponibles para este comando:

• add

Argumentos

Están disponibles los siguientes argumentos.

Argumento	Descripción
-q,--query	Consulta usada para buscar una aplicación.

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. Consulte los problemas conocidos relacionados con el ámbito de instalación del paquete.
-a, --architecture	Permite seleccionar la arquitectura que se va a instalar.
--installer-type	Seleccione el tipo de instalador que desea instalar. Consulte los tipos de instalador admitidos para el cliente WinGet.
-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.
--custom	Argumentos que se pasarán al instalador además de los predeterminados.
--override	Cadena que se pasará directamente al instalador.
-l, --location	Ubicación donde se va a instalar (si se admite).
--ignore-security-hash	Ignora el fallo de comprobación hash del instalador. No se recomienda.
--ignore-local-archive-malware-scan	Ignora el análisis de malware realizado como parte de la instalación de un paquete de tipo archivo desde el manifiesto local.
--dependency-source	Busque las dependencias del paquete mediante el origen especificado.
--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.
--no-upgrade	Omite la actualización si ya existe una versión instalada.
--header	Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
-r, --rename	Valor para cambiar el nombre del archivo ejecutable (portable)
--uninstall-previous	Desinstale la versión anterior del paquete durante la actualización
--force	Ejecute directamente el comando y continúe con incidencias no relacionadas con la seguridad.
-?, --help	Obtiene ayuda adicional sobre este comando.
--wait	Pide al usuario que presione cualquier tecla antes de salir.
--logs,--open-logs	Abre la ubicación predeterminada de los registros.
--verbose, --verbose-logs	Se usa para invalidar la configuración de registro y crear un registro detallado.
--disable-interactivity	Deshabilita los mensajes interactivos.

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.

La mejor manera de limitar la selección a solo un archivo es usar el id. de la aplicación combinado con la opción de consulta exacta. Por ejemplo:

winget install --id Git.Git -e

Si se configuran varios orígenes, es posible tener entradas duplicadas. Es necesario especificar un origen para eliminar aún más la ambigüedad.

winget install --id Git.Git -e --source winget

El origen msstore usa identificadores únicos como "Id" para los paquetes. No requieren la opción de consulta exact. Por ejemplo:

winget install XP9KHM4BK9FZ7Q -s msstore

Instalación local

La opción manifest te permite instalar una aplicación al pasar un archivo YAML directamente al cliente. Si se trata de un manifiesto de varios archivos, se debe usar el directorio que contiene los archivos. La opción manifest tiene el siguiente uso.

Uso: winget install --manifest \<path>

Opción	Descripción
-m, --manifest	Ruta de acceso a los manifiestos de la aplicación que se va a instalar.

Nota

La instalación de paquetes desde archivos de manifiesto locales puede tener riesgos. Como medida de precaución adicional, esta característica debe habilitarla un administrador. Para habilitar esta característica ejecute winget settings --enable LocalManifestFiles. Para deshabilitar esta característica ejecute winget settings --disable LocalManifestFiles.

Archivos de registro

Los archivos de registro de winget, a menos que se redirijan, se ubicarán en la carpeta siguiente: %temp%\AICLI\*.log.

Contratos de licencia

Algunas aplicaciones requerirán al instalarlas que el usuario acepte la licencia u otros contratos antes de la instalación. Cuando esto sucede, el Administrador de paquetes de Windows solicitará al usuario que acepte los contratos. Si el usuario no los acepta, la aplicación no se instalará.

Desde la línea de comandos, puede aceptar automáticamente los contratos pasando la siguiente opción --accept-package-agreements en la línea de comandos. Esto puede ser beneficioso al crear scripts del Administrador de paquetes de Windows.

Temas relacionados

• Uso de la herramienta winget para instalar y administrar aplicaciones