winrm

Documentation

Index

• func Http_post(client *Client, request *soap.SoapMessage) (response string, err error)
• func NewDeleteShellRequest(uri string, shellId string, params *Parameters) (message *soap.SoapMessage)
• func NewExecuteCommandRequest(uri string, shellId string, command string, params *Parameters) (message *soap.SoapMessage)
• func NewGetOutputRequest(uri string, shellId string, commandId string, streams string, ...) (message *soap.SoapMessage)
• func NewOpenShellRequest(uri string, params *Parameters) (message *soap.SoapMessage)
• func NewSendInputRequest(uri string, shellId string, commandId string, input []byte, params *Parameters) (message *soap.SoapMessage)
• func NewSignalRequest(uri string, shellId string, commandId string, params *Parameters) (message *soap.SoapMessage)
• func ParseExecuteCommandResponse(response string) (commandId string, err error)
• func ParseOpenShellResponse(response string) (shellId string, err error)
• func ParseSlurpOutputErrResponse(response string, stdout io.Writer, stderr io.Writer) (finished bool, exitCode int, err error)
• func ParseSlurpOutputResponse(response string, stream io.Writer, streamType string) (finished bool, exitCode int, err error)
• type Client
  • func NewClient(hostname string, user string, password string) (client *Client)
  • func NewClientWithParameters(hostname string, user string, password string, params *Parameters) (client *Client)
  • func (client *Client) CreateShell() (shell *Shell, err error)
  • func (client *Client) Run(command string, stdout io.Writer, stderr io.Writer) (err error)
  • func (client *Client) RunWithInput(command string, stdout io.Writer, stderr io.Writer, stdin io.Reader) (err error)
  • func (client *Client) RunWithString(command string, stdin string) (stdout string, stderr string, err error)
• type Command
  • func (command *Command) Close() (err error)
  • func (command *Command) ExitCode() int
  • func (command *Command) Wait()
• type HttpPost
• type Parameters
  • func DefaultParameters() *Parameters
  • func NewParameters(timeout string, locale string, envelopeSize int) *Parameters
• type Shell
  • func (shell *Shell) Close() (err error)
  • func (shell *Shell) Execute(command string) (cmd *Command, err error)

Functions

func Http_post

func Http_post(client *Client, request *soap.SoapMessage) (response string, err error)

func NewDeleteShellRequest

func NewDeleteShellRequest(uri string, shellId string, params *Parameters) (message *soap.SoapMessage)

func NewExecuteCommandRequest

func NewExecuteCommandRequest(uri string, shellId string, command string, params *Parameters) (message *soap.SoapMessage)

func NewGetOutputRequest

func NewGetOutputRequest(uri string, shellId string, commandId string, streams string, params *Parameters) (message *soap.SoapMessage)

func NewOpenShellRequest

func NewOpenShellRequest(uri string, params *Parameters) (message *soap.SoapMessage)

func NewSendInputRequest

func NewSendInputRequest(uri string, shellId string, commandId string, input []byte, params *Parameters) (message *soap.SoapMessage)

func NewSignalRequest

func NewSignalRequest(uri string, shellId string, commandId string, params *Parameters) (message *soap.SoapMessage)

func ParseExecuteCommandResponse

func ParseExecuteCommandResponse(response string) (commandId string, err error)

func ParseOpenShellResponse

func ParseOpenShellResponse(response string) (shellId string, err error)

func ParseSlurpOutputErrResponse

func ParseSlurpOutputErrResponse(response string, stdout io.Writer, stderr io.Writer) (finished bool, exitCode int, err error)

func ParseSlurpOutputResponse

func ParseSlurpOutputResponse(response string, stream io.Writer, streamType string) (finished bool, exitCode int, err error)

Types

type Client

type Client struct {
	Parameters
	// contains filtered or unexported fields
}

func NewClient

func NewClient(hostname string, user string, password string) (client *Client)

NewClient will create a new remote client on url, connecting with user and password This function doesn't connect (connection happens only when CreateShell is called)

func NewClientWithParameters

func NewClientWithParameters(hostname string, user string, password string, params *Parameters) (client *Client)

NewClient will create a new remote client on url, connecting with user and password This function doesn't connect (connection happens only when CreateShell is called)

func (*Client) CreateShell

func (client *Client) CreateShell() (shell *Shell, err error)

CreateShell will create a WinRM Shell, which is the prealable for running commands.

func (*Client) Run

func (client *Client) Run(command string, stdout io.Writer, stderr io.Writer) (err error)

Run will run command on the the remote host, writing the process stdout and stderr to the given writers. Note with this method it isn't possible to inject stdin.

func (*Client) RunWithInput

func (client *Client) RunWithInput(command string, stdout io.Writer, stderr io.Writer, stdin io.Reader) (err error)

Run will run command on the the remote host, writing the process stdout and stderr to the given writers, and injecting the process stdin with the stdin reader. Warning stdin (not stdout/stderr) are bufferized, which means reading only one byte in stdin will send a winrm http packet to the remote host. If stdin is a pipe, it might be better for performance reasons to buffer it.

func (*Client) RunWithString

func (client *Client) RunWithString(command string, stdin string) (stdout string, stderr string, err error)

Run will run command on the the remote host, returning the process stdout and stderr as strings, and using the input stdin string as the process input

type Command

type Command struct {
	Stdin  *commandWriter
	Stdout *commandReader
	Stderr *commandReader
	// contains filtered or unexported fields
}

Command represents a given command running on a Shell. This structure allows to get access to the various stdout, stderr and stdin pipes.

func (*Command) Close

func (command *Command) Close() (err error)

Close will terminate the running command

func (*Command) ExitCode

func (command *Command) ExitCode() int

ExitCode returns command exit code when it is finished. Before that the result is always 0.

func (*Command) Wait

func (command *Command) Wait()

Calling this function will block the current goroutine until the remote command terminates.

type HttpPost

type HttpPost func(*Client, *soap.SoapMessage) (string, error)

type Parameters

type Parameters struct {
	Timeout      string
	Locale       string
	EnvelopeSize int
	// contains filtered or unexported fields
}

func DefaultParameters

func DefaultParameters() *Parameters

func NewParameters

func NewParameters(timeout string, locale string, envelopeSize int) *Parameters

type Shell

type Shell struct {
	ShellId string
	// contains filtered or unexported fields
}

Shell is the local view of a WinRM Shell of a given Client

func (*Shell) Close

func (shell *Shell) Close() (err error)

Close will terminate this shell. No commands can be issued once the shell is closed.

func (*Shell) Execute

func (shell *Shell) Execute(command string) (cmd *Command, err error)

Execute command on the given Shell, returning either an error or a Command