Windows Terminali ile Çapraz Platform PowerShell Profilleri

Bu haftanın başlarında, uzak bir PowerShell oturumu açacak bir Windows Terminal profili oluşturmaya yönelik tekniklerimi paylaşmıştım. Ancak PowerShell 7 ile Windows olmayan makinelere de SSH kullanarak bağlanabiliyorum. Öyleyse neden kodumu bir Linux kutusuna bağlanmaya izin verecek şekilde genişletmiyorsunuz? Paylaşacağım herhangi bir şeyi denemeden önce, SSH kullanarak Linux hedefinize manuel olarak bir PSSession oluşturabildiğinizden ve girebildiğinizden emin olun. Bunu yapabiliyorsanız, bir Windows Terminal profili oluşturabilirsiniz.

Bağlantı Komut Dosyası

Uzaktan iletişim oturumunu oluşturmak için mevcut komut dosyamı değiştirdim. powershell yerine pwsh'i çağırmam gerekeceğinden, uygun parametrelerle ikinci bir komut dosyası oluşturabilirdim. Ama sonra sürdürmek için senaryo yazmam gerekecekti. Bunun yerine wtpsremote.ps1 betiğimi değiştirdim ve parametre kümelerini kullandım.

Komut dosyasını, sorun giderme sırasında yardımcı olacak ayrıntılı mesajları da içerecek şekilde güncelledim. Ve daha iyi hata yönetimi.

#requires -version 5.1

<#
.Synopsis
Create a remote PowerShell session
.Description
This script is intended to be called from a Windows Terminal profile to create
a PowerShell remoting session. If you are using the ssh parameter set, you 
will need to invoke this script with pwsh.
.Link
New-PSSession
.Link
Enter-PSSession
#>

[cmdletbinding(DefaultParameterSetName = "Computer")]
Param(
    [Parameter(Position = 0, Mandatory, HelpMessage = "Specify remote computer name",ParameterSetName="Computer")]
    [ValidateNotNullOrEmpty()]
    [string]$Computername,
    [Parameter(ParameterSetName="Computer")]
    [pscredential]$Credential,
    [Parameter( HelpMessage = "A profile script to run in the remote session")]
    [ValidateScript( {Test-Path $_})]
    [string]$RemoteProfile,
    [Parameter(HelpMessage = "Specify a remote endpoint other than the default Microsoft.powershell")]
    [string]$ConfigurationName,
    [Parameter(HelpMessage = "Specify an alternate port number")]
    [int32]$Port,
    [Parameter(ParameterSetName="Computer")]
    [switch]$UseSSL,
    [Parameter(Position = 0, Mandatory,ParameterSetName = "ssh")]
    [ValidateNotNullorEmpty()]
    [string]$Hostname,
    [Parameter(ParameterSetName = "ssh")]
    [string]$Username,
    [Parameter(ParameterSetName = "ssh")]
    [string]$Subsystem,
    [Parameter(ParameterSetName = "ssh")]
    [string]$KeyFilePath
)

Write-Verbose "Starting $($MyInvocation.MyCommand)"
Write-Verbose "Using parameter set $($pscmdlet.parametersetname)"
if ($PSCmdlet.ParameterSetName -eq "ssh") {
    Write-Verbose "adding SSHTransport parameter"
    [void]($PSBoundParameters.add("SSHTransport",$True))
}
#remove this this parameter if specified since it can't be used to create a new PSSession
if ($PSBoundParameters.ContainsKey("RemoteProfile")) {
    Write-Verbose "Removing RemoteProfile bound parameter"
    [void]($PSBoundParameters.Remove("RemoteProfile"))
}

#Create a new remoting session splatting the parameters passed to this script
Try {
    Write-Verbose "Using these parameters to create the PSSession"
    $PSBoundParameters | Out-String | Write-Verbose
    $remote = New-PSSession @PSBoundParameters -errorAction Stop
    $remote | Out-String | Write-Verbose
}
Catch {
    Write-Verbose "Failed to create remoting session"
    Throw $_
}
#run the remote profile script
if ($RemoteProfile) {
    Write-Verbose "Running remote profile script $RemoteProfile"
    Invoke-Command -Session $remote -FilePath $RemoteProfile -HideComputerName |
    Select-Object -property * -ExcludeProperty runspaceID
}

#open the pssession
Write-Verbose "Entering session"
Enter-PSSession -session $remote

$msg = @"
-------------------------------------------------------------------------------------
| Reminder:                                                                         |
| Remove the `$remote pssession after you exit and before you close the profile tab. |
|                                                                                   |
| PS C:\> `$remote | Remove-PSSession                                                |
| PS C:\> exit                                                                      |
-------------------------------------------------------------------------------------

"@

#you may need to adjust colors based on your profile settings
Write-host $msg -ForegroundColor Magenta -BackgroundColor Gray

Windows Terminal Profili

Bu komut dosyasıyla Linux oturumum için bir Windows Terminal profili oluşturabilirim.

{
    "acrylicOpacity": 0.8,
    "closeOnExit": true,
    "colorScheme": "Campbell",
    "commandline": "C:\\Program Files\\PowerShell\\7-preview\\preview\\pwsh-preview.cmd -nologo -noprofile -noexit -file c:\\scripts\\wtpsremote.ps1 -hostname fred-company-com -username jeff -remoteprofile c:\\scripts\\lxprofile.ps1",
    "cursorColor": "#FFFFFF",
    "cursorShape": "underscore",
    "fontFace": "Cascadia Code",
    "fontSize": 14,
    "guid": "{5668446e-620a-448f-874b-db766831b2ab}",
    "historySize": 9001,
    "icon": "ms-appx:///ProfileIcons/{574e775e-4f2a-5b96-ac1e-a2962a402336}.png",
    "name": "Fred",
    "padding": "0, 0, 0, 0",
    "snapOnInput": true,
    "startingDirectory": "C:\\",
    "tabTitle": "PSRemote: Fred",
    "backgroundImage": "C:\\users\\jeff\\Pictures\\smoking-penguin.jpg",
    "backgroundImageAlignment": "center",
    "backgroundImageStretchMode": "none",
    "backgroundImageOpacity": 0.3,
    "useAcrylic": true
}

Sonunda pwsh'e giden son yolu kullanmak için bu profili güncelleyeceğim.

Linux Profil Komut Dosyası

Hala uzak profil komut dosyasını çalıştırma seçeneğini sunuyorum. Sonuçta hala bir PSSession. Bu, Linux bağlantılarım için kullandığım komut dosyasıdır.

# this is for Linux based computers
 $os = $PSVersionTable.OS
 $lsb = lsb_release -d
 $osver = ($lsb -split ":")[1].Trim()
 $elevated = "N/A"
 $user = [System.Environment]::UserName
 $computer = [System.Environment]::MachineName
 #object properties will be displayed in the order they are listed here
 [pscustomObject]@{
     User            = $user
     Elevated        = $elevated
     Computername    = $computer
     OperatingSystem = $os
     OSVersion       = $osver
     PSVersion       = $PSVersionTable.PSVersion.ToString()
     Edition         = $PSVersionTable.PSEdition
     PSHost          = $host.Name
     WSMan           = $PSVersionTable.WSManStackVersion.ToString()
     ExecutionPolicy = (Get-ExecutionPolicy)
     Culture         = [System.Globalization.CultureInfo]::CurrentCulture.NativeName
 }
 $initiated = Get-Date
 $remotePrompt = {
     #display the session runtime without the milliseconds
     $ts = ((Get-Date) - $initiated).ToString().split(".")[0]
     Write-Host ">$ts< " -ForegroundColor yellow -nonewline     "PS $($executionContext.SessionState.Path.CurrentLocation)$('>' * ($nestedPromptLevel + 1)) ";
 }
 Set-Item -Path function:\prompt -Value $remotePrompt -Force

Oturumun ne kadar süredir çalıştığını göstermek için aynı istem konseptini kullanıyorum. İşte sonuç

Bu noktada tüm PowerShell uzaktan iletişim ihtiyaçlarım için Windows Terminali kullanabiliyorum ve ihtiyacım olan her şeye tek bir yerde sahip olabiliyorum. Umarım bu güncellemeler hakkında ne düşündüğünüzü bana bildirirsiniz.

İlgili makaleler