Partager via

Paramètres du profil général dans le Terminal Windows

  • Article

Les paramètres répertoriés ci-dessous sont spécifiques à chaque profil unique. Si vous souhaitez qu’un paramètre s’applique à tous vos profils, vous pouvez l’ajouter à la section defaults au-dessus de la liste des profils dans votre fichier settings.json.

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

Ordre des profils

L’ordre des profils sur « "list" » détermine la numérotation de l’index du profil. Ceci est utilisé pour mapper aux combinaisons de touches de lancement, comme Ctrl+Shift+1. Pour modifier le numéro de l’index du profil, il vous suffit de couper/coller les objets de profil au-dessus ou en dessous les uns des autres. Le premier sur « "list" » mappe à l’index 1, par conséquent, il sera affecté à la combinaison de touches Ctrl+Shift+1.

Nom

Il s’agit du nom du profil qui sera affiché dans le menu déroulant. Cette valeur est également utilisée comme « titre » à transmettre au shell au démarrage. Certains shells (comme bash) peuvent choisir d’ignorer cette valeur initiale, tandis que d’autres (Command Prompt, PowerShell) peuvent utiliser cette valeur pendant la durée de vie de l’application. Ce comportement de « titre » peut être substitué à l’aide de tabTitle.

Nom de la propriété :name

Nécessité : Obligatoire

Accepte : String


Ligne de commande

Il s’agit de l’exécutable utilisé dans le profil.

Nom de la propriété :commandline

Nécessité : Facultatif

Accepte : Nom de fichier exécutable sous forme de chaîne

Valeur par défaut :"cmd.exe"


Répertoire de départ

Il s’agit du répertoire dans lequel le shell démarre lorsqu’il est chargé.

Nom de la propriété :startingDirectory

Nécessité : Facultatif

Accepte : Emplacement du dossier sous forme de chaîne

Valeur par défaut :"%USERPROFILE%"

REMARQUE : Si le répertoire de démarrage n’est pas défini, la valeur par défaut est "%USERPROFILE%" (chemin relatif à vos paramètres utilisateur, par exemple C:\Users\<your username>). Toutefois, si le répertoire de départ est explicitement défini sur null, vous obtiendrez des résultats différents selon l’endroit à partir duquel vous lancez le terminal.

Exemple : Démarrez le profil PowerShell dans le dossier GitHubRepos de votre répertoire Documents. Pour cela, recherchez le profil powershell.exe et ajoutez "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",.

Exemple avec WSL : Quand vous définissez le répertoire de départ pour une distribution Linux installée avec WSL, utilisez le format "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME" en remplaçant les espaces réservés par les noms appropriés de votre distribution. Par exemple : "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1". Pour déclarer ce chemin si vous utilisez l’interface utilisateur des paramètres du Terminal Windows à la place du fichier settings.json, vous pouvez utiliser le bouton Parcourir... et sélectionner votre répertoire de départ ou entrer le chemin WSL comme suit : //wsl.localhost/DISTRO NAME/home/USERNAME. Par exemple : //wsl.localhost/Ubuntu-20.04/home/user1.

Comportement par défaut : Si la valeur startingDirectory n’est pas spécifiée, vous obtiendrez des résultats différents en fonction de l’emplacement de lancement du terminal :

  • Si vous exécutez le Terminal Windows à partir du menu Démarrer :%WINDIR%\System32
  • Si vous exécutez wt.exe à partir du menu Démarrer : %WINDIR%\System32
  • Si vous exécutez wt.exe à partir de Win+R : %USERPROFILE%
  • Si vous exécutez wt.exe à partir de la barre d’adresses de l’Explorateur : le dossier, quel qu’il soit, que vous consultiez.

Notes

Les barres obliques inverses doivent être placées dans une séquence d’échappement. Par exemple, entrez C:\Users\USERNAME\Documents sous la forme C:\\Users\\USERNAME\\Documents.

Icône

Définit l’icône qui s’affiche dans l’onglet, le menu déroulant, la liste de raccourcis et le sélecteur d’onglet.

Nom de la propriété :icon

Nécessité : Facultatif

Accepte : Emplacement du fichier en tant que chaîne ou emoji

Exemple : En plaçant l’image d’icône ubuntu.ico dans le dossier situé dans %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState, vous pouvez afficher l’icône en ajoutant cette ligne au profil dans votre fichier settings.json : "icon": "ms-appdata:///roaming/ubuntu.ico".


___

Titre de l’onglet

Si cette valeur est définie, name est remplacé par le titre à passer au shell au démarrage. Certains shells (comme bash) peuvent choisir d’ignorer cette valeur initiale, tandis que d’autres (Command Prompt, PowerShell) peuvent utiliser cette valeur pendant la durée de vie de l’application. Si vous souhaitez savoir comment faire pour que le shell définisse votre titre, consultez le didacticiel sur les titres d’onglet.

Nom de la propriété :tabTitle

Nécessité : Facultatif

Accepte : String


___

Exécuter automatiquement en tant qu'administrateur

Si cette propriété est définie, ce profil s’ouvre automatiquement dans une fenêtre « avec élévation de privilèges » (exécution en tant qu’administrateur) par défaut. Si vous exécutez ce profil à partir d’une fenêtre sans élévation de privilèges, une nouvelle fenêtre de terminal avec élévation de privilèges est créée pour héberger ce profil. Si vous lancez ce profil à partir d’une fenêtre ayant déjà des privilèges élevés, il s’ouvre sous un nouvel onglet.

Quand cette propriété a la valeur false, l’ouverture de ce profil dans une fenêtre avec élévation de privilèges ne lance pas une fenêtre sans élévation de privilèges pour héberger ce profil. Le profil s’ouvre simplement dans la fenêtre avec élévation de privilèges (exécution en tant qu’administrateur).

Si vous définissez cette propriété dans profiles.defaults, tous les profils sont lancés par défaut en tant qu’administrateur, sauf si vous définissez spécifiquement la propriété avec la valeur false.

Cette propriété peut être substituée dans les actions newTab et splitPane, avec la propriété elevate.

Les onglets avec et sans élévation de privilèges ne peuvent pas se trouver dans la même fenêtre de terminal. Pour plus d’informations, consultez le FAQ.

Nom de la propriété :elevate

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false


___

Masquer le profil dans la liste déroulante

Si hidden est défini sur true, le profil n’apparaîtra pas dans la liste des profils. Cela peut être utilisé pour masquer les profils par défaut et les profils générés de manière dynamique, tout en les laissant dans votre fichier de paramètres. Pour en savoir plus sur les profils dynamiques, consultez la page Profils dynamiques.

Nom de la propriété :hidden

Nécessité : Facultatif

Accepte :true, false

Valeur par défaut :false