https://github.com/mefellows/packer-winrm-shell

WinRM Shell Provisioner for Packer
https://github.com/mefellows/packer-winrm-shell

Last synced: 14 days ago
JSON representation

WinRM Shell Provisioner for Packer

• Host: GitHub
• URL: https://github.com/mefellows/packer-winrm-shell
• Owner: mefellows
• License: mit
• Created: 2014-11-16T01:10:48.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2014-11-29T11:32:30.000Z (about 10 years ago)
• Last Synced: 2024-11-06T16:25:08.573Z (2 months ago)
• Language: Go
• Size: 2.47 MB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Packer WinRM Shell Provisioner

[![Build Status](https://travis-ci.org/mefellows/packer-winrm-shell.svg?branch=master)](https://travis-ci.org/mefellows/packer-winrm-shell)

[![Coverage Status](https://coveralls.io/repos/mefellows/packer-winrm-shell/badge.png)](https://coveralls.io/r/mefellows/packer-winrm-shell)

The [WinRM]() Shell Provisioner for Packer allows you to provision a Windows Guest 

via shell commands or scripts that are executed via WinRM instead of the default SSH

behaviour.

WinRM is a native Windows remote management capability that can provide a more reliable

experience interacting with a remote Windows machine.

## Installation

Download the binary for your platform and place on your execution `$PATH` environment variable, 

or alongside the Packer.io installation.

### Manual Installation

TBA

## Usage

The WinRM shell is very similar to the default Packer [Shell](https://www.packer.io/docs/provisioners/shell.html) 

provisioner, the main difference being the name of the provisioner is changed to `winrm-shell`:

```

"provisioners": [

   {

     "type": "winrm-shell",

     "inline": ["whoami"]

   }

]

```

### Configuration Options

Aside from the default parameters from the [Shell](https://www.packer.io/docs/provisioners/shell.html) Provisioner, you can use Modified the below:

*Authentication*

* Username: The WinRM username. Defaults to 'vagrant'

* Password: The WinRM password. Defaults to 'vagrant'

* Hostname: The WinRM hostname. Defaults to 'localhost'

* Port: The WinRM connection port. Defaults to '5985'

## Contributing