winrm-transport

WinRM::Transport

WinRM transport logic for re-using remote shells and uploading files. The original code was extracted from the Test Kitchen project and remains the primary reference use case.

Installation

Add this line to your application's Gemfile:

gem 'winrm-transport'

And then execute:

$ bundle

Or install it yourself as:

$ gem install winrm-transport

Usage

This is a library gem and doesn't have any CLI commands. There are 2 primary object classes:

• WinRM::Transport::CommandExecutor: an object which can execute multiple commands and PowerShell script in one shared remote shell session.
• WinRM::Transport::FileTransporter: an object which can upload one or more files or directories to a remote host over WinRM only using PowerShell scripts and CMD commands.

Versioning

WinRM::Transport aims to adhere to Semantic Versioning 2.0.0.

Development

• Source hosted at GitHub
• Report issues/questions/feature requests on GitHub Issues

After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

1. Fork it ( https://github.com/test-kitchen/winrm-transport/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Authors

Created and maintained by Fletcher Nichol ([e-mail]) and a growing community of contributors.

License

Apache License, Version 2.0 (see LICENSE.txt)