5093f3120e
This is a big commit, and I apologize in advance for the future
git-blames all pointing to me. This commit does a few things:
1. Merges the website/docs and website/www repo into a single website repo
to be in line with other HashiCorp projects
2. Updates to use middleman-hashicorp
3. Converts less to scss to be in line with other projects
4. Updates page styles to be in line with other projects
5. Optimizes images
6. Prepare for S3 + Fastly deployment with scripts, etc.
7. Removes blog posts (they have been transferred to hashicorp.com with
redirects in place
8. Updated sitemap generation script for better SEO
9. Fixed many broken links
10. Add description to all fields
72 lines
2.6 KiB
Markdown
72 lines
2.6 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "config.winrm - Vagrantfile"
|
|
sidebar_current: "vagrantfile-winrm"
|
|
description: |-
|
|
The settings within "config.winrm" relate to configuring how Vagrant
|
|
will access your Windows guest over WinRM. As with most Vagrant settings, the
|
|
defaults are typically fine, but you can fine tune whatever you would like.
|
|
---
|
|
|
|
# WinRM Settings
|
|
|
|
**Config namespace: `config.winrm`**
|
|
|
|
The settings within `config.winrm` relate to configuring how Vagrant
|
|
will access your Windows guest over WinRM. As with most Vagrant settings, the
|
|
defaults are typically fine, but you can fine tune whatever you would like.
|
|
|
|
These settings are only used if you've set your communicator type to `:winrm`.
|
|
|
|
## Available Settings
|
|
|
|
`config.winrm.username` - This sets the username that Vagrant will use
|
|
to login to the WinRM web service by default. Providers are free to override
|
|
this if they detect a more appropriate user. By default this is "vagrant,"
|
|
since that is what most public boxes are made as.
|
|
|
|
<hr>
|
|
|
|
`config.winrm.password` - This sets a password that Vagrant will use to
|
|
authenticate the WinRM user. By default this is "vagrant," since that is
|
|
what most public boxes are made as.
|
|
|
|
<hr>
|
|
|
|
`config.winrm.host` - The hostname or IP to connect to the WinRM service.
|
|
By default this is empty, because the provider usually figures this out for
|
|
you.
|
|
|
|
<hr>
|
|
|
|
`config.winrm.port` - The WinRM port to connect to, by default 5985.
|
|
|
|
<hr>
|
|
|
|
`config.winrm.guest_port` - The port on the guest that WinRM is running on.
|
|
This is used by some providers to detect forwarded ports for WinRM. For
|
|
example, if this is set to 5985 (the default), and Vagrant detects a forwarded
|
|
port to port 5985 on the guest from port 4567 on the host, Vagrant will attempt
|
|
to use port 4567 to talk to the guest if there is no other option.
|
|
|
|
<hr>
|
|
|
|
`config.winrm.execution_time_limit` - The maximum duration that a WinRM
|
|
task can execute for. This defaults to two hours. The format of this value
|
|
must be in this [Microsoft-documented format](https://msdn.microsoft.com/en-us/library/aa382678.aspx).
|
|
|
|
<hr>
|
|
|
|
<strong>Warning:</strong> In order for Vagrant to communicate with a Windows
|
|
guest, you must allow unencrypted WinRM connections on the guest machine
|
|
itself. Some public boxes already have this configured, but if you are
|
|
attempting to `vagrant up` a Windows box and the command hangs at
|
|
`Waiting for WinRM to become available...`, then you will need to run the
|
|
commands below on the guest machine itself, at the box setup stage,
|
|
after provisioning, or through a start up script.
|
|
|
|
```
|
|
Set-Item WSMan:\localhost\Service\AllowUnencrypted -Value True
|
|
Set-Item WSMan:\localhost\Service\Auth\Basic -Value True
|
|
```
|