Condividi tramite


Uso degli argomenti della riga di comando per terminale Windows

Usare wt.exe per aprire una nuova istanza di Terminale Windows dalla riga di comando. È anche possibile usare l'alias wt di esecuzione.

Annotazioni

Se si compila terminale Windows dal codice sorgente in GitHub, è possibile aprire tale compilazione usando wtd.exe o wtd.

Argomento della riga di comando di Terminale Windows per i riquadri suddivisi

Sintassi della riga di comando

La wt riga di comando accetta due tipi di valori: opzioni e comandi. Le opzioni sono un elenco di flag e altri parametri che controllano il comportamento della riga di wt comando nel suo complesso. I comandi forniscono l'azione o l'elenco di azioni separate da punti e virgola implementate dalla riga di comando. Se non si specifica un comando, la riga di comando usa new-tab per impostazione predefinita.

wt [options] [command ; ]

Annotazioni

La windowingBehavior proprietà può influire sul comportamento del wt.exe comando. Regola questa impostazione per decidere di default tra aprire una nuova finestra o una nuova scheda.

Per visualizzare un messaggio della Guida che elenca gli argomenti della riga di comando disponibili, immettere: wt -h, wt --helpwt -?, o wt /?.

Opzioni e comandi

Di seguito è riportato l'elenco completo dei comandi e delle opzioni supportati per la wt riga di comando.

Opzione Description
--help, -h, -?, /? Visualizza il messaggio della Guida.
--maximized, -M Avvia il terminale ingrandita.
--fullscreen, -F Avvia il terminale come schermo intero.
--focus, -f Avvia il terminale in modalità messa a fuoco. Può essere combinato con maximized.
--pos x,y Avvia il terminale nella posizione specificata. x o y può essere omesso, per usare il valore predefinito dalle impostazioni.
--size c,r Avvia il terminale con il numero specificato di colonne (c) e righe (r).
--window, -w window-id Esegue il comando specificato in una finestra specifica.

Il --window parametro può essere usato per inviare comandi alle finestre del terminale esistenti.

window-id può essere l'ID intero di una finestra o il nome di una finestra. Accetta anche i valori riservati seguenti:

  • new o -1: eseguire sempre questo comando in una nuova finestra
  • last o 0: eseguire sempre questo comando nella finestra usata più di recente

Se non esiste alcuna finestra con l'oggetto specificato window-id, verrà creata una nuova finestra con tale ID/nome.

Ad esempio, l'esecuzione wt -w _quake aprirà una nuova "finestra di quake". L'esecuzione di questo comando aprirà di nuovo una nuova scheda nella finestra di quake esistente.

Comando Nuova scheda

Utilizzare questo comando per creare una nuova scheda. Per ulteriori informazioni, fare riferimento a l'azionenewTab.

Command Parametro Description Valori
new-tab, nt --profile, -p profile-name Crea una nuova scheda in base al nome del profilo assegnato. Nome profilo
new-tab, nt --startingDirectory, -d starting-directory Crea una nuova scheda in base al percorso della directory iniziale assegnato. Percorso directory
new-tab, nt --title title Crea una nuova scheda con il titolo assegnato. Testo da usare come titolo della scheda
new-tab, nt --tabColor hex-color Crea una nuova scheda con il colore della scheda assegnato. Colore esadecimale come #RGB o #RRGGBB
new-tab, nt --suppressApplicationTitle Eseguire l'override dell'impostazione del suppressApplicationTitle profilo e impostarla su true
new-tab, nt --useApplicationTitle Eseguire l'override dell'impostazione del suppressApplicationTitle profilo e impostarla su false
new-tab, nt --colorScheme scheme-name Eseguire l'override dell'impostazione del colorScheme profilo e impostarla sullo schema dalle impostazioni con il nome scheme-name Nome di una combinazione di colori nelle impostazioni
new-tab, nt --appendCommandLine Aggiunge la riga di comando fornita al comando predefinito del profilo anziché sostituirlo
new-tab, nt --inheritEnvironment, !--reloadEnvironment Ereditare le variabili di ambiente del terminale quando si crea la nuova sessione anziché creare un nuovo blocco di ambiente. Questa impostazione predefinita viene impostata quando viene passato un oggetto commandline .
new-tab, nt commandline Crea una nuova scheda in base alla riga di comando assegnata. Eseguibile con argomenti facoltativi

Suggerimento

Se modifichi il titolo di una scheda in Terminale Windows e vuoi che il titolo venga mantenuto, devi abilitare l'opzione suppressApplicationTitle impostandola su true.

Comando Split-pane

Usare questo comando per creare un nuovo riquadro di divisione. Per ulteriori informazioni, consultare l'azionesplitPane.

Command Parametro Description Valori
split-pane, sp -H, --horizontal, -V, --vertical Crea un nuovo riquadro della finestra divisa orizzontalmente o verticalmente. N/D. Nessun valore aggiuntivo da assegnare.
split-pane, sp --profile, -p profile-name Crea un nuovo riquadro della finestra divisa in base al profilo della riga di comando assegnato. Se non si assegna questo parametro, viene usato il profilo predefinito. Nome profilo
split-pane, sp --startingDirectory, -d starting-directory Crea un nuovo riquadro della finestra divisa in base al percorso della directory iniziale assegnato. Se non si assegna questo parametro, viene usata la directory iniziale predefinita. Percorso directory
split-pane, sp --title Crea un nuovo riquadro della finestra divisa con il titolo assegnato. Testo da usare come titolo della scheda
split-pane, sp --tabColor Crea un nuovo riquadro della finestra divisa con il colore della scheda assegnato. Colore esadecimale come #RGB o #RRGGBB
split-pane, sp --size, -s size Crea un nuovo riquadro della finestra divisa con le dimensioni assegnate. Float che specifica la parte del riquadro padre da utilizzare rappresentata da un separatore decimale. Ad esempio, .4 per rappresentare 40% del riquadro padre.
split-pane, sp commandline Crea un nuovo riquadro della finestra divisa in base alla riga di comando assegnata. Eseguibile con comandi facoltativi
split-pane, sp --duplicate, -D Crea un nuovo riquadro della finestra divisa che duplica il riquadro corrente. N/D. Nessun valore aggiuntivo da assegnare.
split-pane, sp --suppressApplicationTitle Esegue l'override dell'impostazione del suppressApplicationTitle profilo e lo imposta su true.
split-pane, sp --useApplicationTitle Sostituisce l'impostazione del profilo suppressApplicationTitle e la imposta su false.
split-pane, sp --colorScheme scheme-name Sostituisce l'impostazione del profilo colorScheme e la imposta sullo schema specificato dalle impostazioni con il nome scheme-name. Nome di una combinazione di colori nelle impostazioni

Comando focus-tab

Usare questo comando per concentrarsi su una scheda specifica all'interno della finestra. Per altre informazioni, vedere l'azioneswitchToTab.

Command Parametro Description Valori
focus-tab, ft --target, -t tab-index Si concentra su una scheda specifica in base al numero di indice della scheda. Indice tabulazione come intero

Comando Move-focus

Utilizzare questo comando per spostare il focus della finestra. Per altre informazioni, vedere moveFocus azione.

Command Parametro Description Valori
move-focus, mf <direction> Spostare lo stato attivo tra riquadri. Vedere di seguito per i valori accettati direction

Valori accettati direction

  • up down, left, o right spostare lo stato attivo nella direzione specificata.
  • first sposta lo stato attivo sul primo riquadro foglia dell'albero.
  • previous sposta lo stato attivo sul riquadro usato più di recente prima del riquadro corrente.
  • nextInOrder, previousInOrder sposta lo stato attivo sul riquadro successivo o precedente in ordine di creazione.

Comando Sposta riquadro

Usare questo comando per spostare un riquadro all'interno della finestra. Per ulteriori informazioni, consultare l'azione movePane.

Command Parametro Description Valori
move-pane, mp --tab,-t <index> Spostare il riquadro attivo nella scheda specificata nella finestra Indice indicizzato zero della scheda in cui spostare il riquadro.

Comando Scambia riquadro

Usare questo comando per scambiare la posizione di due riquadri all'interno della finestra. Vedere anche l'azioneswapPane.

Command Parametro Description Valori
swap-pane <direction> Scambiare il riquadro con il riquadro nella direzione specificata Vedere di seguito per i valori accettati direction

Valori accettati direction (questi valori sono uguali al move-focus comando secondario):

  • up, down, lefto right: scambia il riquadro attivo con quello nella direzione specificata.
  • first: scambia il riquadro attivo con il primo riquadro foglia nell'albero.
  • previous: scambia il riquadro attivo con il riquadro usato più di recente prima del riquadro corrente.
  • nextInOrder, previousInOrder: scambia il riquadro attivo con il riquadro successivo o precedente in ordine di creazione.

Esempi di argomenti della riga di comando

I comandi possono variare leggermente a seconda della riga di comando in uso.

Passaggio di un argomento alla shell predefinita

Per avviare un'istanza di Terminale Windows ed eseguire un comando, chiamare wt.exe seguito dal comando.

Ecco un esempio di chiamata a Terminale Windows per passare un argomento di comando ping per eseguire l'eco di un indirizzo IP:

wt ping learn.microsoft.com

Ecco un esempio di chiamata a Terminale Windows per aprire una nuova scheda con una riga di comando di PowerShell, confermando di chiamare il comando Start-Service e aprendo un'altra nuova scheda con il prompt dei comandi di Windows aperto alla /k directory:

wt new-tab PowerShell -c Start-Service ; new-tab cmd /k dir

Specificare come destinazione una finestra specifica

Negli esempi seguenti viene illustrato come usare l'opzione --window,-w per definire come destinazione finestre specifiche.

// Open a new tab with the default profile in the current window
wt -w 0 nt

// Open a new tab in a new window with the default profile
wt -w -1 nt

// Open a new tab in the first-created terminal window with the default profile
wt -w 1 nt

// Open a new tab in the terminal window named foo with the default profile. If foo does not exist, create a new window named foo.
wt -w foo nt

Aprire una nuova istanza del profilo

Per aprire una nuova istanza del terminale, ad esempio il profilo denominato "Ubuntu-18.04", immettere:

wt -p "Ubuntu-18.04"

Usa il -p flag per specificare il profilo terminale Windows che vuoi aprire. Sostituire "Ubuntu-18.04" con il nome di qualsiasi profilo del terminale installato. Questo comando apre sempre una nuova finestra. Per aprire una nuova scheda della shell in un'istanza esistente (già aperta) di Terminale Windows, usare: wt -w [window id](#options-and-commands) [executable name]. Ad esempio, wt -w 0 cmd apre una shell del prompt dei comandi nell'istanza più recente di Terminale Windows. Se si avvia un profilo (eseguibile della shell combinato con combinazione di colori, titolo, comando e altre impostazioni che controllano la modalità di interazione con la sessione della console), è necessario usare il nome del profilo nel comando : wt -w 0 -p "Profile Name".

Specificare come destinazione una directory

Per specificare la cartella usata dalla console come directory iniziale, immettere il comando seguente. In questo esempio la directory iniziale è la d:\ directory:

wt -d d:\

Schede multiple

Per aprire una nuova istanza del terminale con più schede, immettere:

wt ; ;

Per aprire una nuova istanza del terminale con più schede, in questo caso un profilo del prompt dei comandi e un profilo di PowerShell immettere:

wt -p "Command Prompt" ; new-tab -p "Windows PowerShell"

Più riquadri

Per aprire una nuova istanza del terminale con una scheda contenente tre riquadri che eseguono un profilo del prompt dei comandi, un profilo di PowerShell e il profilo predefinito che esegue una riga di comando WSL, immettere:

wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

Il -H flag (o --horizontal) indica che si desidera suddividere orizzontalmente i riquadri. Il -V flag (o --vertical) indica che si desidera che i riquadri vengano divisi verticalmente.

Più schede e riquadri

Sequenziare i new-tab comandi e split-pane per ottenere più schede, ognuna con riquadri suddivisi. Per aprire una nuova istanza del terminale con due schede, ognuna con due riquadri che eseguono un prompt dei comandi e una riga di comando WSL, con ogni scheda in una directory diversa, immettere:

wt -p "Command Prompt" ; split-pane -V wsl.exe ; new-tab -d c:\ ; split-pane -H -d c:\ wsl.exe

Titolo riquadro

Per aprire una nuova istanza del terminale con titoli personalizzati per ogni riquadro del terminale, usare l'argomento --title . Per impostare il titolo di ogni riquadro quando si aprono più schede, immettere:

wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2

I pannelli nella stessa scheda possono avere titoli diversi. Il titolo della scheda riflette il titolo del riquadro attualmente attivo. Per assegnare un nome ai riquadri indipendenti, impostare il titolo dopo aver diviso i riquadri immettendo:

wt --title pane1 ; split-pane -p "Command Prompt" --title pane2

Uso del titolo dell'applicazione

Per aprire una nuova istanza del terminale che consente alle applicazioni di impostare il titolo della scheda inviando messaggi di modifica del titolo, usare il --useApplicationTitle flag . Per eliminare questi messaggi, usare il --suppressApplicationTitle flag . Se non si specifica alcun flag, il terminale usa le impostazioni del profilo. Per aprire una scheda con il titolo tabname che l'applicazione non sovrascrive, immettere:

wt --title tabname --suppressApplicationTitle

Colore scheda

Per aprire una nuova istanza del terminale con colori di tabulazioni personalizzati, usare l'argomento --tabColor . Questo parametro esegue l'override del valore definito nel profilo, ma anche il selettore di colori delle schede può eseguirlo. Nell'esempio seguente viene creato un nuovo terminale con due schede di colori diversi:

wt --tabColor #009999 ; new-tab --tabColor #f59218

Quando si imposta --tabColor per una scheda, la si associa al primo riquadro di questa scheda. Di conseguenza, in una scheda con più riquadri, il colore viene applicato solo se il primo riquadro è attivo. Per impostare il colore della scheda per i riquadri aggiuntivi, è necessario aggiungere anche il --tabColorsplit-pane parametro al sottocomando. Nell'esempio seguente viene creata una scheda con due riquadri con i colori delle schede specificati per ogni riquadro:

wt new-tab --tabColor '#009999' `; split-pane --tabColor '#f59218'

Combinazione colori

Per aprire una nuova istanza del terminale con una combinazione di colori specifica (anziché il colorScheme set nel profilo), usare l'argomento --colorScheme . Questo argomento esegue l'override del valore definito nel profilo.

wt --colorScheme Vintage ; split-pane --colorScheme "Tango Light"

Stato attivo tabulazione

Per aprire una nuova istanza del terminale con una scheda specifica nello stato attivo, usare il -t flag (o --target) insieme al numero di indice di tabulazione. Per aprire il profilo predefinito nella prima scheda e il profilo "Ubuntu-18.04" attivo nella seconda scheda (-t 1), immettere:

wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1

Esempi di più comandi da PowerShell

Terminale Windows usa il carattere ; punto e virgola come delimitatore per separare i comandi nella wt riga di comando. Sfortunatamente, PowerShell usa ; anche come separatore di comandi. Per risolvere questo problema, usare i trucchi seguenti per eseguire più wt comandi da PowerShell. In tutti gli esempi seguenti viene creata una nuova finestra del terminale con tre riquadri, uno che esegue il prompt dei comandi, uno con PowerShell e l'ultimo che esegue WSL.

Gli esempi seguenti non usano start per eseguire la riga di comando. Usano invece due altri metodi per eseguire l'escape della riga di comando:

  • Effettuare solo l'escape dei punti e virgola, così che PowerShell li ignori e li passi direttamente a wt.
  • Usando --%, PowerShell considera il resto della riga di comando come argomenti per l'applicazione.
wt new-tab "cmd" `; split-pane -p "Windows PowerShell" `; split-pane -H wsl.exe
wt --% new-tab cmd ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe

In entrambi questi esempi, la finestra del terminale Windows appena creata analizza correttamente tutti gli argomenti della riga di comando forniti.

Tuttavia, questi metodi non sono attualmente consigliati. PowerShell attende che la finestra del terminale appena creata venga chiusa prima di restituire il controllo a PowerShell. Per impostazione predefinita, PowerShell attende sempre che le applicazioni di Windows Store (ad esempio Terminale Windows) si chiudano prima di tornare al prompt. Questo comportamento differisce da quello del prompt dei comandi, che torna immediatamente al prompt.

Aggiungere il file eseguibile del terminale Windows al percorso

Per aggiungere il file eseguibile di Terminale Windows (wt.exe) al percorso, abilitare il relativo "alias di esecuzione dell'app" nella pagina Gestisci alias di esecuzione dell'app di Impostazioni di Windows. L'alias del terminale Windows è attivato per impostazione predefinita, ma potrebbe essere necessario confermarlo se si verificano problemi di accesso.

Se si verificano ancora problemi di accesso agli alias di esecuzione dell'app, verificare se PATH contiene: %LOCALAPPDATA%\Microsoft\WindowsApps. Non tentare di apportare modifiche a C:\Program Files\WindowsApps.

Impostazioni di Windows per gli alias di esecuzione dell'app