Impostazioni generali del profilo in Terminale Windows
Le impostazioni elencate di seguito sono specifiche dei singoli profili univoci. Se si desidera che un'impostazione sia applicata a tutti i profili, è possibile aggiungerla alla sezione defaults
sopra l'elenco dei profili nel file settings.json.
"defaults":
{
// SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
// PROFILE OBJECTS
]
Ordinamento profili
L'ordinamento dei profili in "list"
determina la numerazione dell'indice del profilo. Viene usato per eseguire il mapping alla combinazione di tasti di avvio, ad esempio CTRL+MAIUSC+1.
Per modificare il numero di indice del profilo, è sufficiente tagliare/incollare gli oggetti profilo sopra o sotto l'uno all'altro.
Il primo in eseguirà il mapping all'indice "list"
1, quindi verrà assegnato alla combinazione di tasti CTRL +MAIUSC+1.
Nome
Nome del profilo che verrà visualizzato nel menu a discesa. Questo valore viene usato anche come titolo da passare alla shell all'avvio. Alcune shell, ad esempio bash
, possono scegliere di ignorare questo valore iniziale, mentre altre (Command Prompt
, PowerShell
) possono usare questo valore per tutta la durata dell'applicazione. Per eseguire l'override di questo comportamento del titolo, usa tabTitle
.
Nome della proprietà: name
Necessità: obbligatoria
Accetta: stringa
Riga di comando
File eseguibile usato nel profilo.
Nome della proprietà: commandline
Necessità: facoltativa
Accetta: nome del file eseguibile in formato stringa
Valore predefinito: "cmd.exe"
Esempio: per eseguire un file batch ogni volta che cmd.exe viene eseguito, impostare questo valore su "cmd.exe /k path\to\script.bat"
Directory iniziale
Directory in cui viene avviata la shell quando viene caricata.
Nome della proprietà: startingDirectory
Necessità: facoltativa
Accetta: percorso della cartella in formato stringa
Valore predefinito: "%USERPROFILE%"
NOTA: quando la directory iniziale non è definita, il valore predefinito verrà impostato su "%USERPROFILE%"
(percorso relativo alle impostazioni utente, ad esempio in questo caso C:\Users\<your username>
). Tuttavia, se la directory iniziale è impostata in modo esplicito su null
, si otterranno risultati diversi a seconda della posizione in cui si avvia Terminale.
Esempio: avviare il profilo di PowerShell nella cartella GitHubRepos della directory Documents individuando il profilo powershell.exe e aggiungendo "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",
Esempio con WSL: quando si imposta la directory iniziale per una distribuzione Linux installata tramite WSL, usare il formato "startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"
sostituendo con segnaposto con i nomi appropriati della distribuzione. Ad esempio, "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1"
. Se si usa l'interfaccia utente Impostazioni di Terminale Windows, anziché il file settings.json, per dichiarare questo percorso è possibile usare il pulsante Sfoglia... per selezionare la directory iniziale o immettere il percorso WSL come //wsl.localhost/DISTRO NAME/home/USERNAME
. Ad esempio, //wsl.localhost/Ubuntu-20.04/home/user1
.
Comportamento predefinito: quando il valore startingDirectory non viene specificato, si otterranno risultati diversi a seconda della posizione in cui si avvia Terminale:
- Se si esegue Terminale Windows dal menu Start:
%WINDIR%\System32
- Se si esegue wt.exe dal menu Start:
%WINDIR%\System32
- Se si esegue wt.exe da Win+R:
%USERPROFILE%
- Se si esegue wt.exe dalla barra degli indirizzi di Esplora file: qualsiasi cartella che si sta esaminando.
Nota
Le barre rovesciate devono essere precedute da un carattere di escape. Ad esempio, C:\Users\USERNAME\Documents
deve essere immesso come C:\\Users\\USERNAME\\Documents
.
Icona
In questo modo viene impostata l'icona visualizzata all'interno della scheda, del menu a discesa, dell'elenco a discesa e dell'interruttore di tabulazione.
Nome della proprietà: icon
Necessità: facoltativa
Accetta: percorso del file come stringa o emoji
Esempio: inserendo l'immagine dell'icona ubuntu.ico
nella cartella che si trova in %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState
, è possibile visualizzare l'icona aggiungendo questa riga al profilo nel file settings.json: "icon": "ms-appdata:///roaming/ubuntu.ico"
.
___
Tab title
Se è impostata, sostituirà name
come titolo da passare alla shell all'avvio. Alcune shell, ad esempio bash
, possono scegliere di ignorare questo valore iniziale, mentre altre (Command Prompt
, PowerShell
) possono usare questo valore per tutta la durata dell'applicazione. Per informazioni su come impostare la shell come titolo, vedere l'esercitazione relativa al titolo della scheda.
Nome della proprietà: tabTitle
Necessità: facoltativa
Accetta: stringa
___
Esecuzione automatica come Amministrazione
Se impostato, questo profilo verrà aperto automaticamente in una finestra "con privilegi elevati" (in esecuzione come Amministrazione) per impostazione predefinita. Se si esegue questo profilo da una finestra non modificata, verrà creata una nuova finestra del terminale con privilegi elevati per ospitare questo profilo. Se si avvia questo profilo da una finestra già con privilegi elevati, verrà aperto come nuova scheda.
Quando questa proprietà è impostata su false
, l'apertura di questo profilo in una finestra con privilegi elevati non avvierà una finestra non elevata per ospitare questo profilo. Il profilo verrà semplicemente aperto nella finestra con privilegi elevati, in esecuzione come Amministrazione.
Se si imposta questa proprietà in profiles.defaults
, tutti i profili verranno impostati come Amministratore per impostazione predefinita, a meno che non ne venga eseguito l'override impostando la proprietà in modo specifico su false.
Questa proprietà può essere sottoposta a override nelle azioni newTab
e splitPane
con la proprietà elevate
.
Schede elevate e non elevate non possono coesistere nella stessa finestra del terminale. Per altre informazioni, vedere le domande frequenti.
Nome della proprietà: elevate
Necessità: facoltativa
Accetta: true
, false
Valore predefinito: false
___
Nascondere il profilo dall'elenco a discesa
Se hidden
è impostato su true
, il profilo non verrà visualizzato nell'elenco dei profili. Può essere usata per nascondere i profili predefiniti e quelli generati dinamicamente, lasciandoli nel file settings. Per altre informazioni sui profili dinamici, vedi la pagina Profili dinamici.
Nome della proprietà: hidden
Necessità: facoltativa
Accetta: true
, false
Valore predefinito: false