Windows 終端機中的啟動設定

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

預設設定檔

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

屬性名稱:defaultProfile

必要性: 必要

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

預設值: PowerShell 的 GUID



預設終端機應用程式

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

屬性名稱: 這會修改作業系統設定,而且在 設定 json檔案內沒有屬性名稱。

必要性: 必要

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

預設值: Windows 主控台主機

重要

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



在電腦啟動時啟動

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

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

屬性名稱:startOnUserLogin

必要性: 選用

接受:truefalse

預設值:false



開始新的終端機會話時的行為

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

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

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

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

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

  • 如果您的 shell 設定為報告將儲存的目前工作目錄

屬性名稱:firstWindowPreference

必要性: 選用

接受:"defaultProfile""persistedWindowLayout"

預設值:"defaultProfile"



啟動模式

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

屬性名稱:launchMode

必要性: 選用

接受:"default""maximized""fullscreen""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""launchMode": "default"的監視器 x,y 上的、 "centerOnLaunch": true : center。
  • "initialPosition": "x,y"、, "launchMode": "maximized" :在 (centerOnLaunch 的監視器 x,y 上最大化, "centerOnLaunch": true 不會新增任何) 。
  • "initialPosition": <omitted>"centerOnLaunch": true"launchMode": "default" :在預設監視器上置中。
  • "initialPosition": <omitted>"centerOnLaunch": true"launchMode": "focus" : center 並在預設監視器上輸入焦點模式。
  • "initialPosition": <omitted>"centerOnLaunch": true"launchMode": "maximized" :預設監視器上的最大化 (centerOnLaunch 不會加入任何) 。

屬性名稱:centerOnLaunch

必要性: 選用

接受:truefalse

預設值:false



停用動態設定檔

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

屬性名稱:disabledProfileSources

必要性: 選用

在陣列中接受:"Windows.Terminal.Wsl""Windows.Terminal.Azure" 和(或 "Windows.Terminal.PowershellCore"

預設值:[]



啟動動作

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

屬性名稱:startupActions

必要性: 選用

接受: 代表要執行之命令清單的字串

預設值:""