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 defaultssopra 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