Comando settings (winget)

El comando de configuración de WinGet permite personalizar la experiencia del cliente del Administrador de paquetes de Windows. Puede cambiar los valores predeterminados y probar las características experimentales que están disponibles en el cliente.

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

Nota:

Para instalar Visual Studio Code fácilmente, escriba winget install Microsoft.VisualStudioCode

Alias

Los alias siguientes están disponibles para este comando:

• config

Subcomandos

Los siguientes sub comandos están disponibles.

Subcomando	Descripción
export	Exporta la configuración.
set	Establece el valor de una configuración de administrador.
restablecimiento	Restablece una configuración de administrador a su valor predeterminado.

Opciones

Las siguientes opciones están disponibles:

Argumento	Descripción
--habilitar	Habilita la configuración de administrador especificada.
--inutilizar	Deshabilita la configuración de administrador especificada.
-?--Ayuda	Muestra ayuda sobre el comando seleccionado.
--esperar	Pide al usuario que presione cualquier tecla antes de salir.
--logs,--open-logs	Abre la ubicación de registros predeterminada.
--verbose, --verbose-logs	Habilita el registro detallado para winget.
--nowarn,--ignore-warnings	Suprime las salidas de advertencia.
--disable-interactivity	Deshabilita las solicitudes interactivas.
--proxy	Establece un proxy que se va a usar para esta ejecución.
--no-proxy	Deshabilita el uso de proxy para esta ejecución.

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 se especificará ninguna configuración. En la parte superior del archivo JSON, se proporciona un enlace a la configuración de la CLI de WinGet, donde puede descubrir las características y configuraciones experimentales más recientes.

El fragmento de código siguiente muestra un ejemplo del aspecto del archivo de configuración con modificaciones de salida visual y características experimentales habilitadas.

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

    "visual": {
        "enableSixels": true,
        "progressBar": "rainbow"
    },
    "experimentalFeatures": {
        "experimentalARG": true,
        "experimentalCMD": true
    }
}

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.

Actualización de la configuración

La siguiente configuración está disponible para la versión 1.11 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": 60
},

intervaloDeActualizaciónAutomáticaEnMinutos

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 actualizaciones en un origen. Los demás valores no son válidos.

• Deshabilitar: 0
• Valor predeterminado: 15

Para actualizar manualmente la fuente de origen, use winget source update.

configuración visual

La visual configuración implica elementos visuales mostrados por WinGet

"visual": {
    "enableSixels": true,
    "progressBar": "rainbow"
},

barra de progreso

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

• énfasis (valor predeterminado)
• arco iris
• retro
• sixel
• deshabilitado

anonimizarRutasMostradas

Reemplaza algunas rutas de acceso de carpeta conocidas por sus respectivas variables de entorno.

enableSizels

Habilita la salida de imágenes Sixel en determinados contextos.

configuración de logging

La logging configuración controla el nivel de detalle en 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
• advertencia
• error
• Crítico

preferencias y configuración de requisitos

Algunos de los valores se duplican en preferences y requirements.

• La preferences configuración controla cómo se ordenan las opciones disponibles al seleccionar sobre cuál actuar. Por ejemplo, el ámbito predeterminado de las instalaciones del paquete es para el usuario actual, pero si no es una opción, se elegirá un instalador de nivel de máquina.
• La requirements configuración filtra las opciones, lo que podría dar lugar a una lista vacía y a un error de instalación. En el ejemplo anterior, debido a un requisito de ámbito de usuario, no habría instaladores aplicables y se produciría 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.

ámbito

El scope comportamiento controla la elección entre instalar un paquete para el usuario actual o para toda la máquina. El parámetro coincidente es --scopey 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 controla la elección del instalador en función de la configuración regional del instalador. El parámetro coincidente es --localey usa la etiqueta de idioma bcp47.

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

arquitecturas

El architectures comportamiento controla qué arquitecturas se seleccionarán al instalar un paquete. El parámetro coincidente es --architecture. Solo se pueden seleccionar arquitecturas compatibles con el sistema.

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

tipos de instalador

El installerTypes comportamiento controla qué tipos de instalador se seleccionarán al instalar un paquete. El parámetro coincidente es --installer-type.

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

configuración de installBehavior

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

disableInstallNotes

La disableInstallNotes configuración determina 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 portablePackageUserRoot configuración define el directorio raíz predeterminado para instalar paquetes en el User ámbito. Esto solo se aplica a los paquetes con el tipo de portable instalador. Si el valor no está establecido o no es válido, el valor predeterminado será %LOCALAPPDATA%/Microsoft/WinGet/Packages/.

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

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

configuración de portablePackageMachineRoot

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

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

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

defaultInstallRoot

La defaultInstallRoot configuración especifica la ubicación de instalación predeterminada para los paquetes que requieren una ruta de instalación explícita, si no se especifica la ubicación de instalación.

maxResumes

La maxResumes configuración especifica el número máximo de intentos de reanudación permitidos para un identificador de reanudación único. Esto evita los reinicios continuos si una instalación que requiere un reinicio no se detecta correctamente.

métodoDeExtracciónDeArchivo

La archiveExtractionMethod configuración controla cómo el instalador extrae los archivos. Los valores admitidos son shellApi y tar.

• shellApi usa la API de Windows Shell para extraer archivos.

• tar usa el comando tar para extraer archivos.

UninstallBehavior

La uninstallBehavior configuración controla si el proceso de desinstalación predeterminado quita todos los archivos y directorios pertinentes para este paquete. Solo se aplica al portátil installerType.

purgePortablePackage

La purgePortablePackage configuración controla el 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 portable paquete. Esta configuración solo se aplica a los paquetes con el tipo de portable instalador. Si el valor no está establecido o no es válido, el valor predeterminado será false.

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

Configurar Comportamiento

El ConfigureBehavior valor especifica el directorio raíz predeterminado en el que se instalan los módulos de PowerShell al aplicar una configuración.

comportamiento de descarga

La downloadBehavior configuración controla el directorio predeterminado en el que se descargan los instaladores.

directorioDeDescargasPredeterminado

La defaultDownloadDirectory configuración controla el 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.

El valor de esta configuración debe ser una ruta de acceso absoluta.

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

Configuración de telemetry

La telemetry configuración 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.

deshabilitar

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

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

Configuración de red

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

descargador

La downloader configuración controla qué código se usa al descargar paquetes. El valor predeterminado es do, que puede administrarse mediante la directiva de grupo.

usa las API de WinINet, mientras que utiliza el servicio Delivery Optimization de .

"network": {
    "downloader": "wininet"
}

doProgressTimeoutInSeconds

doProgressTimeoutInSeconds especifica el número de segundos para esperar sin progreso antes de retroceder.

Interactividad

La Interactivity configuración controla si el cliente del Administrador de paquetes de Windows muestra las indicaciones interactivas.

Habilitación de características experimentales

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