install comando (winget)

El install comando de WinGet instala la aplicación especificada. Use el comando search para identificar la aplicación que desea install. Use el comando show para ver detalles sobre la aplicación y el instalador seleccionado por WinGet para el sistema.

El install comando requiere que especifique la cadena exacta en install. Si hay alguna ambigüedad, se le pedirá que filtre aún más el install comando a una aplicación exacta.

Uso

winget install [[-q] <query> ...] [<options>]

Captura de pantalla que muestra las winget opciones de ayuda del comando de importación.

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. De forma predeterminada, winget realiza una coincidencia de subcadena sin distinción entre mayúsculas y minúsculas con el nombre del paquete, el identificador y el moniker. No se admite la sintaxis de caracteres comodín. Usa -e, --exact para requerir una coincidencia exacta (sensible a mayúsculas y minúsculas). Use --id, --name o --moniker para restringir qué campo se busca.

Opciones

Las opciones le permiten personalizar la install experiencia para satisfacer sus necesidades.

Opción Descripción
-m, --manifest Debe ir seguido de la ruta de acceso al archivo de manifiesto (YAML). Puede usar el manifiesto para ejecutar la install experiencia desde un archivo YAML local.
--id Limita install al identificador de la aplicación.
--nombre 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 Permite especificar una versión exacta en install. Si no se especifica, latest será install la aplicación con la versión más alta.
-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, --arquitectura Seleccione la arquitectura en install.
--installer-type Seleccione el tipo de instalador en install. 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, --silencioso 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, --ubicación Ubicación en install a (si se admite).
--ignore-security-hash Ignora el fallo de comprobación hash del instalador. No se recomienda.
--allow-reboot Permite un reinicio si procede.
--skip-dependencies Omite el procesamiento de dependencias del paquete y las características de Windows.
--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 Acepta cualquier contrato de licencia o EULA presentados por el instalador del paquete, suprimiendo el mensaje interactivo. Esto solo se aplica a los términos de licencia propios del paquete; no afecta a los componentes opcionales ni al software agrupado ofrecido por el instalador. Para que no haya ninguna interacción install, combínelo con --silent (-h).
--no-upgrade Omite la actualización si ya existe una versión instalada.
--cabecera Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--authentication-mode Especifique la preferencia de ventana de autenticación (silenciosa, PreferenciaSilenciosa o interactiva).
--authentication-account Especifique la cuenta que se utilizará para la autenticación.
--accept-source-agreements Acepta el contrato de licencia para el origen (repositorio) de WinGet y suprime el aviso interactivo. Esto es independiente de cualquier licencia de paquete: abarca los términos de uso para el propio origen, como el winget repositorio de la comunidad.
-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.
-?--Ayuda Obtiene ayuda adicional sobre este comando.
--esperar 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.
--nowarn,--ignore-warnings Suprime las salidas de advertencia.
--disable-interactivity Deshabilita los mensajes interactivos.
--proxy Establezca un proxy que se usará para esta ejecución.
--no-proxy Deshabilite el uso de proxy para esta ejecución.

Consultas de ejemplo

En el ejemplo siguiente se instala una versión específica de una aplicación.

winget install powertoys --version 0.91.1

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

Instalación de varios paquetes

Puede install incluir varios paquetes en un solo comando enumerando sus identificadores separados por espacios.

winget install Microsoft.VisualStudioCode Microsoft.PowerShell Git.Git

WinGet instala cada paquete en secuencia. Esto resulta útil para configurar rápidamente una nueva máquina o compartir un conjunto de herramientas con un compañero.

Sugerencia

Para conjuntos de paquetes más grandes, considere usar winget export e winget import para guardar y restaurar una lista completa de paquetes, o winget configureinstall paquetes junto con otra configuración del equipo en un único archivo.

Desambiguar los resultados

Si la consulta proporcionada a WinGet no da lugar a una sola aplicación, WinGet mostrará los resultados de la búsqueda. Esto le proporcionará los datos adicionales necesarios para refinar la búsqueda de un install correcto.

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 exacta . Por ejemplo:

winget install XP9KHM4BK9FZ7Q -s msstore

Local install

La opción manifest permite install una aplicación pasando 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 a install.

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: \%LOCALAPPDATA%\\Packages\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\LocalState\\DiagOutputDir\\*.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 está de acuerdo, la aplicación no install.

Captura de pantalla del mensaje del contrato de usuario en winget.

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.