{"record":{"id":"48a13a90c1ceaa29","repo":"hashicorp/vagrant","slug":"configuring-secondary-network-adapters-through-vmw","errorCode":null,"errorMessage":"Configuring secondary network adapters through VMware on Windows is not yet supported. You will need to manually configure the network adapter.","messagePattern":"Configuring secondary network adapters through VMware on Windows is not yet supported\\. You will need to manually configure the network adapter\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"plugins/guests/windows/cap/configure_networks.rb","lineNumber":19,"sourceCode":"# Copyright IBM Corp. 2010, 2025\n# SPDX-License-Identifier: BUSL-1.1\n\nrequire \"log4r\"\n\nrequire_relative \"../guest_network\"\n\nmodule VagrantPlugins\n  module GuestWindows\n    module Cap\n      module ConfigureNetworks\n        @@logger = Log4r::Logger.new(\"vagrant::guest::windows::configure_networks\")\n\n        def self.configure_networks(machine, networks)\n          @@logger.debug(\"Networks: #{networks.inspect}\")\n\n          guest_network = GuestNetwork.new(machine.communicate)\n          if machine.provider_name.to_s.start_with?(\"vmware\")\n            machine.ui.warn(\"Configuring secondary network adapters through VMware \")\n            machine.ui.warn(\"on Windows is not yet supported. You will need to manually\")\n            machine.ui.warn(\"configure the network adapter.\")\n          else\n            vm_interface_map = create_vm_interface_map(machine, guest_network)\n            networks.each do |network|\n              interface = vm_interface_map[network[:interface]+1]\n              if interface.nil?\n                @@logger.warn(\"Could not find interface for network #{network.inspect}\")\n                next\n              end\n\n              network_type = network[:type].to_sym\n              if network_type == :static\n                guest_network.configure_static_interface(\n                  interface[:index],\n                  interface[:net_connection_id],\n                  network[:ip],\n                  network[:netmask])","sourceCodeStart":1,"sourceCodeEnd":37,"githubUrl":"https://github.com/hashicorp/vagrant/blob/35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5/plugins/guests/windows/cap/configure_networks.rb#L1-L37","documentation":"The Windows guest capability for configuring networks does not support secondary network adapters when the provider name starts with \"vmware\" (vmware_desktop, vmware_fusion, vmware_workstation). It prints a three-line warning and leaves the extra adapters unconfigured, so the guest must be configured manually.","triggerScenarios":"A Windows guest on a VMware provider with any network definition beyond the primary NIC (config.vm.network :private_network or :public_network) during the configure-networks step of vagrant up or vagrant reload; machine.provider_name.to_s.start_with?(\"vmware\") selects the warning branch.","commonSituations":"Porting a VirtualBox or Hyper-V Windows Vagrantfile to the commercial VMware plugin; multi-NIC topologies (management + data networks) on Windows guests.","solutions":["Configure the adapter manually inside the guest (ncpa.cpl, or `netsh interface ip set address`)","Remove the extra config.vm.network entries for Windows-on-VMWare boxes so only the primary adapter is used","Run the Windows box under a provider whose guest network configuration is supported (VirtualBox, Hyper-V)"],"exampleFix":"# before\nconfig.vm.network \"private_network\", ip: \"192.168.50.5\"  # warns on vmware + windows guest\n# after\n# (extra NIC removed from Vagrantfile; set inside the guest instead)\n# netsh interface ip set address \"Ethernet 2\" static 192.168.50.5 255.255.255.0","handlingStrategy":"validation","validationCode":"# Plugin/tooling guard: skip secondary NIC config on vmware + windows\nreturn if machine.provider_name.to_s.start_with?(\"vmware\") && machine.config.vm.guest.to_s == \"windows\"","typeGuard":"def secondary_nics_supported?(machine)\n  !(machine.provider_name.to_s.start_with?(\"vmware\") && machine.guest.name.to_s == \"windows\")\nend","tryCatchPattern":null,"preventionTips":["Keep Windows boxes to a single NIC under VMware providers","Automate the manual adapter config via a shell provisioner running netsh","Test multi-NIC Windows topologies on VirtualBox/Hyper-V instead"],"tags":["vagrant","vmware","windows-guest","network","unsupported-feature"],"backgroundTag":"unsupported-provider-feature","analyzedSha":"35f3160f4ad6edc3a9f3aa9570adfc1a4d73aaa5","analyzedAt":"2026-08-21T13:34:32.514Z","schemaVersion":2},"datasetVersion":"2026-08-21T18:17:14.833Z"}