Метод SetDNSServerSearchOrder класса Win32_NetworkAdapterConfiguration

Статья
06/12/2023

Метод класса WMISetDNSServerSearchOrder использует массив строковых элементов для задания порядка поиска сервера.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 SetDNSServerSearchOrder(
  [in] string DNSServerSearchOrder[]
);

Параметры

DNSServerSearchOrder [in]

Список IP-адресов сервера для запроса DNS-серверов.

Пример: 130.215.24.1 или 157.54.164.1

Возвращаемое значение

Возвращает значение 0 (ноль) для успешного завершения, если перезагрузка не требуется, 1 (одно) для успешного завершения, когда требуется перезагрузка, и другое число при возникновении ошибки. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешное завершение, перезагрузка не требуется (0)
Успешное завершение, требуется перезагрузка (1)
Метод не поддерживается на этой платформе (64)
Неизвестный сбой (65)
Недопустимая маска подсети (66)
Ошибка при обработке возвращенного экземпляра (67)
Недопустимый входной параметр (68)
Указано более 5 шлюзов (69)
Недопустимый IP-адрес (70)
Недопустимый IP-адрес шлюза (71)
Произошла ошибка при доступе к реестру для получения запрошенных сведений (72)
Недопустимое доменное имя (73)
Недопустимое имя узла (74)
Основной или вторичный сервер WINS не определен (75)
Недопустимый файл (76)
Недопустимый системный путь (77)
Сбой копирования файла (78)
Недопустимый параметр безопасности (79)
Не удалось настроить службу TCP/IP (80)
Не удалось настроить службу DHCP (81)
Не удалось продлить аренду DHCP (82)
Не удалось освободить аренду DHCP (83)
IP-адрес не включен в адаптере (84)
IpX не включен для адаптера (85)
Ошибка границ фрейма/сетевого номера (86)
Недопустимый тип кадра (87)
Недопустимый номер сети (88)
Повторяющийся номер сети (89)
Параметр выходит за пределы (90)
Доступ запрещен (91)
Нехватка памяти (92)
Уже существует (93)
Путь, файл или объект не найден (94)
Не удалось уведомить службу (95)
Не удалось уведомить службу DNS (96)
Интерфейс не настраивается (97)
Не все аренды DHCP могут быть освобождены или продлены (98)
Dhcp не включен для адаптера (100)
Другое (101 4294967295)

Это вызов метода, зависящий от экземпляра, который применяется для каждого адаптера. После того как статические DNS-серверы будут указаны для начала использования протокола DHCP вместо статических DNS-серверов, можно вызвать метод без указания параметров in.

Примеры

Пример Задания порядка поиска DNS-сервера для нескольких компьютеров в VBScript подразделения в коллекции TechNet извлекает или задает порядок поиска DNS-сервера для нескольких компьютеров, принадлежащих одному подразделению.

Пример Изменения порядка поиска DNS-сервера для сетевого адаптера VBScript позволяет настроить сетевой адаптер, связанный с TCP/IP, для использования двух DNS-серверов.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

Классы оборудования компьютерной системы
Win32_NetworkAdapterConfiguration
Задачи WMI: сеть
Задачи WMI: учетные записи и домены
Поддержка IPv6 и IPv4 в WMI

Share via