Uso degli argomenti della riga di comando per Terminale Windows

Per aprire una nuova istanza di Terminale Windows dalla riga di comando, puoi usare wt.exe. In alternativa, puoi anche usare l'alias di esecuzione wt.

Nota

Se Terminale Windows è stato creato dal codice sorgente disponibile in GitHub, è possibile aprire tale build usando wtd.exe o wtd.

Sintassi della riga di comando

La riga di comando wt accetta due tipi di valori, ovvero opzioni e comandi. Le opzioni sono un elenco di flag e di altri parametri che controllano il comportamento della riga di comando wt nel complesso. I comandi forniscono l'azione, o l'elenco di azioni delimitate da punti e virgola, che è necessario implementare. Se non specifichi un comando, per impostazione predefinita viene usato new-tab.

wt [options] [command ; ]

Nota

Il comportamento del wt.exe comando può essere influenzato dalla windowingBehavior proprietà . Questa impostazione può essere modificata per impostazione predefinita tra l'apertura di una nuova finestra o l'apertura di una nuova scheda.

Per visualizzare un messaggio della Guida con l'elenco degli argomenti della riga di comando, immetti wt -h, wt --help, wt -? o wt /?.

Opzioni e comandi

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

Opzione	Description
--help, -h, -?, /?	Visualizza il messaggio della Guida.
--maximized, -M	Avvia il terminale ingrandito.
--fullscreen, -F	Avvia il terminale a schermo intero.
--focus, -f	Avvia il terminale in modalità messa a fuoco. Può essere combinato con maximized.
--window, -w<window-id>	Avvia il terminale in una finestra specifica.

Comando Nuova scheda

Comando	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 di directory iniziale assegnato.	Percorso directory
new-tab, nt	commandline	Crea una nuova scheda in base alla riga di comando assegnata.	Eseguibile con comandi facoltativi
new-tab, nt	--title	Crea una nuova scheda con il titolo assegnato.	Testo da usare come titolo della scheda
new-tab, nt	--tabColor	Crea una nuova scheda con il colore della scheda assegnato.	Colore esadecimale come #RGB o #RRGGBB

Suggerimento

Se si modifica il titolo di una scheda in Terminale Windows e si vuole che tale titolo venga mantenuto, è necessario abilitare l'opzione suppressApplicationTitle impostandola su true.

Comando Riquadro di divisione

Comando	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 suddivisa in base al profilo della riga di comando assegnato. Se questo parametro non è assegnato, verrà usato il profilo predefinito.	Nome profilo
split-pane, sp	--startingDirectory, -d starting-directory	Crea un nuovo riquadro della finestra suddivisa in base al percorso di directory iniziale assegnato. Se questo parametro non è assegnato, verrà 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 di tabulazioni 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 il 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 duplicato del riquadro corrente.	N/D. Nessun valore aggiuntivo da assegnare.

Comando Della scheda messa a fuoco

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

Comando Move-focus

Comando	Parametro	Description	Valori
move-focus, mf	direction	Spostare lo stato attivo tra i riquadri nella direzione specificata.	up, down, lefto right valori accettati.

Nota

Quando si apre Terminale Windows da cmd (prompt dei comandi), se si vogliono usare le impostazioni del profilo "cmd" personalizzate, è necessario usare il comando wt -p cmd. In caso contrario, per eseguire le impostazioni predefinite del profilo, usare wt cmdsemplicemente .

Esempi di argomenti della riga di comando

I comandi possono variare leggermente a seconda della riga di comando che usi.

Passaggio di un argomento alla shell predefinita

Per avviare un'istanza di Terminale Windows e fare in modo che eseguo un comando, chiamare wt.exe seguito dal comando.

Ecco un esempio di chiamata di 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 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

Di seguito sono riportati esempi di come specificare la destinazione di finestre specifiche usando l'opzione --window,-w .

Prompt dei comandi

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

PowerShell

// 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 then, create a new window named foo.
wt -w foo nt

Linux

// Open a new tab with the default profile in the current window
cmd.exe /c "wt.exe" -w 0 nt

// Open a new tab in a new window with the default profile
cmd.exe /c "wt.exe" -w -1 nt

// Open a new tab in the first-created terminal window with the default profile
cmd.exe /c "wt.exe" -w 1 nt

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

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione.

Aprire una nuova istanza del profilo

Per aprire una nuova istanza del terminale, in questo caso il comando aprirà il profilo denominato "Ubuntu-18.04", immetti:

Prompt dei comandi

wt -p "Ubuntu-18.04"

PowerShell

wt -p "Ubuntu-18.04"

Linux

cmd.exe /c "wt.exe" -p "Ubuntu-18.04"

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione.

Il flag -p si usa per specificare il profilo di Terminale Windows da aprire. Sostituisci "Ubuntu-18.04" con il nome di un profilo di terminale installato. Verrà sempre aperta una nuova finestra. Terminale Windows non è ancora in grado di aprire nuove schede o riquadri in un'istanza esistente.

Directory di destinazione

Per specificare la cartella da usare come directory iniziale della console, in questo caso la directory d:\, immetti:

Prompt dei comandi

wt -d d:\

PowerShell

wt -d d:\

Linux

cmd.exe /c "wt.exe" -d d:\

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione.

Più schede

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

Prompt dei comandi

wt ; ;

PowerShell

wt `; `;

PowerShell usa un punto e virgola (;) per delimitare le istruzioni. Per interpretare un punto e virgola ; come delimitatore di comandi per gli argomenti della riga di comando wt, è necessario usare i caratteri di escape del punto e virgola con accenti gravi. PowerShell include anche l'operatore di interruzione analisi (--%), che indica di arrestare l'interpretazione di qualsiasi stringa dopo tale operatore e di passarla esattamente così come è.

Linux

cmd.exe /c "wt.exe" \; \;

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione.

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

Prompt dei comandi

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

PowerShell

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

PowerShell usa un punto e virgola (;) per delimitare le istruzioni. Per interpretare un punto e virgola ; come delimitatore di comandi per gli argomenti della riga di comando wt, è necessario usare i caratteri di escape del punto e virgola con accenti gravi. PowerShell include anche l'operatore di interruzione analisi (--%), che indica di arrestare l'interpretazione di qualsiasi stringa dopo tale operatore e di passarla esattamente così come è.

Linux

cmd.exe /c "wt.exe" -p "Command Prompt" \; new-tab -p "Windows PowerShell"

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e la \; barra rovesciata + punto e virgola separa i comandi.

Più riquadri

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

Prompt dei comandi

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

PowerShell

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

PowerShell usa un punto e virgola (;) per delimitare le istruzioni. Per interpretare un punto e virgola ; come delimitatore di comandi per gli argomenti della riga di comando wt, è necessario usare i caratteri di escape del punto e virgola con accenti gravi. PowerShell include anche l'operatore di interruzione analisi (--%), che indica di arrestare l'interpretazione di qualsiasi stringa dopo tale operatore e di passarla esattamente così come è.

Linux

cmd.exe /c "wt.exe" -p "Command Prompt" \; split-pane -p "Windows PowerShell" \; split-pane -H wsl.exe

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e la \; barra rovesciata + punto e virgola separa i comandi.

Il flag -H (o --horizontal) indica che i riquadri devono essere divisi orizzontalmente. Il flag -V (o --vertical) indica che i riquadri devono essere divisi verticalmente.

Schede e riquadri multipli

I new-tab comandi e split-pane possono essere sequenziati 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:

Prompt dei comandi

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

PowerShell

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

PowerShell usa un punto e virgola (;) per delimitare le istruzioni. Per interpretare un punto e virgola ; come delimitatore di comandi per gli argomenti della riga di comando wt, è necessario usare i caratteri di escape del punto e virgola con accenti gravi. PowerShell include anche l'operatore di interruzione analisi (--%), che indica di arrestare l'interpretazione di qualsiasi stringa dopo tale operatore e di passarla esattamente così come è.

Linux

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

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e la \; barra rovesciata + punto e virgola separa i comandi. Si noti che per specificare una directory di Windows come directory iniziale per wsl.exe le due barre \\ rovesciata sono necessarie.

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 all'apertura di più schede, immettere:

Prompt dei comandi

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --title tabname1 \; new-tab -p "Ubuntu-18.04" --title tabname2

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e i caratteri \; (barra + punto e virgola) separano i comandi.

I riquadri nella stessa scheda possono avere titoli diversi, che rifletteranno il titolo della scheda a seconda del riquadro con stato attivo. Per denominare riquadri indipendenti, è possibile impostare il titolo dopo aver suddiviso i riquadri immettendo:

Prompt dei comandi

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --title pane1 \; split-pane -p "Command Prompt" --title pane2

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e i caratteri \; (barra + punto e virgola) separano i comandi.

Uso del titolo dell'applicazione

Per aprire una nuova istanza del terminale che consente alle applicazioni al suo interno 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 nessuno di questi flag viene fornito, il comportamento viene ereditato dalle impostazioni del profilo. Per aprire una scheda con titolo tabname che non verrà sottoposto a override dall'applicazione, immettere:

Prompt dei comandi

wt --title tabname --suppressApplicationTitle

PowerShell

wt --title tabname --suppressApplicationTitle

Linux

cmd.exe /c "wt.exe" --title tabname --suppressApplicationTitle

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e la \; barra rovesciata + punto e virgola separa i comandi.

Colore delle schede

Per aprire una nuova istanza del terminale con colori di tabulazioni personalizzati, usare l'argomento --tabColor . Questo argomento esegue l'override del valore definito nel profilo, ma può anche essere sottoposto a override usando la selezione colori di tabulazioni. Nell'esempio seguente viene creato un nuovo terminale con due schede di colori diversi:

Prompt dei comandi

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --tabColor #009999 \; new-tab --tabColor #f59218

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e \; separare i comandi.

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

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

Combinazione di 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.

Prompt dei comandi

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" --colorScheme Vintage \; split-pane --colorScheme "Tango Light"

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e \; separare i comandi.

Stato attivo della scheda

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

Prompt dei comandi

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

PowerShell

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

Linux

cmd.exe /c "wt.exe" \; new-tab -p "Ubuntu-18.04" \; focus-tab -t 1

Gli alias di esecuzione non funzionano nelle distribuzioni WSL. Se vuoi usare wt.exe dalla riga di comando WSL, puoi generarlo direttamente da CMD eseguendo cmd.exe. L'opzione /c indica a CMD di terminare dopo l'esecuzione e la \; barra rovesciata + punti e virgola separa i comandi.

Esempi di più comandi immessi da PowerShell

Terminale Windows usa il carattere punto e virgola ; come delimitatore per separare i comandi nella riga di comando wt. Però anche PowerShell usa ; come separatore di comandi. Per ovviare a questo problema, puoi usare i suggerimenti seguenti per eseguire più comandi wt 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 PowerShell e l'ultimo WSL.

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

• Esegui l'escape solo dei punti e virgola in modo che PowerShell li ignorerà e li passerà direttamente a wt.
• Usa --%, in modo che PowerShell consideri 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 di Terminale Windows verrà creata con l'analisi corretta di tutti gli argomenti della riga di comando specificati.

Tuttavia, questi metodi non sono attualmente consigliati, perché PowerShell aspetterà che la finestra del terminale appena creata venga chiusa prima di restituire il controllo a PowerShell. Per impostazione predefinita, PowerShell aspetterà che le applicazioni di Windows Store, come Terminale Windows, vengano chiuse prima di tornare al prompt. Nota che questo comportamento è diverso da quello del prompt dei comandi, che tornerà immediatamente al prompt.

Aggiungere Terminale Windows eseguibile al percorso

Per aggiungere il file eseguibile 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 Terminale Windows è attivato per impostazione predefinita, ma potrebbe essere utile confermare se si verificano problemi di accesso.

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