Configuración de inicio en Terminal Windows

  • Artículo

Las propiedades que se enumeran a continuación afectan a toda la ventana de terminal, independientemente de la configuración del perfil. Se deben colocar en la raíz del archivo settings.json.

Perfil predeterminado

Para establecer el perfil predeterminado que se abre, escriba Ctrl+Mayús+T, escriba el enlace de teclado asignado a newTab, ejecute wt new-tab sin especificar un perfil o haga clic en el icono "+".

Nombre de propiedad:defaultProfile

Necesidad: Requerido

Acepta: GUI o nombre del perfil como una cadena

Valor predeterminado: GUID de PowerShell.


Aplicación de terminal predeterminada

Establezca el emulador de terminal predeterminado en Windows para que todas las aplicaciones de línea de comandos se ejecuten dentro de este.

Nombre de propiedad: modifica una configuración del sistema operativo y no tiene un nombre de propiedad en el archivo settings.json.

Necesidad: Requerido

Acepta: cualquier emulador de terminal que aparezca en la lista desplegable.

Valor predeterminado: Host de consola de Windows

Importante

Esta característica solo está disponible cuando se ejecuta el Canal de desarrollo del programa Insider de Windows 10 o Windows 11.


Inicio de la máquina

Si se establece en true, habilita el inicio de Terminal Windows en el inicio. Si se establece en false, se deshabilitará la entrada de la tarea de inicio.

Nota: Si la entrada de la tarea de inicio de Terminal Windows se deshabilitada a través de la directiva de la organización o de la acción del usuario, este valor no tendrá ningún efecto.

Nombre de propiedad:startOnUserLogin

Necesidad: Opcional

Acepta:true, false

Valor predeterminado:false


Comportamiento al iniciar una nueva sesión de terminal

Cuando se establece en "defaultProfile", Terminal Windows iniciará una nueva sesión abriendo una sola pestaña con el perfil predeterminado.

Cuando se establece en "persistedWindowLayout", esto permite a Terminal Windows guardar el diseño de las ventanas abiertas al cerrar y restaurar todas las ventanas guardadas al iniciar una nueva sesión. Terminal Windows guardará el diseño de todas las ventanas abiertas automáticamente para ayudarle con la restauración de bloqueos, y también guardará el diseño al usar la acción quit. Asimismo, al cerrar la última ventana abierta al hacer clic en el botón X o mediante el comando closeWindow, guardará el diseño de esa última ventana.

Nota: Actualmente, Terminal Windows guardará la siguiente información:

  • Posición, tamaño y nombre de cada ventana.

  • El diseño de la pestaña de cada ventana, incluido el diseño y el perfil de cada panel, pero no cualquier contenido de esos paneles.

  • Si el shell está configurado para notificar el directorio de trabajo actual que también se guardará.

Nombre de propiedad:firstWindowPreference

Necesidad: Opcional

Acepta:"defaultProfile", "persistedWindowLayout"

Valor predeterminado:"defaultProfile"


Modo de inicio

Define si el terminal se iniciará maximizado, a pantalla completa o en una ventana. Establecer esto en focus equivale a iniciar el terminal en el modo default, pero con el modo de enfoque habilitado. De manera similar, establecer esto en maximizedFocus dará como resultado que el terminal se inicie en una ventana maximizada con el modo de enfoque habilitado.

Nombre de propiedad:launchMode

Necesidad: Opcional

Acepta:"default", "maximized", "fullscreen", "focus", "maximizedFocus"

Valor predeterminado:"default"


Comportamiento de las instancias nuevas

Esta configuración controla cómo se asocian las nuevas instancias de terminal a las ventanas existentes. Esta propiedad solo se usa si no se proporciona el argumento de la línea de comandos--window,-w window. Esta configuración acepta los siguientes valores posibles:

  • useNew: cree una nueva ventana, siempre. Así es como el terminal siempre se comportó antes de la versión 1.7.
  • useExisting: cree nuevas pestañas en la ventana usada más recientemente en este escritorio. Si no hay ninguna ventana existente en este escritorio virtual, cree una nueva ventana de terminal.
  • useAnyExisting: cree nuevas pestañas en la ventana usada más recientemente, independientemente del escritorio virtual en el que se encuentra la ventana.

Nombre de propiedad:windowingBehavior

Necesidad: Opcional

Acepta:"useNew", "useExisting", "useAnyExisting"

Valor predeterminado:"useNew"


Tamaño de inicio

Columnas en el primer inicio

Número de columnas de caracteres que se muestran en la ventana cuando se cargan por primera vez. Si launchMode se establece en "maximized" o "maximizedFocus", esta propiedad se ignora.

Nombre de propiedad:initialCols

Necesidad: Opcional

Acepta: Entero

Valor predeterminado:120

Filas en el primer inicio

Número de filas que se muestran en la ventana cuando se cargan por primera vez. Si launchMode se establece en "maximized" o "maximizedFocus", esta propiedad se ignora.

Nombre de propiedad:initialRows

Necesidad: Opcional

Acepta: Entero

Valor predeterminado:30


Posición de inicio

Establece la posición en píxeles de la esquina superior izquierda de la ventana cuando se carga por primera vez. En un sistema con varias pantallas, estas coordenadas son relativas a la parte superior izquierda de la pantalla principal. Si no se proporciona una coordenada X o Y, el terminal utilizará el valor predeterminado del sistema para ese valor. Si launchMode se establece en "maximized" o "maximizedFocus", la ventana se maximizará en el monitor especificado por esas coordenadas.

Nombre de propiedad:initialPosition

Necesidad: Opcional

Acepta: coordenadas como una cadena con los siguientes formatos: ",", "#,#", "#,"",#"

Valor predeterminado:","


Centro al iniciar

Cuando se establece en true, la ventana de terminal se centrará automáticamente en la pantalla en la que se abre. El terminal usará "initialPosition" para determinar en qué pantalla se va a abrir.

Esto interactúa con la otra configuración de inicio de las maneras siguientes:

  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "default": centrado en el monitor x,y que está encendido.
  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "maximized": maximizado en el monitor x,y que está encendido (centerOnLaunch no agrega nada).
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "default": centrado en el monitor predeterminado.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "focus": centre y entre al modo de enfoque en el monitor predeterminado.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "maximized": maximizado en el monitor predeterminado (centerOnLaunch no agrega nada).

Nombre de propiedad:centerOnLaunch

Necesidad: Opcional

Acepta:true, false

Valor predeterminado:false


Deshabilitación de perfiles dinámicos

Esto establece qué generadores de perfiles dinámicos están deshabilitados, lo que impide que sus perfiles agreguen a la lista de perfiles en el inicio. Para más información sobre los perfiles dinámicos, visite Perfiles dinámicos.

Nombre de propiedad:disabledProfileSources

Necesidad: Opcional

Acepta:"Windows.Terminal.Wsl", "Windows.Terminal.Azure", "Windows.Terminal.PowershellCore", o "Windows.Terminal.SSH" dentro de una matriz.

Valor predeterminado:[]


Acciones de inicio

Esto establece la lista de acciones que se ejecutarán en el inicio, lo que permite que el terminal se inicie con un conjunto personalizado de pestañas y paneles de forma predeterminada. Estas acciones solo se aplicarán si no se proporcionó ningún argumento de línea de comandos. La lista de acciones se representa mediante una cadena con el mismo formato que los comandos en los argumentos de la línea de comandos. Para obtener más información sobre el formato de comandos, consulte la página de argumentos de la línea de comandos.

Nombre de propiedad:startupActions

Necesidad: Opcional

Acepta: cadena que representa una lista de comandos que se ejecutarán.

Valor predeterminado:""


Continuar la ejecución en segundo plano (versión preliminar)

Cuando se establece en true, esta opción permite que el terminal continúe ejecutándose en segundo plano después de cerrar la última ventana. Esto permite que globalSummon y el modo de seísmo funcionen incluso cuando no hay ventanas abiertas. Esta configuración solo está disponible en las compilaciones en versión preliminar del Terminal.

Nombre de propiedad:compatibility.allowHeadless

Necesidad: Opcional

Acepta:true, false

Valor predeterminado:false