Comando settings (winget)

  • Artículo

El comando settings de la herramienta winget permite personalizar la experiencia del cliente de Administrador de paquetes de Windows. Puede cambiar los valores predeterminados y probar las características experimentales que están habilitadas en el cliente.

El comando settings iniciará el editor de texto predeterminado. Windows iniciará de forma predeterminada el Bloc de notas como una opción. Se recomienda usar una herramienta como Visual Studio Code.

Nota

Puede instalar fácilmente Visual Studio Code escribiendo winget install Microsoft.VisualStudioCode

Alias

Los alias siguientes están disponibles para este comando:

  • config

Uso del comando settings de winget

Inicie la herramienta de edición JSON predeterminada: winget settings

Al iniciar la configuración por primera vez, no habrá ninguna configuración especificada. En la parte superior del archivo JSON se proporciona un vínculo donde puede detectar las características experimentales y la configuración más recientes.

El fragmento de código siguiente es un ejemplo del aspecto que debe tener el archivo de configuración si desea habilitar o modificar algunas de estas características y configuraciones experimentales.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

También hemos definido un esquema para el archivo de configuración. Esto le permite usar TAB para detectar la configuración y la sintaxis si el editor JSON admite esquemas JSON.

Nota

Las características experimentales solo están disponibles en las compilaciones preliminares. Las instrucciones para obtener una compilación preliminar se pueden encontrar en el repositorio de GitHub.

Actualización de la configuración

La siguiente configuración está disponible para la versión 1.0 del Administrador de paquetes de Windows.

configuración de origen

La configuración de source implica la configuración en el origen de WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Un entero positivo representa el intervalo de actualización en minutos. La comprobación de actualizaciones solo se produce cuando se usa un origen. Un cero deshabilitará la comprobación de las actualizaciones de un origen. Los demás valores no son válidos.

  • Deshabilitación: 0
  • Valor predeterminado: 5

Para actualizar manualmente el origen, use winget source update.

configuración visual

La configuración de visual implica elementos visuales que WinGet muestra

"visual": {
    "progressBar": "accent"
},

progressBar

Color de la barra de progreso que WinGet muestra cuando no se especifica mediante argumentos.

  • accent (valor predeterminado)
  • retro
  • rainbow

configuración de installBehavior

La configuración de installBehavior afecta al comportamiento predeterminado de instalar y actualizar paquetes (si procede).

disableInstallNotes

El comportamiento de disableInstallNotes afecta a si las notas de instalación se muestran después de una instalación correcta. Si el valor no está establecido o no es válido, el valor predeterminado será false.

    "installBehavior": {
        "disableInstallNotes": true
    },

configuración de portablePackageUserRoot

La configuración de portablePackageUserRoot afecta al directorio raíz predeterminado en el que los paquetes se instalan en el ámbito User. Esta configuración solo se aplica a los paquetes con el tipo de instalador portable. Si el valor no está establecido o no es válido, el valor predeterminado será %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

Nota: Este valor de configuración debe ser una ruta de acceso absoluta.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

configuración de portablePackageMachineRoot

La configuración de portablePackageMachineRoot afecta al directorio raíz predeterminado en el que los paquetes se instalan en el ámbito Machine. Esta configuración solo se aplica a los paquetes con el tipo de instalador portable. Si el valor no está establecido o no es válido, el valor predeterminado será %PROGRAMFILES%/WinGet/Packages/.

Nota: Este valor de configuración debe ser una ruta de acceso absoluta.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

Configuración de preferences y requirements

Algunas de las configuraciones se duplican en preferences y requirements.

  • La configuración de preferences afecta a cómo se ordenan las distintas opciones disponibles al elegir en la que se va a actuar. Por ejemplo, el ámbito predeterminado de las instalaciones de paquetes es para el usuario actual, pero si no es una opción, se elegirá un instalador de nivel de equipo.
  • La configuración de requirements filtra las opciones, lo que puede dar lugar a una lista vacía y a un error de instalación. En el ejemplo anterior, un requisito de ámbito de usuario dará como resultado que no haya instaladores aplicables y un error.

Los argumentos pasados en la línea de comandos invalidarán de forma eficaz la configuración correspondiente de requirement mientras dure ese comando.

scope

El comportamiento de scope afecta a la elección entre instalar un paquete para el usuario actual o para toda la máquina. El parámetro correspondiente es --scope y usa los mismos valores (user o machine). Consulte los problemas conocidos relacionados con el ámbito de instalación del paquete.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

locale

El comportamiento de locale afecta a la elección del instalador en función de la configuración regional del instalador. El parámetro correspondiente es --locale y usa la etiqueta de lenguaje bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

arquitecturas

El comportamiento de architectures afecta a qué arquitecturas se seleccionarán al instalar un paquete. El parámetro coincidente es --architecture. Tenga en cuenta que solo se pueden seleccionar arquitecturas compatibles con el sistema.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

installerTypes

El comportamiento de installerTypes afecta a qué arquitecturas se seleccionarán al instalar un paquete. El parámetro coincidente es --installer-type.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

uninstallBehavior

La configuración de uninstallBehavior afecta al comportamiento predeterminado de desinstalar paquetes (si procede).

purgePortablePackage

El comportamiento de purgePortablePackage afecta al comportamiento predeterminado para desinstalar un paquete portátil. Si se establece en true, la desinstalación quitará todos los archivos y directorios pertinentes para el paquete portable. Esta configuración solo se aplica a los paquetes con el tipo de instalador portable. Si el valor no está establecido o no es válido, el valor predeterminado será false.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

downloadBehavior

La configuracióndownloadBehavior afecta al comportamiento predeterminado de la descarga de paquetes.

defaultDownloadDirectory

La configuración defaultDownloadDirectory afecta al directorio predeterminado en el que se descargan los paquetes. Si el valor no está establecido o no es válido, el valor predeterminado será %USERPROFILE%/Downloads.

Nota: Este valor de configuración debe ser una ruta de acceso absoluta.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

configuración de telemetry

La configuración de telemetry controla si winget escribe eventos ETW que se pueden enviar a Microsoft en una instalación predeterminada de Windows.

Consulte los detalles sobre la telemetría y nuestra declaración de privacidad principal.

disable

"telemetry": {
    "disable": true
},

Si se establece en true, la configuración de telemetry.disable impedirá que el programa escriba eventos.

configuración de red

La configuración de network influye en cómo winget usa la red para recuperar paquetes y metadatos.

downloader

La configuración de downloader controla qué código se usa al descargar paquetes. El valor predeterminado es default, que puede ser cualquiera de las opciones basadas en nuestra determinación.

wininet usa las API de wininet, mientras que do usa el servicio do.

"network": {
    "downloader": "do"
}

configuración de logging

La configuración de logging controla el nivel de detalle de los archivos de registro. --verbose-logs invalidará esta configuración y siempre creará registros detallados.

"logging": {
    "level": "verbose"
}

Nivel

Están disponibles los niveles de registro siguientes. Si el valor no está establecido o no es válido, el valor predeterminado será info.

  • verbose
  • info
  • warning
  • error
  • Crítico

Habilitación de las nuevas características experimentales

Para descubrir qué características experimentales están disponibles, vaya a https://aka.ms/winget-settings donde puede ver las características experimentales disponibles.