Paramètres de démarrage dans le Terminal Windows

  • Article

Les propriétés listées ci-dessous affectent tout le Terminal Windows, quels que soient les paramètres du profil. Elles doivent être placées à la racine de votre fichier settings.json.

Profil par défaut

Définissez le profil par défaut qui s’ouvre en tapant Ctrl + Maj + T, en tapant la combinaison de touches affectée à newTab, en exécutant wt new-tab sans spécifier de profil, ou en cliquant sur l’icône « + ».

Nom de la propriété :defaultProfile

Nécessité : Obligatoire

Accepte : GUID ou nom de profil sous forme de chaîne

Valeur par défaut : GUID de PowerShell


Application de terminal par défaut

Définissez l’émulateur de terminal par défaut dans Windows où toutes les applications de ligne de commande sont exécutées.

Nom de la propriété : Modifie un paramètre du système d’exploitation (sans nom de propriété dans le fichier settings.json).

Nécessité : Obligatoire

Accepte : Tout émulateur de terminal qui apparaît dans la liste déroulante

valeur par défaut : Hôte de console Windows

Important

Cette fonctionnalité est disponible uniquement si vous exécutez le programme Insider de Windows 10 (Canal développeurs) ou Windows 11.


Lancer au démarrage de l’ordinateur

Quand la valeur est true, cela permet le lancement de Terminal Windows au démarrage. Si la valeur est false, l’entrée de la tâche de démarrage est désactivée.

Remarque : si l’entrée de la tâche de démarrage de Terminal Windows est désactivée par la stratégie d’organisation ou par l’action de l’utilisateur, ce paramètre n’a aucun effet.

Nom de la propriété :startOnUserLogin

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false


Comportement lors du démarrage d’une nouvelle session de terminal

Si la valeur est "defaultProfile", le Terminal Windows démarre une nouvelle session et ouvre un onglet avec votre profil par défaut.

Si la valeur est "persistedWindowLayout", le Terminal Windows enregistre la disposition des fenêtres ouvertes lors de la fermeture et restaure toutes les fenêtres enregistrées lors du démarrage d’une nouvelle session. Le Terminal Windows enregistre automatiquement la disposition de toutes les fenêtres ouvertes pour faciliter la restauration après un plantage. Il enregistre également la mise en page si vous utilisez l’action quit. Par ailleurs, si vous fermez la dernière fenêtre ouverte en cliquant sur le bouton X ou en utilisant la commande closeWindow, il enregistre la disposition de cette dernière fenêtre.

Remarque : Le Terminal Windows enregistre actuellement les informations suivantes.

  • Position, taille et nom de chaque fenêtre

  • Disposition des onglets de chaque fenêtre, notamment la disposition et le profil de chaque volet, mais pas le contenu de ces volets

  • Si votre shell est configuré pour signaler le répertoire de travail actif qui sera également enregistré

Nom de la propriété :firstWindowPreference

Nécessité : Facultatif

Accepte :"defaultProfile", "persistedWindowLayout"

Valeur par défaut :"defaultProfile"


Mode de lancement

Le mode de lancement définit si le terminal est lancé en mode agrandi, en plein écran ou dans une fenêtre. L’affectation de la valeur focus équivaut à lancer le terminal en mode default, mais avec le mode Focus activé. De même, l’affectation de la valeur maximizedFocus entraîne le lancement du terminal dans une fenêtre agrandie avec le mode Focus activé.

Nom de la propriété :launchMode

Nécessité : Facultatif

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

Valeur par défaut :"default"


Comportement des nouvelles instances

Ce paramètre contrôle la manière dont les nouvelles instances de terminal s’attachent à des fenêtres existantes. Cette propriété est utilisée seulement si l’--window,-w windowargument de ligne de commande n’est pas fourni. Ce paramètre accepte les valeurs possibles suivantes :

  • useNew : crée toujours une fenêtre. Il s’agit du comportement standard du terminal avant la version 1.7.
  • useExisting : crée des onglets dans la dernière fenêtre utilisée sur ce bureau. Si ce bureau virtuel ne compte aucune fenêtre existante, une fenêtre de terminal est créée.
  • useAnyExisting : crée des onglets dans la dernière fenêtre utilisée, quel que soit le bureau virtuel où se trouve la fenêtre.

Nom de la propriété :windowingBehavior

Nécessité : Facultatif

Accepte :"useNew", "useExisting", "useAnyExisting"

Valeur par défaut :"useNew"


Taille du lancement

Colonnes au premier lancement

Il s’agit du nombre de colonnes de caractères affichées dans la fenêtre lors du premier chargement. Si launchMode a la valeur "maximized" ou "maximizedFocus", cette propriété est ignorée.

Nom de la propriété :initialCols

Nécessité : Facultatif

Accepte : Entier

Valeur par défaut :120

Lignes au premier lancement

Il s’agit du nombre de lignes affichées dans la fenêtre lors du premier chargement. Si launchMode a la valeur "maximized" ou "maximizedFocus", cette propriété est ignorée.

Nom de la propriété :initialRows

Nécessité : Facultatif

Accepte : Entier

Valeur par défaut :30


Position de lancement

Définit la position de pixel du coin supérieur gauche de la fenêtre lors du premier chargement. Sur un système avec plusieurs affichages, ces coordonnées sont fonction du coin supérieur gauche de l’affichage principal. Si aucune coordonnée X ou Y n’est fournie, le terminal utilise la valeur système par défaut pour cette valeur. Si launchMode a la valeur "maximized" ou "maximizedFocus", la fenêtre est agrandie sur le moniteur spécifié par ces coordonnées.

Nom de la propriété :initialPosition

Nécessité : Facultatif

Accepte : Coordonnées sous forme de chaîne dans les formats suivants : ",", "#,#", "#,", ",#"

Valeur par défaut :","


Centrer au lancement

Quand la valeur est true, la fenêtre du terminal est automatiquement centrée à l’écran sur lequel elle s’ouvre. Le terminal utilise "initialPosition" pour déterminer l’écran à utiliser.

Les interactions avec les autres paramètres de lancement sont les suivantes :

  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "default" : centrer sur le moniteur localisé par x,y.
  • "initialPosition": "x,y", "centerOnLaunch": true, "launchMode": "maximized" : agrandir sur le moniteur localisé par x,y (centerOnLaunch n’ajoute rien).
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "default" : centrer sur le moniteur par défaut.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "focus" : centrer et entrer le mode Focus sur le moniteur par défaut.
  • "initialPosition": <omitted>, "centerOnLaunch": true, "launchMode": "maximized" : agrandir sur le moniteur par défaut (centerOnLaunch n’ajoute rien).

Nom de la propriété :centerOnLaunch

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false


Désactiver les profils dynamiques

Permet de définir quels générateurs de profils dynamiques sont désactivés, ce qui les empêche d’ajouter leurs profils à la liste des profils lors du démarrage. Pour avoir des informations sur les profils dynamiques, consultez la page Profils dynamiques.

Nom de la propriété :disabledProfileSources

Nécessité : Facultatif

Accepte :"Windows.Terminal.Wsl", "Windows.Terminal.Azure", "Windows.Terminal.PowershellCore" et/ou "Windows.Terminal.SSH" à l’intérieur d’un tableau

Valeur par défaut :[]


Actions de démarrage

Vous pouvez définir une liste d’actions à exécuter au démarrage, ce qui permet de lancer le terminal avec un ensemble personnalisé d’onglets et de volets par défaut. Ces actions sont appliquées uniquement si aucun argument de ligne de commande n’est fourni. La liste d’actions est représentée par une chaîne au même format que les commandes dans les arguments de ligne de commande. Pour plus d’informations sur le format des commandes, consultez la page Arguments de ligne de commande.

Nom de la propriété :startupActions

Nécessité : Facultatif

Accepte : Chaîne représentant une liste de commandes à exécuter

Valeur par défaut :""


Continuer à s’exécuter en arrière-plan (préversion)

Quand la valeur est définie sur true, cela permet au terminal de continuer à s’exécuter en arrière-plan après la fermeture de la dernière fenêtre. Cela permet à globalSummon et au mode Quake de fonctionner même quand aucune fenêtre n’est ouverte. Ce paramètre est uniquement disponible dans les versions d’évaluation du terminal.

Nom de la propriété :compatibility.allowHeadless

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false