Represents a set of global DNS client settings.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.
Syntax
class MSFT_DNSClientGlobalSetting : CIM_DNSGeneralSettingData
{
string Caption;
string Description;
string InstanceId;
string ElementName;
uint16 ProtocolIFType;
uint16 AddressOrigin;
boolean AppendPrimarySuffixes;
boolean AppendParentSuffixes;
string DNSSuffixesToAppend[];
boolean UseSuffixSearchList;
boolean UseDevolution;
string SuffixSearchList[];
uint32 DevolutionLevel;
};
Members
The MSFT_DNSClientGlobalSetting class has these types of members:
Properties
The MSFT_DNSClientGlobalSetting class has these properties.
AddressOrigin
Data type: uint16
Access type: Read-only
Qualifiers: Override (AddressOrigin)
Gets a value that specifies the structure of the IP endpoint address for DNS clients.
This property is inherited from CIM_DNSGeneralSettingData.
This property can contain one of the following values. The default value is "2" (not applicable).
| Value | Meaning |
|---|---|
| 0 1 | DMTF Reserved |
| 2 | Not Applicable |
| 3 32767 | DMTF Reserved |
| 32768 ... | Vendor Reserved |
AppendParentSuffixes
Data type: boolean
Access type: Read/write
Qualifiers: ModelCorrespondence (CIM_DNSProtocolEndpoint.AppendParentSuffixes)
Gets and sets a value that indicates whether DNS clients should append the parent domain suffix to a target name before the name is resolved.
This property is inherited from CIM_DNSGeneralSettingData.
AppendPrimarySuffixes
Data type: boolean
Access type: Read/write
Qualifiers: ModelCorrespondence (CIM_DNSProtocolEndpoint.AppendPrimarySuffixes)
Gets and sets a value that indicates whether DNS clients should append the primary domain suffix to a target name before the name is resolved.
This property is inherited from CIM_DNSGeneralSettingData.
Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64), Dynamic
Gets the short description of the client settings.
This property is inherited from CIM_ManagedElement.
Description
Data type: string
Access type: Read-only
Qualifiers: Override (Description)
Gets a description of the client settings.
This property is inherited from the CIM_ManagedElement class.
DevolutionLevel
Data type: uint32
Access type: Read/write
Gets and sets the devolution level to use when DNS devolution is enabled.
DNSSuffixesToAppend
Data type: string array
Access type: Read/write
Qualifiers: ModelCorrespondence (CIM_DNSProtocolEndpoint.DNSSuffixesToAppend)
Gets and sets an array that contains the DNS suffixes to append when a host name is resolved.
This property is inherited from CIM_DNSGeneralSettingData.
ElementName
Data type: string
Access type: Read-only
Gets the user-friendly name of the client settings.
This property is inherited from CIM_SettingData.
InstanceId
Data type: string
Access type: Read-only
Gets the unique identifier of this object. The ID must be unique within the scope of the instantiating namespace.
This property is inherited from CIM_SettingData.
ProtocolIFType
Data type: uint16
Access type: Read-only
Qualifiers: ModelCorrespondence (CIM_ProtocolEndpoint.ProtocolIFType)
Gets the IP version for DNS clients.
This property is inherited from CIM_IPAssignmentSettingData.
| Value | Meaning |
|---|---|
| 0 | Unknown |
| 1 4095 | DMTF Reserved |
| 4096 | IPv4 |
| 4097 | IPv6 |
| 32768 ... | Vendor Reserved |
SuffixSearchList
Data type: string array
Access type: Read/write
Gets and sets an array that contains a global suffix search list.
UseDevolution
Data type: boolean
Access type: Read/write
Gets and sets a value that indicates whether DNS clients use DNS devolution when the AppendParentSuffixes property is set to true.
UseSuffixSearchList
Data type: boolean
Access type: Read/write
Gets and sets a value that indicates whether DNS clients use the global suffix search list when the AppendPrimarySuffixes property is set to true.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 |
| Minimum supported server | Windows Server 2012 |
| Namespace | Root\StandardCimv2 |
| MOF | DnsClientCim.mof |
| DLL | DnsClientCim.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors (upstream author metadata: windowssdkdev). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
