VBScript

SSH Quick/Simple Shell Session

Demonstrates the simplified way to run multiple commands in a shell session using QuickShell, which combines OpenSessionChannel, SendReqPty, and SendReqShell into one call. The commands are built in a StringBuilder, sent together, and the output is read up to a marker echoed by the final command.

Background: Note that QuickShell does allocate a PTY, so the remote shell runs interactively: it prints a prompt and echoes back every command sent to it, and both the echo and the real output appear in what is received. That is what motivates the quoting trick on the final marker — writing echo THIS 'IS' THE END means the echoed command line contains the quotes while the command's actual output does not, so matching the unquoted text reliably matches the real output instead of the echo. For clean, prompt-free output, request a shell without a PTY instead.

Chilkat VBScript Downloads

Download Chilkat for VBScript

VBScript

Dim fso, outFile
Set fso = CreateObject("Scripting.FileSystemObject")
'Create a Unicode (utf-16) output text file.
Set outFile = fso.CreateTextFile("output.txt", True, True)

success = 0

'  This example requires the Chilkat API to have been previously unlocked.
'  See Global Unlock Sample for sample code.

'  Demonstrates the simplified way to run multiple commands in a shell session using QuickShell.
'  
'  Note: QuickShell internally does OpenSessionChannel, SendReqPty, and SendReqShell, so it DOES
'  allocate a pseudo-terminal.  The remote shell therefore runs interactively: it prints a
'  command prompt and echoes back the commands that are sent to it.  Both the echoed input and
'  the real output appear in what is received.

set ssh = CreateObject("Chilkat.Ssh")

port = 22
success = ssh.Connect("ssh.example.com",port)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  Normally you would not hard-code the password in source.  You should instead obtain it
'  from an interactive prompt, environment variable, or a secrets vault.
password = "mySshPassword"

success = ssh.AuthenticatePw("mySshLogin",password)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  Start the shell session.  A negative return value indicates failure.
channelNum = ssh.QuickShell()
If (channelNum < 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  Build the commands, one per line.  Line endings matter: Unix/Linux servers typically expect
'  a bare LF, while Windows servers may require CRLF.
set sbCommands = CreateObject("Chilkat.StringBuilder")
success = sbCommands.Append("echo hello world" & vbLf)
success = sbCommands.Append("date" & vbLf)
success = sbCommands.Append("df" & vbLf)

'  The final command echoes a marker used to detect the end of the output.  The single quotes
'  around 'IS' are a trick: the terminal echo of the typed command includes the quotes, while
'  the command's actual output does not.  Matching the unquoted form therefore matches the real
'  output rather than the echo.
success = sbCommands.Append("echo THIS 'IS' THE END OF THE SCRIPT" & vbLf)

commands = sbCommands.GetAsString()
success = ssh.ChannelSendString(channelNum,commands,"utf-8")
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  IMPORTANT: Set a read timeout before receiving until a match.  ReadTimeoutMs defaults to 0,
'  which means no limit -- without it, this call waits forever if the received data never
'  contains a match.
ssh.ReadTimeoutMs = 15000

caseSensitive = 1
success = ssh.ChannelReceiveUntilMatch(channelNum,"THIS IS THE END OF THE SCRIPT","utf-8",caseSensitive)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  Indicate that no more commands will be sent, then close the channel.  Close only after the
'  desired output has been received.
success = ssh.ChannelSendEof(channelNum)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

success = ssh.ChannelSendClose(channelNum)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

'  Collect any remaining output.
success = ssh.ChannelReceiveToClose(channelNum)
If (success = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

sessionOutput = ssh.GetReceivedText(channelNum,"utf-8")
If (ssh.LastMethodSuccess = 0) Then
    outFile.WriteLine(ssh.LastErrorText)
    WScript.Quit
End If

outFile.WriteLine("--- output ----")
outFile.WriteLine(sessionOutput)

ssh.Disconnect 

outFile.Close