Uso de la herramienta winget para instalar y administrar aplicacionesUse the winget tool to install and manage applications

Importante

Tanto el Administrador de paquetes de Windows como la herramienta winget se encuentran en versión preliminar pública y existe la posibilidad de que se modifiquen sustancialmente antes de estén disponibles de forma general.Windows Package Manager and the winget tool are in public preview and may be substantially modified before they are generally available. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información que se ofrece aquí.Microsoft makes no warranties, express or implied, with respect to the information provided here.

La herramienta de línea de comandos winget permite a los desarrolladores detectar, instalar, actualizar, quitar y configurar aplicaciones en equipos con Windows 10.The winget command line tool enables developers to discover, install, upgrade, remove and configure applications on Windows 10 computers. Esta herramienta es la interfaz cliente para el servicio del Administrador de paquetes de Windows.This tool is the client interface to the Windows Package Manager service.

Actualmente, la herramienta winget se encuentra en versión preliminar, por lo que no todas las funcionalidades planeadas están disponibles en este momento.The winget tool is currently a preview, so not all planned functionality is available at this time.

Instalación de wingetInstall winget

Hay varias maneras de instalar la herramienta winget:There are several ways to install the winget tool:

Nota

La herramienta winget requiere Windows 10, versión 1709 (10.0.16299) o una versión posterior de Windows 10.The winget tool requires Windows 10, version 1709 (10.0.16299), or a later version of Windows 10.

Consideraciones para administradoresAdministrator considerations

El comportamiento del instalador puede variar en función de si ejecutas winget con privilegios de administrador.Installer behavior can be different depending on whether you are running winget with administrator privileges.

  • Al ejecutar winget sin privilegios de administrador, es posible que algunas aplicaciones requieran una elevación de privilegios para instalarse.When running winget without administrator privileges, some applications may require elevation to install. Cuando se ejecute el instalador, Windows te pedirá que eleves los privilegios.When the installer runs, Windows will prompt you to elevate. Si decides no elevar los privilegios, la aplicación no se instalará.If you choose not to elevate, the application will fail to install.

  • Al ejecutar winget en un símbolo del sistema de administrador, no verás peticiones de elevación si la aplicación lo requiere.When running winget in an Administrator Command Prompt, you will not see elevation prompts if the application requires it. Siempre debes tener cuidado al ejecutar el símbolo del sistema como administrador y solo instalar las aplicaciones en las que confíes.Always use caution when running your command prompt as an administrator, and only install applications you trust.

Uso de wingetUse winget

Después de instalar Instalador de aplicación, puedes ejecutar winget si escribes "winget" desde un símbolo del sistema.After App Installer is installed, you can run winget by typing 'winget' from a Command Prompt.

Uno de los escenarios de uso más comunes es buscar e instalar una herramienta favorita.One of the most common usage scenarios is to search for and install a favorite tool.

  1. Para buscar una herramienta, escribe winget search <appname>.To search for a tool, type winget search <appname>.

  2. Una vez que hayas confirmado que la herramienta que quieres está disponible, puedes instalar la herramienta escribiendo winget install <appname>.After you have confirmed that the tool you want is available, you can install the tool by typing winget install <appname>. La herramienta winget iniciará el instalador e instalará la aplicación en tu PC.The winget tool will launch the installer and install the application on your PC. Línea de comandos de wingetwinget commandline

  3. Además de instalar y buscar, winget ofrece una serie de comandos que te permiten mostrar los detalles de las aplicaciones, cambiar de orígenes y validar los paquetes.In addition to install and search, winget provides a number of other commands that enable you to show details on applications, change sources, and validate packages. Para obtener una lista completa de comandos, escribe: winget --help.To get a complete list of commands, type: winget --help. Ayuda de wingetwinget help

ComandosCommands

La versión preliminar actual de la herramienta winget admite los siguientes comandos.The current preview of the winget tool supports the following commands.

ComandoCommand DescripciónDescription
hashhash Genera el hash SHA256 para el instalador.Generates the SHA256 hash for the installer.
helphelp Muestra ayuda para los comandos de la herramienta winget.Displays help for the winget tool commands.
installinstall Instala la aplicación especificada.Installs the specified application.
searchsearch Busca una aplicación.Searches for an application.
showshow Muestra los detalles de la aplicación especificada.Displays details for the specified application.
sourcesource Agrega, quita y actualiza los repositorios del Administrador de paquetes de Windows a los que accede la herramienta winget.Adds, removes, and updates the Windows Package Manager repositories accessed by the winget tool.
validatevalidate Valida un archivo de manifiesto para enviarlo al repositorio del Administrador de paquetes de Windows.Validates a manifest file for submission to the Windows Package Manager repository.

OpcionesOptions

La versión preliminar actual de la herramienta winget admite las siguientes opciones.The current preview of the winget tool supports the following options.

OpciónOption DescripciónDescription
-v,--version-v,--version Devuelve la versión actual de winget.Returns the current version of winget.
--info--info Brinda toda la información detallada sobre winget, incluidos los vínculos a la licencia y la declaración de privacidad.Provides you with all detailed information on winget, including the links to the license and privacy statement.
-?, --help-?, --help Muestra ayuda adicional para winget.Shows additional help for winget.

Formatos de instalador admitidosSupported installer formats

La versión preliminar actual de la herramienta winget admite los siguientes tipos de instaladores:The current preview of the winget tool supports the following types of installers:

  • EXEEXE
  • MSIXMSIX
  • MSIMSI

Scripting en wingetScripting winget

Puede crear scripts por lotes y scripts de PowerShell para instalar varias aplicaciones.You can author batch scripts and PowerShell scripts to install multiple applications.

@echo off  
Echo Install Powertoys and Terminal  
REM Powertoys  
winget install Microsoft.Powertoys  
if %ERRORLEVEL% EQU 0 Echo Powertoys installed successfully.  
REM Terminal  
winget install Microsoft.WindowsTerminal  
if %ERRORLEVEL% EQU 0 Echo Terminal installed successfully.   %ERRORLEVEL%

Nota

Al crear el script, winget iniciará las aplicaciones en el orden especificado.When scripted, winget will launch the applications in the specified order. Cuando un instalador devuelva un estado correcto o de error, winget iniciará el siguiente instalador.When an installer returns success or failure, winget will launch the next installer. Si un instalador inicia otro proceso, es posible que vuelva a winget de forma prematura.If an installer launches another process, it is possible that it will return to winget prematurely. Esto hará que winget instale el siguiente instalador antes de que se haya completado el instalador anterior.This will cause winget to install the next installer before the previous installer has completed.

Herramientas que faltanMissing tools

Si el repositorio de la comunidad no incluye su herramienta o aplicación, envíe un paquete al repositorio.If the community repository does not include your tool or application, please submit a package to our repository. Al agregar tu herramienta favorita, estará disponible para ti y para todos los demás usuarios.By adding your favorite tool, it will be available to you and everyone else.

Personalización de la configuración de wingetCustomize winget settings

Para configurar la experiencia con la línea de comandos de winget, puede modificar el archivo settings.json.You can configure the winget command line experience by modifying the settings.json file. Para más información, vea https://aka.ms/winget-settings.For more information, see 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.Note that the settings are still in an experimental state and not yet finalized for the preview version of the tool.

Detalles del código abiertoOpen source details

La herramienta winget es software de código abierto disponible en GitHub en el repositorio https://github.com/microsoft/winget-cli/.The winget tool is open source software available on GitHub in the repo https://github.com/microsoft/winget-cli/. El origen para compilar el cliente se encuentra en la carpeta src.The source for building the client is located in the src folder.

El origen de winget está contenido en una solución de C++ en Visual Studio 2019.The source for winget is contained in a Visual Studio 2019 C++ solution. Para compilar la solución correctamente, instala la versión más reciente de Visual Studio con la carga de trabajo de C++.To build the solution correctly, install the latest Visual Studio with the C++ workload.

Te recomendamos que contribuyas al origen de winget en GitHub.We encourage you to contribute to the winget source on GitHub. Primero debes aceptar y firmar el Contrato de licencia de colaborador (CLA) de Microsoft.You must first agree to and sign the Microsoft CLA.