Start-WT.ps1
|
function Start-WT { <# .Synopsis Starts a new instance of Windows Terminal .Description Starts a new instance of Windows Terminal, and sends commands to it. .Link Get-WTProfile .Example Start-WT .Example Start-WT -Profile PowerShell .Example Start-WT -Profile 'Windows PowerShell' -CommandLine 'powershell -nologo' .Example [PSCustomObject]@{ Profile = 'Windows PowerShell' CommandLine = {powershell -nologo -noexit -command $psVersionTable} }, [PSCustomObject]@{ Profile = 'PowerShell' CommandLine = {%programFiles%\PowerShell\7\pwsh -nologo -noexit -command $psVersionTable} } | Start-WT -Verbose #> [OutputType([Nullable],[Diagnostics.Process])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute( "PSUseShouldProcessForStateChangingFunctions", "", Justification="Not changing state" )] param( # The name of the Windows Terminal Tab profile [Parameter(ValueFromPipelineByPropertyName)] [Alias('Profile')] [string] $ProfileName, # The working directory used by Windows Terminal [Parameter(ValueFromPipelineByPropertyName)] [string] $WorkingDirectory, # The command line run by Windows Terminal [Parameter(ValueFromPipelineByPropertyName)] [string] $CommandLine, # If set, will split the pane. [Parameter(ValueFromPipelineByPropertyName)] [switch] $Split, # If provided, will split the pane horizontally or veritcally [Parameter(ValueFromPipelineByPropertyName)] [ValidateSet('Horizontal','H', 'Vertical','V')] [string] $SplitDirection, # If provided, will focus a given tab index. [Parameter(ValueFromPipelineByPropertyName)] [int] $FocusTabIndex, # If provided, will focus the next tab. [Parameter(ValueFromPipelineByPropertyName)] [Alias('Next')] [switch] $FocusNextTab, # If provided, will focus the previous tab. [Parameter(ValueFromPipelineByPropertyName)] [Alias('Previous')] [switch] $FocusPreviousTab, # If set, will return the created process. [switch] $Passthru, # If set, will start the process elevated [Alias('RunAsAdministrator')] [switch] $Elevated ) begin { $allArgs = [Collections.Generic.List[Object]]::new() } process { $allArgs.AddRange( @( #region New Tabs and Panes if ($CommandLine -or $ProfileName -or $WorkingDirectory) { if ($Split -or $SplitDirection) { $(if ($wtArgs.Count) {';'} else {''}) + $( if ($Split) { 'split-pane' } elseif ('Horizontal','H' -contains $SplitDirection) { 'split-pane -H' } elseif ('Vertical','V' -contains $SplitDirection) { 'split-pane -V' } ) } else { $(if ($wtArgs.Count) {';'} else {''}) + 'new-tab' } if ($ProfileName) { '--profile' "`"$ProfileName`"" } if ($WorkingDirectory) { '--startingDirectory' $WorkingDirectory } if ($CommandLine) { $CommandLine -replace ';' ,'\;' } } #endregion New Tabs and Panes #region Tab Focus elseif ($FocusNextTab -or $FocusPreviousTab -or $FocusTabIndex -ge 0) { ';focus-tab' if ($FocusTabIndex -ge 0) { '--target' $FocusTabIndex } elseif ($FocusNextTab) { '--next' } elseif ($FocusPreviousTab) { '--previous' } }) #endregion Tab Focus ) } end { Write-Verbose "$allArgs" if ($Elevated) # If we're going to run elevated, { # we actually need to start wt.exe from a process that is already elevated # so we'll launch PowerShell, and pass the -command $EmbeddedArguments = "@($( foreach ($arg in $allArgs) { $strArg = "$arg" if ($strArg.Contains([Environment]::NewLine)) { "@' $($strArg + [Environment]::Newline)'@" + [Environment]::NewLine } else { "'$strArg';" } } ))" $myPowerShell = Get-Process -Id $pid | Select-Object -ExpandProperty Path if ($myPowerShell -like '*_ise*') { $myPowerShell = Get-Command powershell | Select-Object -ExpandProperty Path } Start-Process -FilePath $myPowerShell -ArgumentList '-command', "Start-Process wt.exe -ArgumentList $EmbeddedArguments" -Verb Runas } else { Start-Process wt.exe -ArgumentList $allArgs -PassThru:$PassThru } } } |