website: doc windows-restart

website/source/docs/provisioners/windows-restart.html.md

@@ -0,0 +1,43 @@
+---
+layout: "docs"
+page_title: "Windows Restart Provisioner"
+description: |-
+  The Windows restart provisioner restarts a Windows machine and waits for it to come back up.
+---
+
+# Windows Restart Provisioner
+
+Type: `windows-restart`
+
+The Windows restart provisioner initiates a reboot on a Windows machine
+and waits for the machine to come back online.
+
+The Windows provisioning process often requires multiple reboots, and this
+provisioner helps to ease that process.
+
+## Basic Example
+
+The example below is fully functional.
+
+```javascript
+{
+  "type": "windows-restart"
+}
+```
+
+## Configuration Reference
+
+The reference of available configuration options is listed below.
+
+Optional parameters:
+
+* `restart_command` (string) - The command to execute to initiate the
+  restart. By default this is `shutdown /r /c "packer restart" /t 5 && net stop winrm`.
+  A key action of this is to stop WinRM so that Packer can detect it
+  is rebooting.
+
+* `restart_check_command` (string) - A command to execute to check if the
+  restart succeeded. This will be done in a loop.
+
+* `restart_timeout` (string) - The timeout to wait for the restart.
+  By default this is 5 minutes. Example value: "5m"

website/source/layouts/docs.erb

@@ -56,6 +56,7 @@
 			<li><a href="/docs/provisioners/puppet-masterless.html">Puppet Masterless</a></li>
 			<li><a href="/docs/provisioners/puppet-server.html">Puppet Server</a></li>
 			<li><a href="/docs/provisioners/salt-masterless.html">Salt</a></li>
+			<li><a href="/docs/provisioners/windows-restart.html">Windows Restart</a></li>
 			<li><a href="/docs/provisioners/custom.html">Custom</a></li>
 		</ul>