PoshCode Archive  Artifact [16368cf6e7]

Artifact 16368cf6e7fdff90c01950d4c4b76354b1849fe3be51741f264ca25403e937a2:

  • File SharpSSH-Module.ps1 — part of check-in [0f81aa8c25] at 2018-06-10 14:27:48 on branch trunk — As promised, I started to expand on Joel’s functions (http://poshcode.org/877). A lot of stuff is missing, but… I have big plans for this module and a PKI module I want to write. (user: tysonkopczynski size: 6662)

# encoding: ascii
# api: powershell
# title: SharpSSH Module
# description: As promised, I started to expand on Joel’s functions (http://poshcode.org/877).  A lot of stuff is missing, but… I have big plans for this module and a PKI module I want to write.
# version: 0.1
# type: function
# author: tysonkopczynski
# license: CC0
# function: New-SharpSession
# x-poshcode-id: 979
# x-archived: 2011-12-30T05:26:42
# x-published: 2011-03-29T04:31:00
#
#
##################################################
# cmdlets
##################################################
#-------------------------------------------------
# New-SharpSession
#-------------------------------------------------
# Usage:		New-SharpSession -?
#-------------------------------------------------
function New-SharpSession {
	<# 
    .Synopsis
    	Used to open an SSH or SCP Session to the specified server.
    .Description
    	Uses SharpSSH to open an SSH or SCP Session to the specified server.
    .Parameter Host
    	The hostname or IP address that you want to connect to.
    .Parameter UserName
    	The username string used for the connection.
    .Parameter Key
    	The switch that tells function to execute with key parameters.
    .Parameter KeyFile
    	The path and file name to the key file used for key based
    	authentication.
    .Parameter User
    	The switch that tells function to execute with user parameters.
    .Parameter Password
    	The password string used for the connection.
	#> 
    [CmdletBinding(DefaultParameterSetName="KeySet")]
    param(
	[Parameter(Mandatory=$True)][String]$Host,
	[Parameter(Mandatory=$True)][String]$UserName,
	[Parameter(ParameterSetName="KeySet")][Switch]$Key,
        [Parameter(ParameterSetName="KeySet", Mandatory=$True)][String]$KeyFile,
        [Parameter(ParameterSetName="User")][Switch]$User,
        [Parameter(ParameterSetName="User", Mandatory=$True)][String]$Password,
	[Switch]$SCP,
	[Switch]$PassThru
        )
	
	try {
		# Default will always be to do SSH...
		if ($SCP){
			$ConnectType = "Tamir.SharpSsh.scp"
			}
		else{
			$ConnectType = "Tamir.SharpSsh.SshShell"
			}
		
		if ($Key -and (Test-Path $KeyFile)){
			$Global:SharpSession = New-Object $ConnectType $Host, $UserName
			$Global:SharpSession.AddIdentityFile((Resolve-Path $KeyFile))
			}
		else{
			$Global:SharpSession = New-Object $ConnectType $Host, $UserName, $Password
			}
			
		$Global:SharpSession.Connect()
		
		if ($ConnectType -eq "Tamir.SharpSsh.SshShell"){
			$Global:SharpSession.RemoveTerminalEmulationCharacters = $True
			}
		
		if($PassThru){
			return $Global:SharpSession
			}
		}
	catch {
		throw $Error[0]
		}
	}

#-------------------------------------------------
# Transfer-SharpFile
#-------------------------------------------------
# Usage:		Transfer-SharpFile -?
#-------------------------------------------------
function Transfer-SharpFile {
	<# 
    .Synopsis
    	Used to tranfser(get or put) a file using a valid SCP SharpSession.
    .Description
    	Uses SharpSSH to tranfer (get or put) a file via SCP.
    .Parameter From
    	The full path and file name to the file you are transferring.
    .Parameter To
    	The full path and file name to where you want to copy the file to.
	#> 
    param(
	[Parameter(Mandatory=$True)][String]$From,
	[Parameter(Mandatory=$True)][String]$To,
	[Switch]$Get,
	[Switch]$Put
		)
	
	try {
		if (!($Get -or $Put)) {
			throw Write-Host "Get or Put must be defined!" -ForeGroundColor Red
			}
	
		if ($SharpSession.GetType().Fullname -ne "Tamir.SharpSsh.Scp"){
			throw Write-Host "Not currently connected using SCP!" -ForeGroundColor Red
			}
		else{
			# The action scriptblock for an EventObject must have
			# things defined in the Global scope.  Yuck!
			$Global:SharpSessiontransferDone = $Null
			$Global:SharpSessiontotalBytes = $Null
			$Global:SharpSessiontransferredBytes = $Null
						
			[void] (Register-ObjectEvent  -InputObject $SharpSession -EventName OnTransferProgress -SourceIdentifier Scp.OnTransferProgress `
				-Action {$Global:SharpSessiontotalBytes = $args[3]; $Global:SharpSessiontransferredBytes = $args[2]})
			[void] (Register-ObjectEvent  -InputObject $SharpSession -EventName OnTransferEnd -SourceIdentifier Scp.OnTransferEnd `
				-Action {$Global:SharpSessiontransferDone = $True})
	
			# Default is always to get.
			if ($Get){
				$SharpSession.Get($From, $To)
				
				try{
					do {Write-Progress -Activity "Get - $($From)" -Status "Copying" `
						-PercentComplete (($SharpSessiontransferredBytes/$SharpSessiontotalBytes)*100)} while ($SharpSessiontransferDone -eq $Null)
					}
				catch{
					Write-Warning "File is not there..."
					}
				}
			else{
				$SharpSession.Put($From, $To)
				
				try{
					do {Write-Progress -Activity "Get - $($From)" -Status "Copying" `
						-PercentComplete (($SharpSessiontransferredBytes/$SharpSessiontotalBytes)*100)} while ($SharpSessiontransferDone -eq $Null)
					}
				catch{
					Write-Warning "File is not there..."
					}
				}
			}
		}
	catch {
		throw $Error[0]
		}
	finally {
		if (Get-EventSubscriber -SourceIdentifier Scp.OnTransferProgress){
			[void] (Unregister-Event -SourceIdentifier Scp.OnTransferProgress)
			}
		if (Get-EventSubscriber -SourceIdentifier Scp.OnTransferEnd){
			[void] (Unregister-Event -SourceIdentifier Scp.OnTransferEnd)
			}
		}
	}
	
#-------------------------------------------------
# Remove-SharpSession
#-------------------------------------------------
# Usage:		Remove-SharpSession -?
#-------------------------------------------------
function Remove-SharpSession {
	<# 
    .Synopsis
    	Used to close an active SSH or SCP Session.
    .Description
    	Uses SharpSSH to close an active SSH or SCP Session.
	#> 
	
	try {
		if($SharpSession){
			if ($SharpSession.GetType().Fullname -eq "Tamir.SharpSsh.SshShell"){
				$SharpSession.WriteLine("exit")
				sleep -milli 500
	
				if($SharpSession.ShellOpened) {
					Write-Warning "Shell didn't exit cleanly, closing anyway." 
					}
				
				$SharpSession.Close()
				}
			else{
				$SharpSession.Close()
				}
			}
		else{
			throw "There is no session to remove!"
			}
		}
	catch {
		throw $Error[0]
		}
	finally {
		$Global:SharpSession = $Null
		}
	}	
	
##################################################
# Main
##################################################
Export-ModuleMember New-SharpSession
Export-ModuleMember Transfer-SharpFile
Export-ModuleMember Remove-SharpSession