Метод EnableDNS класса Win32_NetworkAdapterConfiguration
Статический метод класса WMI EnableDNS включает систему доменных имен (DNS) для обслуживания.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 EnableDNS(
[in, optional] string DNSHostName,
[in, optional] string DNSDomain,
[in, optional] string DNSServerSearchOrder[],
[in, optional] string DNSDomainSuffixSearchOrder[]
);
Параметры
-
DNSHostName [in, необязательно]
-
Имя узла DNS, который включает этот метод.
Пример: corpdns
-
DNSDomain [in, необязательный]
-
Представляет название организации, за которой следует точка и расширение, указывающее тип организации.
Пример: "microsoft.com"
-
DNSServerSearchOrder [in, необязательно]
-
Список IP-адресов серверов для запроса DNS-серверов.
-
DNSDomainSuffixSearchOrder [in, необязательно]
-
Dns-суффикс домена, добавляемый к имени узла во время разрешения имен. При разрешении полного доменного имени (FQDN) из имени только узла система добавляет локальное доменное имя. Если разрешение имен не выполнено успешно, система использует список доменных суффиксов для создания дополнительных полных доменных имен в указанном порядке, а затем запрашивает DNS-серверы для каждого из них.
Возвращаемое значение
Возвращает значение 0 (ноль) для успешного завершения, если перезагрузка не требуется, 1 (один) для успешного завершения, когда требуется перезагрузка, и любое другое число, если возникает ошибка. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
Успешное завершение, перезагрузка не требуется
-
0
Успешное завершение, перезагрузка не требуется.
-
Успешное завершение, требуется перезагрузка
-
1
Успешное завершение, требуется перезагрузка.
-
Метод не поддерживается на этой платформе
-
64
Метод не поддерживается на этой платформе.
-
Неизвестный сбой
-
65
Неизвестный сбой.
-
Недопустимая маска подсети
-
66
Недопустимая маска подсети.
-
Ошибка при обработке возвращенного экземпляра
-
67
Ошибка при обработке возвращенного экземпляра.
-
Недопустимый входной параметр
-
68
Недопустимый входной параметр.
-
Указано более 5 шлюзов
-
69
Указано более пяти шлюзов.
-
Недопустимый IP-адрес
-
70
Недопустимый IP-адрес.
-
Недопустимый IP-адрес шлюза
-
71
Недопустимый IP-адрес шлюза.
-
Произошла ошибка при доступе к реестру для получения запрошенных сведений.
-
72
Произошла ошибка при доступе к реестру для запрашиваемых сведений.
-
Недопустимое доменное имя
-
73
Недопустимое доменное имя.
-
Недопустимое имя узла
-
74
Недопустимое имя узла.
-
Основной или вторичный сервер WINS не определен
-
75
Основной или вторичный сервер WINS не определен.
-
Недопустимый файл
-
76
Недопустимый файл.
-
Недопустимый системный путь
-
77
Недопустимый системный путь.
-
Сбой копирования файла
-
78
Сбой копирования файла.
-
Недопустимый параметр безопасности
-
79
Недопустимый параметр безопасности.
-
Не удалось настроить службу TCP/IP
-
80
Не удалось настроить службу TCP/IP.
-
Не удается настроить службу DHCP
-
81
Не удалось настроить службу DHCP.
-
Не удается продлить аренду DHCP
-
82
Не удается продлить аренду DHCP.
-
Не удалось освободить аренду DHCP
-
83
Не удается освободить аренду DHCP.
-
IP-адрес не включен на адаптере
-
84
IP-адрес не включен на адаптере.
-
IPX не включен на адаптере
-
85
IPX не включен на адаптере.
-
Ошибка границ кадра или сетевого номера
-
86
Ошибка границы кадра или сетевого номера.
-
Недопустимый тип кадра
-
87
Недопустимый тип кадра.
-
Недопустимый номер сети
-
88
Недопустимый номер сети.
-
Повторяющийся номер сети
-
89
Повторяющийся номер сети.
-
Параметр выходит за пределы границ
-
90
Параметр выходит за пределы.
-
Доступ запрещен
-
91
Доступ запрещен.
-
Недостаточно памяти
-
92
Недостаточно памяти.
-
Уже существует
-
93
Уже существует.
-
Путь, файл или объект не найден
-
94
Путь, файл или объект не найден.
-
Не удается уведомить службу
-
95
Не удается уведомить службу.
-
Не удается уведомить службу DNS
-
96
Не удается уведомить службу DNS.
-
Интерфейс не настраивается
-
97
Интерфейс не настраивается.
-
Не все аренды DHCP могут быть освобождены или продлены
-
98
Не все аренды DHCP можно освободить или продлить.
-
Dhcp не включен в адаптере
-
100
Протокол DHCP не включен для адаптера.
-
Другое
-
101 4294967295
Примеры
Следующий пример кода, взятый из примера кода Включить DNS для всех сетевых адаптеров VBScript в коллекции TechNet, включает DNS для всех сетевых адаптеров на компьютере.
On Error Resume Next
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNetworkSettings = objWMIService.Get("Win32_NetworkAdapterConfiguration")
strHostName = "fabrikam1"
arrDNSSuffixes = Array("hr.fabrikam.com", "research.fabrikam.com")
objNetworkSettings.EnableDNS strHostName, , , arrDNSSuffixes
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|