WinSSH

0.9.0

Public/Uninstall-WinSSH.ps1

                                <#

    .SYNOPSIS

        This function uninstalls OpenSSH-Win64 binaries, removes ssh-agent and sshd services (if they exist),

        and deletes (recursively) the directories "C:\Program Files\OpenSSH-Win64" and "C:\ProgramData\ssh"

        (if they exist).

        Outputs an array of strings describing the actions taken. Possible string values are:

        "sshdUninstalled","sshAgentUninstalled","sshBinariesUninstalled"

    .DESCRIPTION

        See .SYNOPSIS

    .NOTES

    .PARAMETER KeepSSHAgent

        This parameter is OPTIONAL.

        This parameter is a switch. If used, ONLY the SSHD server (i.e. sshd service) is uninstalled. Nothing

        else is touched.

    .EXAMPLE

        # Open an elevated PowerShell Session, import the module, and -

        PS C:\Users\zeroadmin> Uninstall-WinSSH

#>

function Uninstall-WinSSH {

    [CmdletBinding()]

    Param (

        [Parameter(Mandatory=$False)]

        [switch]$KeepSSHAgent

    )

    if (!$(GetElevation)) {

        Write-Error "You must run PowerShell as Administrator before using this function! Halting!"

        $global:FunctionResult = "1"

        return

    }

    #region >> Prep

    $OpenSSHProgramFilesPath = "C:\Program Files\OpenSSH-Win64"

    $OpenSSHProgramDataPath = "C:\ProgramData\ssh"

    <#

    $UninstallLogDir = "$HOME\OpenSSHUninstallLogs"

    $etwman = "$UninstallLogDir\openssh-events.man"

    if (!$(Test-Path $UninstallLogDir)) {

        $null = New-Item -ItemType Directory -Path $UninstallLogDir

    }

    #>

    #endregion >> Prep

    #region >> Main Body

    [System.Collections.ArrayList]$Output = @()

    if (Get-Service sshd -ErrorAction SilentlyContinue)  {

        try {

            Stop-Service sshd

            sc.exe delete sshd 1>$null

            Write-Host -ForegroundColor Green "sshd successfully uninstalled"

            $null = $Output.Add("sshdUninstalled")

            # unregister etw provider

            <#

            if (Test-Path $etwman) {

                wevtutil um `"$etwman`"

            }

            #>

        }

        catch {

            Write-Error $_

            $global:FunctionResult = "1"

            return

        }

    }

    else {

        Write-Host -ForegroundColor Yellow "sshd service is not installed"

    }

    if (!$KeepSSHAgent) {

        if (Get-Service ssh-agent -ErrorAction SilentlyContinue) {

            try {

                Stop-Service ssh-agent

                sc.exe delete ssh-agent 1>$null

                Write-Host -ForegroundColor Green "ssh-agent successfully uninstalled"

                $null = $Output.Add("sshAgentUninstalled")

            }

            catch {

                Write-Error $_

                $global:FunctionResult = "1"

                return

            }

        }

        else {

            Write-Host -ForegroundColor Yellow "ssh-agent service is not installed"

        }

        if (!$(Get-Module ProgramManagement)) {

            try {

                Import-Module ProgramManagement -ErrorAction Stop

            }

            catch {

                Write-Error $_

                $global:FunctionResult = "1"

                return

            }

        }

        try {

            $UninstallOpenSSHResult = Uninstall-Program -ProgramName openssh -ErrorAction Stop

            $null = $Output.Add("sshBinariesUninstalled")

        }

        catch {

            Write-Error $_

            $global:FunctionResult = "1"

            return

        }

        if (Test-Path $OpenSSHProgramFilesPath) {

            try {

                Remove-Item $OpenSSHProgramFilesPath -Recurse -Force

            }

            catch {

                Write-Error $_

                $global:FunctionResult = "1"

                return

            }

        }

        if (Test-Path $OpenSSHProgramDataPath) {

            try {

                Remove-Item $OpenSSHProgramDataPath -Recurse -Force

            }

            catch {

                Write-Error $_

                $global:FunctionResult = "1"

                return

            }

        }

    }

    [System.Collections.ArrayList][array]$Output

    #endregion >> Main Body

}

# SIG # Begin signature block

# MIIMiAYJKoZIhvcNAQcCoIIMeTCCDHUCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUK23MDbjKIDVawmwQDuTnXxpV

# pxugggn9MIIEJjCCAw6gAwIBAgITawAAAB/Nnq77QGja+wAAAAAAHzANBgkqhkiG

# 9w0BAQsFADAwMQwwCgYDVQQGEwNMQUIxDTALBgNVBAoTBFpFUk8xETAPBgNVBAMT

# CFplcm9EQzAxMB4XDTE3MDkyMDIxMDM1OFoXDTE5MDkyMDIxMTM1OFowPTETMBEG

# CgmSJomT8ixkARkWA0xBQjEUMBIGCgmSJomT8ixkARkWBFpFUk8xEDAOBgNVBAMT

# B1plcm9TQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDCwqv+ROc1

# bpJmKx+8rPUUfT3kPSUYeDxY8GXU2RrWcL5TSZ6AVJsvNpj+7d94OEmPZate7h4d

# gJnhCSyh2/3v0BHBdgPzLcveLpxPiSWpTnqSWlLUW2NMFRRojZRscdA+e+9QotOB

# aZmnLDrlePQe5W7S1CxbVu+W0H5/ukte5h6gsKa0ktNJ6X9nOPiGBMn1LcZV/Ksl

# lUyuTc7KKYydYjbSSv2rQ4qmZCQHqxyNWVub1IiEP7ClqCYqeCdsTtfw4Y3WKxDI

# JaPmWzlHNs0nkEjvnAJhsRdLFbvY5C2KJIenxR0gA79U8Xd6+cZanrBUNbUC8GCN

# wYkYp4A4Jx+9AgMBAAGjggEqMIIBJjASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsG

# AQQBgjcVAgQWBBQ/0jsn2LS8aZiDw0omqt9+KWpj3DAdBgNVHQ4EFgQUicLX4r2C

# Kn0Zf5NYut8n7bkyhf4wGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwDgYDVR0P

# AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUdpW6phL2RQNF

# 7AZBgQV4tgr7OE0wMQYDVR0fBCowKDAmoCSgIoYgaHR0cDovL3BraS9jZXJ0ZGF0

# YS9aZXJvREMwMS5jcmwwPAYIKwYBBQUHAQEEMDAuMCwGCCsGAQUFBzAChiBodHRw

# Oi8vcGtpL2NlcnRkYXRhL1plcm9EQzAxLmNydDANBgkqhkiG9w0BAQsFAAOCAQEA

# tyX7aHk8vUM2WTQKINtrHKJJi29HaxhPaHrNZ0c32H70YZoFFaryM0GMowEaDbj0

# a3ShBuQWfW7bD7Z4DmNc5Q6cp7JeDKSZHwe5JWFGrl7DlSFSab/+a0GQgtG05dXW

# YVQsrwgfTDRXkmpLQxvSxAbxKiGrnuS+kaYmzRVDYWSZHwHFNgxeZ/La9/8FdCir

# MXdJEAGzG+9TwO9JvJSyoGTzu7n93IQp6QteRlaYVemd5/fYqBhtskk1zDiv9edk

# mHHpRWf9Xo94ZPEy7BqmDuixm4LdmmzIcFWqGGMo51hvzz0EaE8K5HuNvNaUB/hq

# MTOIB5145K8bFOoKHO4LkTCCBc8wggS3oAMCAQICE1gAAAH5oOvjAv3166MAAQAA

# AfkwDQYJKoZIhvcNAQELBQAwPTETMBEGCgmSJomT8ixkARkWA0xBQjEUMBIGCgmS

# JomT8ixkARkWBFpFUk8xEDAOBgNVBAMTB1plcm9TQ0EwHhcNMTcwOTIwMjE0MTIy

# WhcNMTkwOTIwMjExMzU4WjBpMQswCQYDVQQGEwJVUzELMAkGA1UECBMCUEExFTAT

# BgNVBAcTDFBoaWxhZGVscGhpYTEVMBMGA1UEChMMRGlNYWdnaW8gSW5jMQswCQYD

# VQQLEwJJVDESMBAGA1UEAxMJWmVyb0NvZGUyMIIBIjANBgkqhkiG9w0BAQEFAAOC

# AQ8AMIIBCgKCAQEAxX0+4yas6xfiaNVVVZJB2aRK+gS3iEMLx8wMF3kLJYLJyR+l

# rcGF/x3gMxcvkKJQouLuChjh2+i7Ra1aO37ch3X3KDMZIoWrSzbbvqdBlwax7Gsm

# BdLH9HZimSMCVgux0IfkClvnOlrc7Wpv1jqgvseRku5YKnNm1JD+91JDp/hBWRxR

# 3Qg2OR667FJd1Q/5FWwAdrzoQbFUuvAyeVl7TNW0n1XUHRgq9+ZYawb+fxl1ruTj

# 3MoktaLVzFKWqeHPKvgUTTnXvEbLh9RzX1eApZfTJmnUjBcl1tCQbSzLYkfJlJO6

# eRUHZwojUK+TkidfklU2SpgvyJm2DhCtssFWiQIDAQABo4ICmjCCApYwDgYDVR0P

# AQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBS5d2bhatXq

# eUDFo9KltQWHthbPKzAfBgNVHSMEGDAWgBSJwtfivYIqfRl/k1i63yftuTKF/jCB

# 6QYDVR0fBIHhMIHeMIHboIHYoIHVhoGubGRhcDovLy9DTj1aZXJvU0NBKDEpLENO

# PVplcm9TQ0EsQ049Q0RQLENOPVB1YmxpYyUyMEtleSUyMFNlcnZpY2VzLENOPVNl

# cnZpY2VzLENOPUNvbmZpZ3VyYXRpb24sREM9emVybyxEQz1sYWI/Y2VydGlmaWNh

# dGVSZXZvY2F0aW9uTGlzdD9iYXNlP29iamVjdENsYXNzPWNSTERpc3RyaWJ1dGlv

# blBvaW50hiJodHRwOi8vcGtpL2NlcnRkYXRhL1plcm9TQ0EoMSkuY3JsMIHmBggr

# BgEFBQcBAQSB2TCB1jCBowYIKwYBBQUHMAKGgZZsZGFwOi8vL0NOPVplcm9TQ0Es

# Q049QUlBLENOPVB1YmxpYyUyMEtleSUyMFNlcnZpY2VzLENOPVNlcnZpY2VzLENO

# PUNvbmZpZ3VyYXRpb24sREM9emVybyxEQz1sYWI/Y0FDZXJ0aWZpY2F0ZT9iYXNl

# P29iamVjdENsYXNzPWNlcnRpZmljYXRpb25BdXRob3JpdHkwLgYIKwYBBQUHMAKG

# Imh0dHA6Ly9wa2kvY2VydGRhdGEvWmVyb1NDQSgxKS5jcnQwPQYJKwYBBAGCNxUH

# BDAwLgYmKwYBBAGCNxUIg7j0P4Sb8nmD8Y84g7C3MobRzXiBJ6HzzB+P2VUCAWQC

# AQUwGwYJKwYBBAGCNxUKBA4wDDAKBggrBgEFBQcDAzANBgkqhkiG9w0BAQsFAAOC

# AQEAszRRF+YTPhd9UbkJZy/pZQIqTjpXLpbhxWzs1ECTwtIbJPiI4dhAVAjrzkGj

# DyXYWmpnNsyk19qE82AX75G9FLESfHbtesUXnrhbnsov4/D/qmXk/1KD9CE0lQHF

# Lu2DvOsdf2mp2pjdeBgKMRuy4cZ0VCc/myO7uy7dq0CvVdXRsQC6Fqtr7yob9NbE

# OdUYDBAGrt5ZAkw5YeL8H9E3JLGXtE7ir3ksT6Ki1mont2epJfHkO5JkmOI6XVtg

# anuOGbo62885BOiXLu5+H2Fg+8ueTP40zFhfLh3e3Kj6Lm/NdovqqTBAsk04tFW9

# Hp4gWfVc0gTDwok3rHOrfIY35TGCAfUwggHxAgEBMFQwPTETMBEGCgmSJomT8ixk

# ARkWA0xBQjEUMBIGCgmSJomT8ixkARkWBFpFUk8xEDAOBgNVBAMTB1plcm9TQ0EC

# E1gAAAH5oOvjAv3166MAAQAAAfkwCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcCAQwx

# CjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGC

# NwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFL1m6VwiaSXa3vvC

# GQE1Wcwo/DPcMA0GCSqGSIb3DQEBAQUABIIBAFhEC0qktUyHM1sbCfZz399r3vnZ

# qo+YMNmHbCt10qJc3b8vLu0lOpq4PDHExOGdHsTpUJzue6lmaqFsSps6wv8lXIdy

# mHg0LAR8bJwvphLR0JXG+p87x6QSZIvZV2/eneYaD/9UX12tsb0AjtjJTdgX7n1V

# wGV+5pbFjIi7nk4zNWNKb/AL6EO3jffGdg+Umnzowi4ctfDyuQQsc/Clvra79tHM

# o3oZS+W/x1J1iBZhM6kVrxBsPtqvIsN4X9of+aWLBrwMqmBUChlgwwl8951B17yb

# Hs1dAJ+FxW0Vf4X6iAy2xVPY55b4EOwwsICRMpfH0ptMueRhgs49m7mOZh4=

# SIG # End signature block