settings comando (winget)

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

El comando iniciará el settings 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 Exportar settings.
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 wingetsettings comando

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

Cuando inicie settings por primera vez, no habrá ningún settings especificado. En la parte superior del archivo JSON, proporcionamos un vínculo a la Configuración de la CLI de WinGet, donde puede consultar las funciones experimentales más recientes y settings.

El fragmento de código siguiente muestra un ejemplo del aspecto del settings archivo 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 settings archivo. Esto le permite usar TAB para descubrir settings y la sintaxis si su editor de JSON admite esquemas JSON.

Actualización settings

Los siguientes settings están disponibles para el lanzamiento 1.28 de Windows Administrador de paquetes.

origen settings

Los sourcesettings implican la configuración del 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.

objeto visual settings

Los visualsettings incluyen elementos visuales que muestra 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.

enableSixels

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

registro settings

Los loggingsettings controlan 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

channels

La channels configuración restringe la salida del registro a canales de registro específicos. También se aceptan valores default especiales (el conjunto predeterminado de canales) y all (todos los canales). Se omiten los valores no válidos.

"logging": {
    "channels": ["default"]
}

archivo

Control filesettings de limpieza automática de archivos de registro en el directorio de registro predeterminado. La limpieza se ejecuta al principio de cada proceso de WinGet y solo se aplica a la ubicación de registro predeterminada.

Configuración Descripción Predeterminado
ageLimitInDays Antigüedad máxima en días de archivos en el directorio de registro; Se eliminan los archivos más antiguos. Establézcalo en 0 para deshabilitarlo. 7
totalSizeLimitInMB Tamaño total máximo en megabytes de todos los archivos del directorio de registro; primero se eliminan los archivos más antiguos. Establézcalo en 0 para deshabilitarlo. 128
countLimit Número máximo de archivos en el directorio de registro; primero se eliminan los archivos más antiguos. Establézcalo en 0 para deshabilitarlo. 0 (Deshabilitado)
individualSizeLimitInMB Tamaño máximo en megabytes de un único archivo de registro. Si un archivo superaría este límite, los registros se encapsulan. Establézcalo en 0 para deshabilitarlo. 16 
"logging": {
    "level": "verbose",
    "file": {
        "ageLimitInDays": 7,
        "totalSizeLimitInMB": 128,
        "countLimit": 0,
        "individualSizeLimitInMB": 16
    }
}

preferencias y requisitos settings

Algunos de los settings están duplicados 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 afecta a qué tipos de instalador se seleccionarán al instalar un paquete. También puede determinar qué tipo instalar de forma predeterminada si un manifiesto tiene varios tipos: la lista está en orden de prioridad, con el primer tipo enumerado que se prefiere sobre los demás, etc. Esto es conveniente para los usuarios que, por ejemplo, prefieren paquetes portátiles o instalaciones MSIX/AppX. El parámetro que coincide es --installer-type, que anulará settings.

Los valores permitidos a partir de la versión 1.12.470 incluyen: appx, burn, exefontinnomsimsixmsstorenullsoft, portable, , wixzip

De forma predeterminada, y con todas las demás propiedades iguales, WinGet tiene como valor predeterminado el tipo de instalador que aparece primero en el archivo de instalación del manifiesto YAML si el paquete aún no se ha instalado. Si ya está instalado, se requerirá el mismo tipo de instalador para garantizar una actualización adecuada.

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

installBehavior settings

Controla installBehaviorsettings 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

downloadBehavior settings controlan 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.

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

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

Telemetría settings

El telemetrysettings 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.

Red settings

La networksettings influencia en la forma en que 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/wingethttps://aka.ms/winget-settings donde puede ver las características experimentales disponibles para usted.

experimentalFeatures settings implican la configuración de estas funciones "experimentales". Las características individuales se pueden habilitar en este nodo:

"experimentalFeatures": {
    "directMSI": true,
    "resume": true
}

directMSI

Esta característica permite al Administrador de paquetes de Windows instalar directamente paquetes MSI con las API msi en lugar de a través de msiexec. Tenga en cuenta que cuando se usa la instalación silenciosa, esto ya está en efecto, ya que los paquetes MSI que requieren privilegios elevados fallarán en esa situación sin ello.

"experimentalFeatures": {
    "directMSI": true
}

reanudar

Esta característica permite que algunos comandos se reanuden después de un reinicio.

"experimentalFeatures": {
    "resume": true
}

fuentes

Esta característica permite la compatibilidad con fuentes a través de winget settings. El winget font list comando enumerará las familias de fuentes instaladas y el número de caras de fuente instaladas.

"experimentalFeatures": {
    "fonts": true
}

prioridadDeFuente

Esta característica permite a los orígenes tener asignado un valor de prioridad. Los orígenes con mayor prioridad aparecerán anteriormente en los resultados de la búsqueda y se seleccionarán para instalar nuevos paquetes cuando varios orígenes tengan un paquete coincidente.

Tenga en cuenta que la ordenación de resultados de búsqueda depende de varios factores y la prioridad de origen es el campo más bajo actualmente (la calidad de coincidencia y el campo son más importantes).

"experimentalFeatures": {
    "sourcePriority": true
}
  • Last updated on