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.
Deprecation Notice
The functionality provided by this library has been merged into winrm and winrm-fs. Following the release of Test-Kitchen 1.6, this library will no longer be used and thus no longer be maintained.
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:
- Fork it ( https://github.com/test-kitchen/winrm-transport/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Authors
Created and maintained by Fletcher Nichol (fnichol@nichol.ca) and a growing community of contributors.
License
Apache License, Version 2.0 (see LICENSE.txt)