Метод SetGateways класса Win32_NetworkAdapterConfiguration
Метод класса WMISetGateways задает список шлюзов для маршрутизации пакетов в подсеть, отличную от подсети, к которому подключен сетевой адаптер.
В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.
Синтаксис
uint32 SetGateways(
[in] string DefaultIPGateway[],
[in, optional] uint16 GatewayCostMetric[]
);
Параметры
-
DefaultIPGateway [in]
-
Список IP-адресов шлюзов, на которые направляются сетевые пакеты.
-
GatewayCostMetric [in, необязательный]
-
Присваивает значение в диапазоне от 1 до 9999, которое используется для вычисления самых быстрых и надежных маршрутов. Значения этого параметра соответствуют значениям в параметре DefaultIPGateway . Значение по умолчанию для шлюза — 1.
Возвращаемое значение
Возвращает значение 0 (ноль) для успешного завершения, если перезагрузка не требуется, 1 (одно) для успешного завершения, когда требуется перезагрузка, и любое другое значение в случае ошибки. Дополнительные сведения о кодах ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
Успешное завершение, перезагрузка не требуется
-
0
-
Успешное завершение, требуется перезагрузка
-
1
-
Метод не поддерживается на этой платформе
-
64
Метод не поддерживается, если сетевой адаптер находится в режиме DHCP.
-
Неизвестный сбой
-
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
Комментарии
Этот метод работает только в том случае, если сетевая карта (NIC) находится в режиме статического IP-адреса.
Чтобы очистить шлюз, задайте для шлюза тот же IP-адрес, который используется в EnableStatic.
Примеры
В примере Изменения шлюзов для сетевого адаптера VBScript настраивается два шлюза для сетевого адаптера.
Пример назначения статического IP-адреса VBScript задает IP-адрес и шлюз компьютера.
Пример Статического IP-адреса и последующего присоединения к домену PowerShell помогает в перестроении компьютеров.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|