isabella232 / vagrant-winrm

Vagrant 1.6+ plugin extending WinRM communication features

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

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

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 ([email protected])

License

Apache 2.0 (see LICENSE)