Udostępnij za pomocą


Używanie argumentów wiersza polecenia dla terminalu systemu Windows

Użyj wt.exe aby otworzyć nowe wystąpienie Windows Terminal z poziomu wiersza poleceń. Zamiast tego można użyć aliasu wt wykonywania.

Uwaga / Notatka

Jeśli skompilujesz terminal systemu Windows z poziomu kodu źródłowego w usłudze GitHub, możesz otworzyć kompilację przy użyciu polecenia wtd.exe lub wtd.

Argument wiersza polecenia terminalu systemu Windows dla okienek podzielonych

Składnia wiersza polecenia

Wiersz wt polecenia akceptuje dwa typy wartości: opcje i polecenia. Opcje to lista flag i innych parametrów, które kontrolują zachowanie wt wiersza polecenia jako całości. Polecenia zapewniają akcję lub listę akcji rozdzielonych średnikami, które implementuje wiersz polecenia. Jeśli nie określisz polecenia, wiersz polecenia domyślnie używa new-tab.

wt [options] [command ; ]

Uwaga / Notatka

WłaściwośćwindowingBehavior może mieć wpływ na zachowanie wt.exe polecenia. Ustaw to jako domyślne, czy otwierać nową kartę, czy nowe okno.

Aby wyświetlić komunikat pomocy z listą dostępnych argumentów wiersza polecenia, wprowadź: wt -h, wt --help, wt -?lub wt /?.

Opcje i polecenia

Poniżej znajduje się pełna lista obsługiwanych poleceń i opcji wt wiersza polecenia.

Option Description
--help, -h, -?, /? Wyświetla komunikat pomocy.
--maximized, -M Uruchamia terminal zmaksymalizowany.
--fullscreen, -F Uruchamia terminal jako pełny ekran.
--focus, -f Uruchamia terminal w trybie koncentracji uwagi. Można połączyć z maximized.
--pos x,y Uruchamia terminal na danej pozycji. x lub y można pominąć, aby użyć wartości domyślnej z ustawień.
--size c,r Uruchamia terminal z określoną liczbą kolumn (c) i wierszami (r).
--window, -w window-id Uruchamia podane polecenie w określonym oknie.

Parametr --window może służyć do wysyłania poleceń do istniejących okien terminalowych.

window-id może być identyfikatorem całkowitym okna lub nazwą okna. Akceptuje również następujące zastrzeżone wartości:

  • new lub -1: Zawsze uruchamiaj to polecenie w nowym oknie
  • last lub 0: Zawsze uruchamiaj to polecenie w ostatnio używanym oknie

Jeśli nie istnieje okno z danym window-idelementem , zostanie utworzone nowe okno z tym identyfikatorem/nazwą.

Na przykład uruchomienie wt -w _quake spowoduje otwarcie nowego "okna quake". Ponowne uruchomienie tego polecenia spowoduje otwarcie nowej karty w istniejącym oknie quake.

Nowe polecenie karty

Użyj tego polecenia, aby utworzyć nową kartę. Aby uzyskać więcej informacji, zobacz newTab akcję.

Command Parameter Description Wartości
new-tab, nt --profile, -p profile-name Tworzy nową kartę na podstawie przypisanej nazwy profilu. Nazwa profilu
new-tab, nt --startingDirectory, -d starting-directory Tworzy nową kartę na podstawie przypisanej ścieżki katalogu początkowego. Ścieżka katalogu
new-tab, nt --title title Tworzy nową kartę z przypisanym tytułem. Tekst do użycia jako tytuł karty
new-tab, nt --tabColor hex-color Tworzy nową kartę z przypisanym kolorem karty. Kolor szesnastkowy #RGB lub #RRGGBB
new-tab, nt --suppressApplicationTitle Zastąpij ustawienie profilu suppressApplicationTitle i ustaw je na true
new-tab, nt --useApplicationTitle Zastąpij ustawienie profilu suppressApplicationTitle i ustaw je na false
new-tab, nt --colorScheme scheme-name Zastąpi ustawienie profilu colorScheme i ustaw go na schemat z ustawień o nazwie scheme-name Nazwa schematu kolorów w ustawieniach
new-tab, nt --appendCommandLine Dołącza podany wiersz polecenia do domyślnego polecenia profilu zamiast zastępowania go
new-tab, nt --inheritEnvironment, !--reloadEnvironment Dziedzicz własne zmienne środowiskowe terminalu podczas tworzenia nowej sesji, zamiast tworzyć nowy blok środowiska. Ta wartość domyślna jest ustawiana po przekazaniu elementu commandline .
new-tab, nt commandline Tworzy nową kartę na podstawie przypisanego wiersza polecenia. Plik wykonywalny z opcjonalnymi argumentami

Wskazówka

Jeśli zmienisz tytuł karty w terminalu systemu Windows i chcesz, aby tytuł był trwały, musisz włączyć opcję suppressApplicationTitle , ustawiając go na true.

Polecenie podzielone okienka

Użyj tego polecenia, aby utworzyć nowe okienko podziału. Aby uzyskać więcej informacji, zobacz splitPane operację.

Command Parameter Description Wartości
split-pane, sp -H, --horizontal, -V, --vertical Tworzy nowe okienko okna podziału w poziomie lub w pionie. N/A. Brak dodatkowych wartości do przypisania.
split-pane, sp --profile, -p profile-name Tworzy nowe okienko okna podziału na podstawie przypisanego profilu wiersza polecenia. Jeśli ten parametr nie zostanie przypisany, zostanie użyty profil domyślny. Nazwa profilu
split-pane, sp --startingDirectory, -d starting-directory Tworzy nowe okienko okna podziału na podstawie przypisanej ścieżki katalogu początkowego. Jeśli nie przypiszesz tego parametru, zostanie użyty domyślny katalog początkowy. Ścieżka katalogu
split-pane, sp --title Tworzy nowe okienko okna podziału z przypisanym tytułem. Tekst do użycia jako tytuł karty
split-pane, sp --tabColor Tworzy nowe okienko okna podziału z przypisanym kolorem karty. Kolor szesnastkowy #RGB lub #RRGGBB
split-pane, sp --size, -s size Tworzy nowe okienko okna podziału z przypisanym rozmiarem. Zmiennoprzecinkowy określający część okienka nadrzędnego do użycia przez liczbę dziesiętną. Na przykład aby .4 reprezentować 40% okienka nadrzędnego.
split-pane, sp commandline Tworzy nowe okienko okna podziału na podstawie przypisanego wiersza polecenia. Plik wykonywalny z opcjonalnymi poleceniami
split-pane, sp --duplicate, -D Tworzy nowe okno podziału, które duplikuje bieżące okno. N/A. Brak dodatkowych wartości do przypisania.
split-pane, sp --suppressApplicationTitle Zastępuje ustawienie profilu suppressApplicationTitle i ustawia jego wartość na true.
split-pane, sp --useApplicationTitle Zastępuje ustawienie profilu suppressApplicationTitle i ustawia je na false.
split-pane, sp --colorScheme scheme-name Zastępuje ustawienie profilu colorScheme i ustawia go na schemat z ustawień o nazwie scheme-name. Nazwa schematu kolorów w ustawieniach

Polecenie fokusu tabulatora

Użyj tego polecenia, aby podświetlić określoną kartę w oknie. Aby uzyskać więcej informacji, zobacz switchToTab operację.

Command Parameter Description Wartości
focus-tab, ft --target, -t tab-index Skupia się na konkretnej zakładce zgodnie z jej numerem indeksu zakładki. Indeks tabulatora jako liczba całkowita

Polecenie Move-focus

Użyj tego polecenia, aby przenieść fokus w oknie. Aby uzyskać więcej informacji, zobacz moveFocus działanie.

Command Parameter Description Wartości
move-focus, mf <direction> Przenieś fokus między okienkami. Poniżej przedstawiono akceptowane direction wartości

Zaakceptowane direction wartości

  • up, , downleftlub right przenieś fokus w danym kierunku.
  • first przenosi fokus do pierwszego okienka liścia w drzewie.
  • previous przenosi fokus do ostatnio używanego okienka przed bieżącym okienkiem.
  • nextInOrder, previousInOrder przenosi fokus do następnego lub poprzedniego okienka w kolejności tworzenia.

Polecenie Move-pane

Użyj tego polecenia, aby przenieść okienko w oknie. Aby uzyskać więcej informacji, zobacz movePane operację.

Command Parameter Description Wartości
move-pane, mp --tab,-t <index> Przenieś aktywne okienko do danej karty w oknie Indeksowanie zerowe karty w celu przeniesienia okienka do.

Polecenie okienka wymiany

Użyj tego polecenia, aby zamienić położenie dwóch okienek w oknie. Zobacz również swapPane akcję.

Command Parameter Description Wartości
swap-pane <direction> Zamień okienko na okienko w danym kierunku Poniżej przedstawiono akceptowane direction wartości

Akceptowane wartości direction (są takie same jak w poleceniu podrzędnym move-focus):

  • up, , downlub leftright: Zamień aktywne okienko na jeden w danym kierunku.
  • first: Zamień aktywne okienko na pierwsze okienko liścia w drzewie.
  • previous: Zamień aktywne okienko na ostatnio używane okienko przed bieżącym okienkiem.
  • nextInOrder, previousInOrder: zamień aktywne okienko na następne lub poprzednie okienko w kolejności tworzenia.

Przykłady argumentów wiersza polecenia

Polecenia mogą się nieznacznie różnić w zależności od używanego wiersza polecenia.

Przekazywanie argumentu do powłoki domyślnej

Aby uruchomić wystąpienie terminalu systemu Windows i wykonać polecenie, wywołaj wt.exe następujące polecenie.

Oto przykład wywołania terminalu systemu Windows w celu przekazania argumentu polecenia ping w celu echa adresu IP:

wt ping learn.microsoft.com

Oto przykład wywołania terminalu systemu Windows w celu otwarcia nowej karty za pomocą wiersza polecenia programu PowerShell, potwierdzenia wywołania polecenia Usługi uruchamiania i otwarcia innej nowej karty z wierszem polecenia systemu Windows otwartym w /k katalogu:

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

Określanie celu określonego okna

W poniższych przykładach pokazano, jak używać opcji --window,-w do określania konkretnego okna.

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

Otwieranie nowego wystąpienia profilu

Aby otworzyć nowe wystąpienie terminalu, na przykład profil o nazwie "Ubuntu-18.04", wprowadź:

wt -p "Ubuntu-18.04"

Użyj flagi -p , aby określić profil terminalu systemu Windows, który chcesz otworzyć. Zastąp ciąg "Ubuntu-18.04" nazwą dowolnego zainstalowanego profilu terminalu. To polecenie zawsze otwiera nowe okno. Aby otworzyć nową kartę powłoki w istniejącym (już otwartym) wystąpieniu terminalu systemu Windows, użyj polecenia: wt -w [window id](#options-and-commands) [executable name]. Na przykład wt -w 0 cmd otwiera powłokę wiersza polecenia w najnowszej wersji terminalu systemu Windows. Jeśli uruchamiasz profil (plik wykonywalny powłoki połączony ze schematem kolorów, tytułem, poleceniem i innymi ustawieniami, które kontrolują sposób interakcji z sesją konsoli), musisz użyć nazwy profilu w poleceniu: wt -w 0 -p "Profile Name".

Określanie lokalizacji docelowej katalogu

Aby określić folder używany przez konsolę jako katalog początkowy, wprowadź następujące polecenie. W tym przykładzie katalog startowy to d:\.

wt -d d:\

Wiele kart

Aby otworzyć nowe wystąpienie terminalu z wieloma kartami, wprowadź:

wt ; ;

Aby otworzyć nowe wystąpienie terminalu z wieloma kartami, w tym przypadku profil wiersza polecenia i profil programu PowerShell wprowadź:

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

Wiele okienek

Aby otworzyć nowe wystąpienie terminalu z jedną kartą zawierającą trzy okienka z uruchomionym profilem wiersza polecenia, profilem programu PowerShell i domyślnym profilem z wierszem polecenia programu WSL, wprowadź:

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

Flaga -H (lub --horizontal) wskazuje, że okienka mają być podzielone w poziomie. Flaga -V (lub --vertical) wskazuje, że okienka mają być podzielone w pionie.

Wiele kart i okienek

Sekwencjonuj polecenia new-tab i split-pane, aby uzyskać wiele kart, z których każda ma podzielone okienka. Aby otworzyć nowe wystąpienie terminalu z dwiema kartami, każdy z dwoma okienkami z wierszem polecenia i wierszem polecenia WSL, z każdą kartą w innym katalogu, wprowadź:

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

Tytuł okienka

Aby otworzyć nowe wystąpienie terminalu z niestandardowymi tytułami dla każdego okienka terminalu, użyj argumentu --title . Aby ustawić tytuł każdego okienka podczas otwierania wielu kart, wprowadź:

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

Okna w tej samej zakładce mogą mieć różne tytuły. Tytuł karty odzwierciedla tytuł okienka, który ma fokus. Aby nazwać niezależne okienka, nadaj im tytuły po podzieleniu okienek, wpisując następujące polecenie:

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

Korzystanie z tytułu aplikacji

Aby otworzyć nowe wystąpienie terminalu, które pozwala aplikacjom na ustawianie tytułu karty przez wysyłanie komunikatów o zmianie tytułu, użyj flagi --useApplicationTitle. Aby pominąć te komunikaty, użyj flagi --suppressApplicationTitle . Jeśli nie podasz żadnej flagi, terminal używa ustawień profilu. Aby otworzyć kartę z tytułem tabname , którego aplikacja nie zastępuje, wprowadź:

wt --title tabname --suppressApplicationTitle

Kolor karty

Aby otworzyć nowe wystąpienie terminalu z niestandardowymi kolorami kart, użyj argumentu --tabColor . Ten argument zastępuje wartość zdefiniowaną w profilu, ale selektor kolorów karty może również go zastąpić. W poniższym przykładzie zostanie utworzony nowy terminal z dwoma kartami różnych kolorów:

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

Po ustawieniu --tabColor karty należy ją skojarzyć z pierwszym okienkiem tej karty. W związku z tym na karcie z wieloma okienkami kolor jest stosowany tylko wtedy, gdy pierwsze okienko znajduje się w fokusie. Aby ustawić kolor karty dla dodatkowych okienek, należy również dodać --tabColor parametr do split-pane podpolecenia. W poniższym przykładzie karta z dwoma okienkami jest tworzona z kolorami tabulacji określonymi dla każdego okienka:

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

Schemat kolorów

Aby otworzyć nowe wystąpienie terminalu z określonym schematem kolorów (zamiast colorScheme zestawu w profilu), użyj argumentu --colorScheme . Ten argument zastępuje wartość zdefiniowaną w profilu.

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

Fokus karty

Aby otworzyć nowe wystąpienie terminalu z określoną kartą fokusu, użyj -t flagi (lub --target), wraz z numerem tab-index. Aby otworzyć profil domyślny na pierwszej karcie i profilu "Ubuntu-18.04" ukierunkowanego na drugiej karcie (-t 1), wprowadź:

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

Przykłady wielu poleceń z programu PowerShell

Terminal systemu Windows używa znaku ; średnika jako ogranicznika do oddzielania poleceń w wt wierszu polecenia. Niestety program PowerShell używa ; również jako separatora poleceń. Aby obejść ten problem, użyj poniższych wskazówek, aby uruchomić wiele wt poleceń z programu PowerShell. We wszystkich poniższych przykładach zostanie utworzone nowe okno terminalu z trzema okienkami — jednym z uruchomionym wierszem polecenia, jednym z programem PowerShell i ostatnim z uruchomionym programem WSL.

Poniższe przykłady nie używają start do uruchomienia polecenia w wierszu. Zamiast tego używają dwóch innych metod ucieczki z wiersza polecenia:

  • Tylko ucieczka średników tak, aby program PowerShell je ignorował i przekazuje je prosto do wt.
  • Przy użyciu polecenia --%program PowerShell traktuje resztę wiersza polecenia jako argumenty dla aplikacji.
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

W obu tych przykładach nowo utworzone okno terminalu systemu Windows poprawnie analizuje wszystkie podane argumenty wiersza polecenia.

Jednak te metody nie są obecnie zalecane. Program PowerShell czeka na zamknięcie nowo utworzonego okna terminalu przed zwróceniem kontrolki do programu PowerShell. Domyślnie program PowerShell zawsze czeka na zamknięcie aplikacji ze Sklepu Windows (np. Terminal systemu Windows) przed powrotem do monitu. To zachowanie różni się od zachowania wiersza polecenia, który natychmiast wraca do wiersza polecenia.

Dodawanie pliku wykonywalnego terminalu systemu Windows do ścieżki

Aby dodać plik wykonywalny terminalu systemu Windows (wt.exe) do ścieżki, włącz jego "alias wykonywania aplikacji" na stronie Zarządzanie aliasami wykonywania aplikacji w ustawieniach systemu Windows. Alias terminalu systemu Windows jest domyślnie włączony, ale możesz go potwierdzić, jeśli masz problemy z dostępem do niego.

Jeśli nadal masz problemy z dostępem do aliasów uruchamiania aplikacji, sprawdź, czy ścieżka zawiera: %LOCALAPPDATA%\Microsoft\WindowsApps. Nie próbuj wprowadzać zmian w pliku C:\Program Files\WindowsApps.

Ustawienia systemu Windows dla aliasów wykonywania aplikacji