Vagrant 1.6+ plugin extending WinRM communication features
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.bundle Clean the whole gem project to be github compliant Jul 10, 2014
lib
locales
spec
templates/winrm_config
.gitignore
.travis.yml
Gemfile Clean the whole gem project to be github compliant Jul 10, 2014
LICENSE New Vagrant 1.6+ plugin to extend WinRM features Jun 12, 2014
README.md
Rakefile
vagrant-winrm.gemspec

README.md

Vagrant-WinRM

This is a Vagrant 1.6+ plugin that adds new command to extends WinRM communication features.

NOTE: This plugin requires Vagrant 1.6+

Features

  • Execute remote command (even with elevated credentials)
  • Upload files
  • Retrieve WinRM configuration

Installation

Install using standard Vagrant plugin installation methods:

vagrant plugin install vagrant-winrm

Please read the Plugin usage page for more details.

Usage

winrm

This command allows you to execute arbitrary remote commands through WinRM.

vagrant winrm -c "pre-install.bat" -c "install.bat" -c "post-install.bat" Windows2008VM

The following command run the given command with local elevated credentials vagrant winrm -e -c "winrm get winrm/config Windows2008VM

winrm-upload

This command allows you to upload a file or a directory to your machine through WinRM.

vagrant winrm-upload "c:\mylocalFolder" "d:\" Windows2008VM

winrm-config

This command prints the current WinRM configuration of your machine.

$ vagrant winrm-config --host "CustomHostname" Windows2008VM
Host CustomHostname
  HostName Windows2008VM.vagrant.up
  Port 5985
  User vagrant
  Password vagrant
  RDPPort 3389

Development

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 the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Authors

Created and maintained by Baptiste Courtois (b.courtois@criteo.com)

License

Apache 2.0 (see LICENSE)