github.com/yoctocloud/packer@v0.6.2-0.20160520224004-e11a0a18423f/website/source/docs/provisioners/windows-restart.html.md (about)

     1  ---
     2  description: |
     3      The Windows restart provisioner restarts a Windows machine and waits for it
     4      to come back up.
     5  layout: docs
     6  page_title: Windows Restart Provisioner
     7  ...
     8  
     9  # Windows Restart Provisioner
    10  
    11  Type: `windows-restart`
    12  
    13  The Windows restart provisioner initiates a reboot on a Windows machine and
    14  waits for the machine to come back online.
    15  
    16  The Windows provisioning process often requires multiple reboots, and this
    17  provisioner helps to ease that process.
    18  
    19  Packer expects the machine to be ready to continue provisioning after it
    20  reboots. Packer detects that the reboot has completed by making an RPC call
    21  through the Windows Remote Management (WinRM) service, not by ACPI functions, so Windows must be completely booted in order to continue.
    22  
    23  ## Basic Example
    24  
    25  The example below is fully functional.
    26  
    27  ``` {.javascript}
    28  {
    29    "type": "windows-restart"
    30  }
    31  ```
    32  
    33  ## Configuration Reference
    34  
    35  The reference of available configuration options is listed below.
    36  
    37  Optional parameters:
    38  
    39  -   `restart_command` (string) - The command to execute to initiate the
    40      restart. By default this is `shutdown /r /c "packer restart" /t 5 && net
    41      stop winrm`. A key action of this is to stop WinRM so that Packer can
    42      detect it is rebooting.
    43  
    44  -   `restart_check_command` (string) - A command to execute to check if the
    45      restart succeeded. This will be done in a loop.
    46  
    47  -   `restart_timeout` (string) - The timeout to wait for the restart. By
    48      default this is 5 minutes. Example value: `5m`. If you are installing
    49      updates or have a lot of startup services, you will probably need to
    50      increase this duration.