52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Configuration- Hyper-V Provider"
|
|
sidebar_current: "providers-hyperv-configuration"
|
|
description: |-
|
|
The Vagrant Hyper-V provider has some provider-specific configuration options
|
|
you may set.
|
|
---
|
|
|
|
# Configuration
|
|
|
|
The Vagrant Hyper-V provider has some provider-specific configuration options
|
|
you may set. A complete reference is shown below:
|
|
|
|
* `vmname` (string) - Name of virtual machine as shown in Hyper-V manager.
|
|
Defaults is taken from box image XML.
|
|
* `cpus` (integer) - Number of virtual CPU given to machine.
|
|
Defaults is taken from box image XML.
|
|
* `memory` (integer) - Number of MegaBytes allocated to VM at startup.
|
|
Defaults is taken from box image XML.
|
|
* `maxmemory` (integer) - Number of MegaBytes maximal allowed to allocate for VM
|
|
This parameter is switch on Dynamic Allocation of memory.
|
|
Defaults is taken from box image XML.
|
|
* `vlan_id` (integer) - Number of Vlan ID for your guest network interface
|
|
Defaults is not defined, vlan configuration will be untouched if not set.
|
|
* `mac` (string) - MAC address for your guest network interface
|
|
Default is not defined, MAC address will be dynamically assigned by Hyper-V if not set.
|
|
* `ip_address_timeout` (integer) - The time in seconds to wait for the
|
|
virtual machine to report an IP address. This defaults to 120 seconds.
|
|
This may have to be increased if your VM takes longer to boot.
|
|
* `differencing_disk` (boolean) - Switch to use differencing disk instead of cloning whole VHD.
|
|
* `enable_virtualization_extensions` (boolean) - Enable virtualization extensions for the virtual CPUs.
|
|
This allows Hyper-V to be nested and run inside another Hyper-VM VM. It requires Windows 10 - 1511 (build 10586) or newer.
|
|
Default is not defined. This will be disabled if not set.
|
|
* `auto_start_action` (Nothing, StartIfRunning, Start) - Action on automatic start of VM when booting OS
|
|
* `auto_stop_action` (ShutDown, TurnOff, Save) - Action on automatic stop of VM when shutting down OS.
|
|
* `vm_integration_services` (Hash) - Hash to set the state of integration services.
|
|
|
|
Example:
|
|
|
|
```ruby
|
|
config.vm.provider "hyperv" do |h|
|
|
h.vm_integration_services = {
|
|
guest_service_interface: true,
|
|
heartbeat: true,
|
|
key_value_pair_exchange: true,
|
|
shutdown: true,
|
|
time_synchronization: true,
|
|
vss: true
|
|
}
|
|
end
|
|
``` |