Comando winget source

El comando source de la herramienta winget permite administrar los orígenes del Administrador de paquetes de Windows. Con el comando source, puede agregar, enumerar, actualizar, quitar, restablecer o exportar repositorios.

Un repositorio de origen proporciona los datos para que pueda detectar e instalar aplicaciones. Use solo ubicaciones de origen seguras y de confianza.

El Administrador de paquetes de Windows especifica los dos repositorios predeterminados siguientes, que puede enumerar mediante winget source list.

  • msstore: catálogo de Microsoft Store.
  • winget: repositorio del Administrador de paquetes de Windows.

Uso

winget source <subcommand> <options>

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-?, --help Obtiene ayuda adicional sobre este comando.

En la imagen siguiente se muestra la ayuda para el comando source:

Screenshot showing help for the source command.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?,--help Muestra la ayuda del comando seleccionado.
--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.

Subcomandos

El comando source admite los subcomandos siguientes.

Subcomando Descripción
agregar Agrega un sitio origen.
list Enumera la lista de orígenes habilitados.
update Actualiza un origen.
remove Quita un origen.
reset Restablece winget y msstorre de nuevo a la configuración inicial.
Exportación Exporta los orígenes actuales.

add

El subcomando add agrega un nuevo origen. Este subcomando requiere las opciones --name y --arg. Dado que el comando cambia el acceso de usuario, add requiere privilegios de administrador.

Uso:

winget source add [-n, --name] <name> [-a, --arg] <url> [[-t, --type] <type>]

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.
-a, --arg Dirección URL o UNC del origen.
-t, --type Tipo de origen .

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
--header Cabecera HTTP opcional de origen de REST de Windows-Package-Manager.
--accept-source-agreements Se usa para aceptar el contrato de licencia de origen y evitar el aviso.
-?, --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.

Por ejemplo, winget source add --name Contoso https://www.contoso.com/cache agrega el repositorio de Contoso en la dirección URL https://www.contoso.com/cache.

Parámetro de tipo opcional

El subcomando add admite el parámetro type opcional, que indica al cliente a qué tipo de repositorio se conecta. Se admite el tipo siguiente.

Tipo Descripción
Microsoft.PreIndexed.Package Tipo de origen predeterminado.

list

El subcomando list enumera los orígenes habilitados actualmente o proporciona detalles sobre un origen específico.

Uso:

winget source list [[-n, --name] <name>]

Alias

Los alias siguientes están disponibles para este subcomando:

  • ls

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?, --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.

list all

El subcomando list por sí solo, winget source list, proporciona la lista completa de orígenes admitidos:

Name   Arg
-----------------------------------------
winget https://winget.azureedge.net/cache

list source details

Para obtener detalles completos sobre un origen, indique el nombre del origen. Por ejemplo:

winget source list --name Contoso

Devuelve la salida siguiente:

Name   : Contoso
Type   : Microsoft.PreIndexed.Package
Arg    : https://pkgmgr-int.azureedge.net/cache
Data   : AppInstallerSQLiteIndex-int_g4ype1skzj3jy
Updated: 2020-4-14 17:45:32.000
  • Name es el nombre del origen.
  • Type es el tipo de repositorio.
  • Arg es la dirección URL o la ruta de acceso que usa el origen.
  • Data es el nombre del paquete opcional, si corresponde.
  • Updated es la fecha y hora de la última actualización del origen.

update

El subcomando update fuerza una actualización de un origen individual o de todos.

Uso:

winget source update [[-n, --name] <name>]

Alias

Los alias siguientes están disponibles para este subcomando:

  • actualizar

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?, --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.

update all

El subcomando update por sí solo, winget source update, solicita actualizaciones a todos los repositorios.

origen de la actualización

El subcomando update con la opción --name dirige una actualización al origen con ese nombre. Por ejemplo: winget source update --name Contoso fuerza una actualización al repositorio de Contoso.

quitar

El subcomando remove quita un origen. Este subcomando requiere la opción --name para identificar el origen. Dado que el comando cambia el acceso de usuario, remove requiere privilegios de administrador.

Uso:

winget source remove [-n, --name] <name>

Alias

Los alias siguientes están disponibles para este subcomando:

  • rm

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?, --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.

Ejemplos

winget source remove --name Contoso

Este comando quita el repositorio de Contoso.

reset

El subcomando reset restablece el cliente a su configuración original y quita todos los orígenes excepto, los predeterminados. Use este subcomando solo en casos poco habituales. Dado que el comando cambia el acceso de usuario, reset requiere privilegios de administrador.

Dado que el comando reset quita todos los orígenes, tiene que forzar la acción mediante la opción --force.

Uso:

winget source reset --force

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?, --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.

exportar

El subcomando export exporta los detalles específicos de un origen a una salida JSON.

Argumentos

Están disponibles los siguientes argumentos.

Argumento Descripción
-n,--name Nombre por el cual identificar el origen.

Opciones

Están disponibles las opciones siguientes:

Opción Descripción
-?, --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.

Ejemplos

winget source export winget

Devuelve la salida siguiente:

{"Arg":"https://winget.azureedge.net/cache","Data":"Microsoft.Winget.Source_8wekyb3d8bbwe","Identifier":"Microsoft.Winget.Source_8wekyb3d8bbwe","Name":"winget","Type":"Microsoft.PreIndexed.Package"}

Acuerdo de origen

Un origen individual puede solicitar que el usuario acepte los términos presentados antes de agregar o usar el repositorio. Si un usuario no acepta o reconoce el contrato, no podrá acceder al origen.

Puede usar la opción --accept-source-agreements para aceptar el contrato de licencia del origen y evitar el aviso.

Screenshot showing a source license prompt.