Skip to main content

SSH into Linux boxes with PowerShell from Windows Server 2016

With an ever-changing IT environment, you need a way to manage everything from a centralized location, if possible. If you're in a Windows/Linux hybrid environment, PowerShell is your friend. Let's get started.

First, you will need a nifty little module called Posh-SSH on your Windows Server/Desktop. You can install this by running;

Install-Module Posh-SSH

 After that, you want to ensure SSH is configured on your Linux box. Depending on what distro, these settings may vary. I personally like using open-SSH. You can check the status of SSH on your Linux box by typing;

sudo service ssh status


After that, we will be good to start an SSH session from our Windows Server/Desktop.

The first thing we want to do is open up PowerShell ISE. We also want to ensure to store this SSH session into a variable. Use the following one-liner;

$Sess = New-SSHSession -ComputerName IPADDRESS -Credential (get-credential)


 When the credentials pop up, you will type in your username and password. (please note: you don't have to do username@hostname or username@ipaddress like you would in traditional SSH).


Next, we want to run Get-SSHSession  to confirm an SSH session has been open. You should see something like the following;


Finally, we are ready to run our command. We will use the Invoke-SSHCommand cmdlet to run our command. In my case, I'm going to use a simple "ls" to list some files.

Invoke-SSHCommand -SSHSession $Sess -Command {ls}

 You should see output like this;


There you have it! You have officially ran SSH from Windows to Linux. I'll leave you with a quick and dirty function/cmdlet that I created to create multiple SSH sessions and the ability to run a command against multiple Linux boxes.


Function New-SSHConnection {
    
    [cmdletbinding(SupportsShouldProcess = $true, ConfirmImpact = 'High')]
    Param (
        [Parameter(ParameterSetName = 'DeviceIP',
            Position = 0,
            ValueFromPipeline,
            ValueFromPipelineByPropertyName)]
        [string[]]$deviceIP,

        [Parameter(ParameterSetName = 'DeviceHostname',
            Position = 0,
            ValueFromPipeline,
            ValueFromPipelineByPropertyName)]
        [string[]]$Hostname,

        [Parameter(Mandatory,
            HelpMessage = 'Please enter a command you would like to run on the device')]
        [string]$Command,

        [Parameter(Mandatory,
            HelpMessage = 'Please enter a username for your device you want to SSH into')]
        [string]$Username

    )
    Begin {
        Add-Type -AssemblyName System;
        Add-Type -AssemblyName System.Management.Automation;

        Import-Module Posh-SSH
        Write-Output "Starting: ($($MyInvocation.MyCommand.Name))"
        $Pass = New-Object System.Management.Automation.PSCredential -ArgumentList  $Username, (Read-Host 'Please enter password' | ConvertTo-SecureString -AsPlainText -Force)
        
        #If DeviceIP is selected, use this array
        $deviceArray = @()
        $deviceArray += $deviceIP

        #If Hostname is selected, use this array
        $deviceArray2 = @()
        $deviceArray2 += $Hostname
    }
    Process {
        if ($PSCmdlet.ShouldProcess($deviceIP -or $PSCmdlet.ShouldProcess($Hostname))) {
            if ($deviceIP) {
                $SSHSession = New-SSHSession -ComputerName $deviceArray -Credential $Pass
            }   

            elseif ($Hostname) {
                $SSHSession = New-SSHSession -ComputerName $deviceArray -Credential $Pass
            }
        }
    
        Foreach ($Device in $SSHSession) {
            $invokeSSHCommandPARAMS = @{
                'SSHSession'       = $Device
                'Command'          = $Command
                'EnsureConnection' = $true
            }
            $invokeSSHCommand = Invoke-SSHCommand @invokeSSHCommandPARAMS
            
            $invokeSSHCommandOBJECT = [pscustomobject] @{
                'IP_or_Host'    = $invokeSSHCommand.Host
                'CommandOutput' = $invokeSSHCommand.Output
            }
            $invokeSSHCommandOBJECT

            Start-sleep -Seconds 7
        }           
    }#Process
    End {Get-SSHSession | Remove-SSHSession}
}#Function

Comments

Popular posts from this blog

DevOps tooling in the Microsoft realm

When I really started to dive into automation and practicing DevOps with specific tooling, there were a few key players. At the time Microsoft was not one of them. They were just starting to embrace the open source world, including the art and practice of DevOps. Since then Microsoft has went all in and the tech giant has made some incredible tooling. Recently I switched to a Microsoft-heavy environment and I love it. I went from AWS/Python/Ansible/Jenkins to Azure/PowerShell/ARM/Azure DevOps. My first programming language was PowerShell so being back in the saddle allowed me to do a full circle between all of the different types of tooling in both worlds. Today I want to share some of that tooling with you.

The first thing I want to talk about is ARM. What is ARM? ARM is a configuration management tool that allows you to perform software-defined-infrastructure. Much like Ansible and Terraform, ARM allows you to define what you want your environment to look like at scale. With ARM, yo…

Monitoring your containers in an AKS cluster with Prometheus

Monitoring and alerting is arguably one of the most important thing in Cloud Engineering and DevOps. It's the difference between your clients stack being up and a client being down. Most of us have SLA's to abide by (for good reason). Today we're going to learn how to spin up Prometheus in an AKS cluster to monitor our applications.

Pre-reqs;
1. Intermediate knowledge of Kubernetes
2. An AKS cluster spun up in Azure

Recently AKS supports Prometheus via Helm, so we'll use that for an automated solution to spin this up. This installs kube-prometheus, which is a containerized version of the application. With raw Prometheus, there are a few things that are needed for the operator;

1. Prometheus: Defines a desired deployment.
2. ServiceMonitor: Specifies how groups of services should be monitored
3. Alertmanager: Defines the operator to ensure services and deployments are running by matching the resource

With kube-prometheus, it is all packaged for you. This means configuri…

So, you want to be a Cloud Engineer?

In 2019 one of the biggest pieces of tech is the cloud. Whether it be public cloud or private cloud, cloud technologies are here to stay (for now). I predict that Cloud Engineering will be a very big part of IT (and development) for another 5-10 years. Today I want to share with you my journey in becoming a Cloud Engineer and some helpful tips. A career timeline to be a Cloud Engineer can go like so;

Desktop Support > Junior Sysadmin > Sysadmin > Sysadmin/Technical Lead > Engineer >  Cloud Engineer.

Although our career paths may not align, I believe that this progression is very import. Let me tell you why.



Helpdesk/Desktop Support Helpdesk and desktop support get your feet wet. It allows you to understand technology and how it's used in the workplace from a business perspective. It shows you what technologies may be best in the current environment your in and how to support those technologies. It also teaches you soft skills and how to support people from a technic…