Метод 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	CIMWin32.mof
DLL	CIMWin32.dll

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

Классы оборудования компьютерной системы

Win32_NetworkAdapterConfiguration

Задачи WMI: сеть

Задачи WMI: учетные записи и домены

Поддержка IPv6 и IPv4 в WMI