Windows 終端機 中的啟動設定

下列屬性會影響整個終端機視窗,不論設定檔設定為何。 這些應該放在 settings.json 檔案的根目錄。

預設設定檔

藉由輸入 ctrl+shift+t、輸入指派至 newTab 的按鍵繫結關係、執行 wt new-tab 而不指定設定檔,或按一下 '+' 圖示,設定開啟的預設設定檔。

屬性名稱:defaultProfile

必要性: 必要

接受: GUID 或設定檔名稱做為字串

預設值: PowerShell 的 GUID



預設終端機應用程式

在 Windows 中設定預設終端機模擬器,讓所有命令列應用程式在 內部執行。

屬性名稱: 這會修改 OS 設定,而且在 settings.json 檔案內沒有屬性名稱。

必要性: 必要

接受: 下拉式清單中出現的任何終端機模擬器

預設值: Windows 主控台主機

重要

只有在執行測試人員計畫開發通道或Windows 11 Windows 10時,才能使用此功能。



在電腦啟動時啟動

當設定為 true 時,這可讓您在啟動時啟動 Windows 終端機。 將此設定為 false 會停用 [啟動工作] 項目。

注意:如果組織原則或使用者動作停用了 Windows 終端機啟動工作項目,則此設定不會有任何作用。

屬性名稱:startOnUserLogin

必要性: 選用

接受:truefalse

預設值:false



啟動新終端機會話時的行為

當設定為 "defaultProfile" 時,Windows 終端機會開啟具有預設設定檔的單一索引標籤,以啟動新的會話。

當設定為 "persistedWindowLayout" 時,這可讓Windows 終端機在關閉時儲存開啟視窗的配置,並在啟動新會話時還原所有儲存的視窗。 Windows 終端機會自動儲存所有開啟視窗的配置,以協助還原當機,也會在使用 quit 動作時儲存版面配置。 此外,按一下 X 按鈕或使用 closeWindow 命令關閉最後一個開啟的視窗,將會儲存該最後一個視窗的配置。

注意:目前,Windows 終端機會儲存下列資訊:

  • 每個視窗的位置、大小和名稱

  • 每個視窗的索引標籤配置,包括每個窗格的配置和設定檔,但不包含這些窗格的任何內容

  • 如果您的殼層設定為報告將同時儲存的目前工作目錄

屬性名稱:firstWindowPreference

必要性: 選用

接受:"defaultProfile""persistedWindowLayout"

預設值:"defaultProfile"



啟動模式

這會定義終端機是否會在視窗中啟動為最大化、全螢幕或視窗。 將此設定為 focus 相當於在模式中 default 啟動終端機,但已啟用 焦點模式 。 同樣地,將此設定為 maximizedFocus 會導致在已啟用焦點模式的最大化視窗中啟動終端機。

屬性名稱:launchMode

必要性: 選用

接受:"default" 、、 "fullscreen""maximized""focus" 、、"maximizedFocus"

預設值:"default"



新的實例行為

此設定可控制新終端實例如何附加至現有的視窗。 只有在未提供命令列引數時, --window,-w window 才會使用這個屬性。 此設定接受下列可能的值:

  • useNew:建立新的視窗,一律為 。 這是終端機一律在 1.7 版之前的行為方式。
  • useExisting:在此桌面上最近使用的視窗中建立新的索引標籤。 如果此虛擬桌面上沒有現有的視窗,請建立新的終端機視窗。
  • useAnyExisting:不論視窗所在的虛擬桌面為何,在最近使用的視窗中建立新的索引標籤。

屬性名稱:windowingBehavior

必要性: 選用

接受:"useNew""useExisting""useAnyExisting"

預設值:"useNew"



啟動大小

第一次啟動時的資料行

這是第一次載入時,視窗中顯示的資料行字元數。 如果 launchMode 設定為 "maximized""maximizedFocus" ,則會忽略這個屬性。

屬性名稱:initialCols

必要性: 選用

接受: 整數

預設值:120

第一次啟動時的資料列

這是第一次載入時,視窗中顯示的資料列數。 如果 launchMode 設定為 "maximized""maximizedFocus" ,則會忽略這個屬性。

屬性名稱:initialRows

必要性: 選用

接受: 整數

預設值:30



啟動位置

這會設定第一次載入時視窗左上角的像素位置。 在具有多個顯示器的系統上,這些座標會相對於主要顯示器的左上方。 如果未提供 X 或 Y 座標,終端機會針對該值使用系統預設值。 如果 launchMode 設定為 "maximized""maximizedFocus" ,則視窗將會在這些座標所指定的監視器上最大化。

屬性名稱:initialPosition

必要性: 選用

接受: 以下列格式字串形式顯示的座標:",""#,#""#,"",#"

預設值:","



啟動時置中

當設定為 true 時,終端機視窗會在開啟的顯示器上自動置中。 終端機會使用 "initialPosition" 來判斷要開啟的顯示器。

這會以下列方式與其他啟動設定互動:

  • "initialPosition": "x,y"、 、 "centerOnLaunch": true"launchMode": "default" : 置中于開啟的 x,y 監視器上。
  • "initialPosition": "x,y""centerOnLaunch": true"launchMode": "maximized" : 最大化在 (上的 centerOnLaunch 監視器 x,y 上,不會新增任何) 。
  • "initialPosition": <omitted>、、 "centerOnLaunch": true"launchMode": "default" :以預設監視器為中心。
  • "initialPosition": <omitted>、、 "centerOnLaunch": true"launchMode": "focus" :在預設監視器上置中並進入焦點模式。
  • "initialPosition": <omitted>"centerOnLaunch": true"launchMode": "maximized" :在預設監視器上最大化, (centerOnLaunch 新增任何) 。

屬性名稱:centerOnLaunch

必要性: 選用

接受:truefalse

預設值:false



停用動態設定檔

這樣會設定哪些動態設定檔產生器要停用,使其無法在啟動時將其設定檔新增至設定檔清單。 如需動態設定檔的詳細資訊,請造訪動態設定檔頁面

屬性名稱:disabledProfileSources

必要性: 選用

接受陣列內的:"Windows.Terminal.Wsl""Windows.Terminal.Azure""Windows.Terminal.PowershellCore" 和/或 "Windows.Terminal.SSH"

預設值:[]



啟動動作

這會設定啟動時要執行的動作清單,讓終端機預設會以一組自訂的索引標籤和窗格啟動。 只有在未提供任何命令列引數時,才會套用這些動作。 動作清單是以與命令列引數中命令相同的格式字串來表示。 如需命令格式的詳細資訊,請流覽 命令列引數頁面

屬性名稱:startupActions

必要性: 選用

接受: 字串,表示要執行的命令清單

預設值:""



繼續在背景 (Preview) 中執行

當設定為 true 時,這可讓終端機在最後一個視窗關閉之後繼續在背景中執行。 即使沒有開啟視窗,這仍允許 globalSummon喚醒模式 運作。 此設定僅適用于終端機的 預覽 組建。

屬性名稱:compatibility.allowHeadless

必要性: 選用

接受:truefalse

預設值:false