<commit_before>packer-winrm-shell
==================

[![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)

WinRM Shell Provisioner for Packer<commit_msg>Added intro and sub-sections<commit_after># 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: <PASSWORD>. Defaults to '<PASSWORD>'
* Hostname: The WinRM hostname. Defaults to 'localhost'
* Port: The WinRM connection port. Defaults to '5985'

## Contributing
{'fraction_non_alphanumeric': 0.12883744338198289, 'fraction_numerical': 0.0020130850528434826, 'mean_word_length': 5.193146417445483, 'pattern_counts': {'":': 3, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 10, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 1, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5650957', 'n_tokens_mistral': 646, 'n_tokens_neox': 627, 'n_words': 171}