Set-MSTerminalSetting

NAME Set-MSTerminalSetting



SYNOPSIS

Updates the top-level settings for MS Terminal.





SYNTAX

Set-MSTerminalSetting [[-DefaultProfile] <String>] [[-InitialRows] <Int32>] [[-InitialCols] <Int32>]

[[-RequestedTheme] {light | dark | system}] [[-WordDelimiters] <String>] [[-Clear] <String[]>] [[-ExtraSettings]

<Hashtable>] [-AlwaysShowTabs] [-Confirm] [-CopyOnSelect] [-ShowTabsInTitlebar] [-ShowTerminalTitleInTitlebar]

[-WhatIf] [<CommonParameters>]





DESCRIPTION

Updates the top-level settings for MS Terminal.





PARAMETERS

-AlwaysShowTabs [<SwitchParameter>]

Show tabs even when there is only a single console application running.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-Clear <String[]>

A list of global settings to remove. This takes precedence over any other value being set by this cmdlet.



Required? false

Position? 5

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-CopyOnSelect [<SwitchParameter>]

When set, a selection is immediately copied to your clipboard upon creation. When set to false

(-CopyOnSelect:$False), the selection persists and awaits further action.



If not specified or cleared, the terminal default value is $False.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <String>

The GUID of the profile to launch when MS Terminal is opened. Use Get-MSTerminalProfile |

Set-MSTerminalProfile -MakeDefault to set the default without using the GUID.



Required? false

Position? 0

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ExtraSettings <Hashtable>

{{ Fill ExtraSettings Description }}



Required? false

Position? 6

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InitialCols <Int32>

The number of columns to launch with.



Required? false

Position? 2

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-InitialRows <Int32>

The number of rows to launch with.



Required? false

Position? 1

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RequestedTheme <String>

Sets the theme of the tab bar. Possible values: "light", "dark", "system"



Required? false

Position? 3

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ShowTabsInTitlebar [<SwitchParameter>]

When set to 'true', the tabs are moved into the titlebar and the titlebar disappears. When set to 'false', the

titlebar sits above the tabs.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-ShowTerminalTitleInTitlebar [<SwitchParameter>]

Show the current console application's title in the MS Terminal title bar.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-WordDelimiters <String>

Determines the delimiters used in a double click selection.



Default terminal value: /()"'-:,.;<>~!@#$%^&*|+=[]{}~?????????



Required? false

Position? 4

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None







OUTPUTS

None







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> Set-MSTerminalSetting -Initialrows 50 -AlwaysShowTabs



Sets the inital rows to 50 and enables always showing tabs.



RELATED LINKS