# Data Object - HostDnsConfig(vim.host.DnsConfig)

Property of
  HostNetStackInstance, HostNetworkConfig, HostNetworkInfo, HostNetworkSystem
Parameter to
  UpdateDnsConfig
Extended by
  HostDnsConfigSpec
Extends
  DynamicData
Since
  2.0

## Data Object Description

This data object type describes the DNS configuration.

All IPv4 addresses, subnet addresses, and netmasks are specified using dotted decimal notation. For example, "192.0.2.1". IPv6 addresses are 128-bit addresses represented as eight fields of up to four hexadecimal digits. A colon separates each field (:). For example, 2001:DB8:101::230:6eff:fe04:d9ff. The address can also consist of the symbol '::' to represent multiple 16-bit groups of contiguous 0's only once in an address as described in RFC 2373.

Properties

Name | Type | Description
--- | --- | ---
address* | xsd:string[] | The IP addresses of the DNS servers, placed in order of preference. Note: When DHCP is not enabled, the property can be set explicitly. When DHCP is enabled, the property reflects the current DNS configuration, but cannot be set.
dhcp | xsd:boolean | The flag to indicate whether or not DHCP (dynamic host control protocol) is used to determine DNS configuration automatically.
domainName | xsd:string | The domain name portion of the DNS name. For example, "vmware.com". Note: When DHCP is not enabled, the property can be set explicitly. When DHCP is enabled, the property reflects the current DNS configuration, but cannot be set.
hostName | xsd:string | The host name portion of DNS name. For example, "esx01". Note: When DHCP is not enabled, the property can be set explicitly. When DHCP is enabled, the property reflects the current DNS configuration, but cannot be set. The hostName can't have character '.' in it when set explicitly.
ipv6VirtualNicDevice* | xsd:string | If DHCP is enabled, the IPv6 DHCP DNS of the vmkernel nic will override the system's IPv6 DNS. This field is ignored if DHCP is disabled by the dhcp property. Since vSphere API 6.7
searchDomain* | xsd:string[] | The domain in which to search for hosts, placed in order of preference. Note: When DHCP is not enabled, the property can be set explicitly. When DHCP is enabled, the property reflects the current DNS configuration, but cannot be set.
virtualNicDevice* | xsd:string | If DHCP is enabled, the DHCP DNS of the vmkernel nic will override the system's DNS. This field applies to both IPv4 and IPv6 DNS settings if ipv6VirtualNicDevice is unset, otherwise it is applicable only for IPv4 setting. This field is ignored if DHCP is disabled by the dhcp property.
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vsan="urn:vsan" name="HostDnsConfig"> <complexContent> <extension base="vsan:DynamicData"> <sequence> <element name="dhcp" type="xsd:boolean"/> <element name="virtualNicDevice" type="xsd:string" minOccurs="0"/> <element name="ipv6VirtualNicDevice" type="xsd:string" minOccurs="0"/> <element name="hostName" type="xsd:string"/> <element name="domainName" type="xsd:string"/> <element name="address" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/> <element name="searchDomain" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType>