Syntax
Set-VMHostNetwork [-Network] <VMHostNetworkInfo[]> [-ConsoleGateway <String>] [-VMKernelGateway <String>] [-VMKernelGatewayDevice <String>] [-ConsoleGatewayDevice <String>] [-DomainName <String>] [-HostName <String>] [-DnsFromDhcp <Boolean>] [-DnsDhcpDevice <Object>] [-DnsAddress <String[]>] [-SearchDomain <String[]>] [-IPv6Enabled <Boolean>] [-ConsoleV6Gateway <String>] [-ConsoleV6GatewayDevice <String>] [-VMKernelV6Gateway <String>] [-VMKernelV6GatewayDevice <String>] [-WhatIf] [-Confirm] [<CommonParameters>]Related Commands
Online versionDetailed Description
This cmdlet updates the specified virtual network. The service console and the VMkernel are often not connected to the same network, and therefore each needs its own gateway information. A gateway is needed for connectivity to machines not on the same IP subnet as the service console or VMkernel.Parameters
| Name | Type | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|---|
| Network | VMHostNetworkInfo[] | Specifies the host network you want to configure. | true | true (ByValue) | |
| Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | false | |
| ConsoleGateway | String | Specifies a new console gateway. | false | false | |
| ConsoleGatewayDevice | String | Specifies a new console gateway device. | false | false | |
| ConsoleV6Gateway | String | Specifies a console V6 gateway address. Not supported on ESXi. | false | false | |
| ConsoleV6GatewayDevice | String | Specifies a console V6 gateway device. Not supported on ESXi. | false | false | |
| DnsAddress | String[] | Specifies a new DNS address. | false | false | |
| DnsDhcpDevice | Object | This parameter is mandatory if the value of the DnsFromDhcp parameter is 'true'. Otherwise, it is disregarded. If the DnsDhcpDevice parameter is set, the Dhcp DNS of the service console or VMKernel network adapter will override the system DNS. The parameter takes a ServiceConsoleNIC object, a VMKernelNIC object in case of an ESX visor, or the NIC name as a string. | false | false | |
| DnsFromDhcp | Boolean | Indicates that you want to obtain the network settings from a Dhcp server. | false | false | |
| DomainName | String | Specifies a new domain name. | false | false | |
| HostName | String | Specifies a new host name. | false | false | |
| IPv6Enabled | Boolean | Indicates that IPv6 configuration is enabled. Setting this parameter to $false disables the ConsoleV6Gateway, ConsoleV6GatewayDevice, and VMKernelV6Gateway parameters. IPv6 is supported only on vCenter 4.1 and ESX 4.1 or later. To use IPv6 on ESX, you must restart the host after enabling IPv6. | false | false | |
| SearchDomain | String[] | Specifies a new search domain. | false | false | |
| VMKernelGateway | String | Specifies a new kernel gateway. | false | false | |
| VMKernelGatewayDevice | String | Specifies a new kernel gateway device. | false | false | |
| VMKernelV6Gateway | String | Specifies a VMKernel V6 gateway address. This parameter is supported only on ESX hosts. | false | false | |
| VMKernelV6GatewayDevice | String | Specifies a VMKernel V6 gateway device. This parameter is supported only on ESX hosts. | false | false | |
| WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | false |
Return Type
Zero or more modified VMHostNetworkInfo objectsNotes
If "DnsFromDhcp" is enabled ?DomainName? and ?HostName? cannot be explicitly set. To configure IPv6 settings, you must be working on ESX 4.1 or later, and IPv6 must be enabled on the host system. The new IPv6 settings take effect after the host is restarted.Examples
-------------- Example 1 --------------
$vmHostNetworkInfo = Get-VmHostNetwork -Host Host Set-VmHostNetwork -Network $vmHostNetworkInfo -VMKernelGateway 10.23.11.11 -DomainName eng.vmware.com -HostName Host1 -DnsFromDhcp $false
Gets the network configuration of the virtual machine host named Host. Sets the virtual machine kernel gateway, the domain name, the host name, and the Dhcp of the network.
-------------- Example 2 --------------
Get-VMHost Host | Get-VMHostNetwork | Set-VMHostNetwork -IPv6Enabled $true Get-VMHost Host | Restart-VMHost -Force -Confirm:$false
Enables IPv6 support on the Host host and restarts the host.
-------------- Example 3 --------------
Get-VMHost Host | Get-VMHostNetwork | Set-VMHostNetwork -ConsoleV6Gateway $ipv6GatewayAddress -ConsoleV6GatewayDevice "vswif0"
Configures the IPv6 console default gateway on the Host host.
-------------- Example 4 --------------
Get-VMHost Host | Get-VMHostNetwork | Set-VMHostNetwork -VMKernelV6Gateway $ipv6GatewayAddress
Configures the IPv6 VMKernel default gateway on the Host host.