Set-VMHostNetwork

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.

Syntax

-Network  <VMHostNetworkInfo[]>
[-ConsoleGateway  <String>]
[-ConsoleGatewayDevice  <String>]
[-ConsoleV6Gateway  <String>]
[-ConsoleV6GatewayDevice  <String>]
[-DnsAddress  <String[]>]
[-DnsDhcpDevice  <Object>]
[-DnsFromDhcp  <Boolean>]
[-DomainName  <String>]
[-HostName  <String>]
[-IPv6Enabled  <Boolean>]
[-SearchDomain  <String[]>]
[-VMKernelGateway  <String>]
[-VMKernelGatewayDevice  <String>]
[-VMKernelV6Gateway  <String>]
[-VMKernelV6GatewayDevice  <String>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Network
VMHostNetworkInfo[] named
  • pipeline
  • Specifies the host network you want to configure.
    optional
    ConsoleGateway
    String named Specifies a new console gateway.
    optional
    ConsoleGatewayDevice
    String named Specifies a new console gateway device.
    optional
    ConsoleV6Gateway
    String named Specifies a console V6 gateway address. Not supported on ESXi.
    optional
    ConsoleV6GatewayDevice
    String named Specifies a console V6 gateway device. Not supported on ESXi.
    optional
    DnsAddress
    String[] named Specifies a new DNS address.
    optional
    DnsDhcpDevice
    Object named 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.
    optional
    DnsFromDhcp
    Boolean named Indicates that you want to obtain the network settings from a Dhcp server.
    optional
    DomainName
    String named Specifies a new domain name.
    optional
    HostName
    String named Specifies a new host name.
    optional
    IPv6Enabled
    Boolean named 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.
    optional
    SearchDomain
    String[] named Specifies a new search domain.
    optional
    VMKernelGateway
    String named Specifies a new kernel gateway.
    optional
    VMKernelGatewayDevice
    String named Specifies a new kernel gateway device.
    optional
    VMKernelV6Gateway
    String named Specifies a VMKernel V6 gateway address. This parameter is supported only on ESX hosts.
    optional
    VMKernelV6GatewayDevice
    String named Specifies a VMKernel V6 gateway device. This parameter is supported only on ESX hosts.

    Output

    VMware.VimAutomation.ViCore.Types.V1.Host.Networking.VMHostNetworkInfo

    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.

    Related Commands

    Feedback

    Was this page helpful?