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

Статья
06/12/2023

Метод класса EnableStaticWMI включает статическую адресацию TCP/IP для целевого сетевого адаптера. В результате dhcp для этого сетевого адаптера отключен.

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

Синтаксис

uint32 EnableStatic(
  [in] string IPAddress[],
  [in] string SubnetMask[]
);

Параметры

IPAddress [in]

Выводит список всех статических IP-адресов текущего сетевого адаптера.

Пример: 155.34.22.0.

SubnetMask [in]

Маски подсети, дополняющие значения в параметре IPAddress .

Пример: 255.255.0.0.

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

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

Успешное завершение, перезагрузка не требуется

Успешное завершение, перезагрузка не требуется.

Успешное завершение, требуется перезагрузка

Успешное завершение, требуется перезагрузка.

Метод не поддерживается на этой платформе

Метод не поддерживается на этой платформе.

Неизвестный сбой

Неизвестный сбой.

Недопустимая маска подсети

Недопустимая маска подсети.

Ошибка при обработке возвращенного экземпляра

Ошибка при обработке возвращенного экземпляра.

Недопустимый входной параметр

Недопустимый входной параметр.

Указано более 5 шлюзов

Указано более пяти шлюзов.

Недопустимый IP-адрес

Недопустимый IP-адрес.

Недопустимый IP-адрес шлюза

Недопустимый IP-адрес шлюза.

Произошла ошибка при доступе к реестру для получения запрошенных сведений.

Произошла ошибка при доступе к реестру для запрашиваемых сведений.

Недопустимое доменное имя

Недопустимое доменное имя.

Недопустимое имя узла

Недопустимое имя узла.

Основной или вторичный сервер WINS не определен

Основной или вторичный сервер WINS не определен.

Недопустимый файл

Недопустимый файл.

Недопустимый системный путь

Недопустимый системный путь.

Сбой копирования файла

Сбой копирования файла.

Недопустимый параметр безопасности

Недопустимый параметр безопасности.

Не удалось настроить службу TCP/IP

Не удалось настроить службу TCP/IP.

Не удается настроить службу DHCP

Не удалось настроить службу DHCP. Дополнительные сведения см. в разделе «Примечания».

Не удается продлить аренду DHCP

Не удается продлить аренду DHCP.

Не удалось освободить аренду DHCP

Не удается освободить аренду DHCP.

IP-адрес не включен на адаптере

IP-адрес не включен на адаптере.

IPX не включен на адаптере

IPX не включен на адаптере.

Ошибка границ кадра или сетевого номера

Ошибка границы кадра или сетевого номера.

Недопустимый тип кадра

Недопустимый тип кадра.

Недопустимый номер сети

Недопустимый номер сети.

Повторяющийся номер сети

Повторяющийся номер сети.

Параметр выходит за пределы границ

Параметр выходит за пределы.

Доступ запрещен

Доступ запрещен.

Недостаточно памяти

Недостаточно памяти.

Уже существует

Уже существует.

Путь, файл или объект не найден

Путь, файл или объект не найден.

Не удается уведомить службу

Не удается уведомить службу.

Не удается уведомить службу DNS

Не удается уведомить службу DNS.

Интерфейс не настраивается

Интерфейс не настраивается.

Не все аренды DHCP могут быть освобождены или продлены

Не все аренды DHCP могут быть освобождены или продлены.

Dhcp не включен в адаптере

100

Протокол DHCP не включен для адаптера.

2147786788

Блокировка записи не включена. Дополнительные сведения см. в разделе INetCfgLock::AcquireWriteLock.

Другое

101 4294967295

При использовании EnableStatic для изменения IP-адреса удаленного компьютера при подключении через этот адаптер вы, скорее всего, потеряете подключение к удаленному компьютеру и получите сообщение об ошибке RPC not available. (однако параметры изменены). Чтобы избежать этого сценария, рассмотрите возможность изменения параметров шлюза и (или) DNS перед настройкой IP-адреса адаптера.

При использовании EnableStatic для предоставления адаптеру статической IP-конфигурации функция возвращает "81 — не удалось настроить службу DHCP", если адаптер уже настроен со статическим адресом. Тем не менее, функция по-прежнему успешно задается с помощью новой операции.

Примеры

Пример кода PowerShell для статического IP-адреса и последующего присоединения к домену в коллекции TechNet использует EnableStatic для добавления статического IP-адреса на локальный компьютер.

Пример кода VBScript для назначения статического IP-адреса в коллекции TechNet использует EnableStatic для задания IP-адреса компьютера.

В следующем примере VBScript показано, как отключить использование DHCP на экземпляре Win32_NetworkAdapterConfiguration. В этом случае мы указываем адаптер с индексом 0. Правильный индекс следует выбрать из Win32_NetworkAdapter экземпляров для других интерфейсов.

Примечание

Этот скрипт применяется только к системам на основе NT. Измените приведенные ниже переменные ipaddr и подсети на значения, которые нужно применить к адаптеру.

Set Adapter = GetObject("winmgmts:Win32_NetworkAdapterConfiguration=1")

ipaddr = Array("1.1.1.1")
subnet = Array("255.255.255.0")


RetVal = Adapter.EnableStatic(ipaddr,subnet)

if RetVal = 0 then 
 WScript.Echo "DHCP disabled, using static IP address"
else 
 WScript.Echo "DHCP disable failed"
end if

В следующем примере Perl показано, как отключить использование DHCP на экземпляре Win32_NetworkAdapterConfiguration. В этом случае мы указываем адаптер с индексом 0. Правильный индекс следует выбрать из Win32_NetworkAdapter экземпляров для других интерфейсов.

Примечание

use strict;
use Win32::OLE;

my ($Adapter, @ipaddr, @subnet, $RetVal);  
eval { $Adapter = 
 Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}!\\\\.\\root\\cimv2:Win32_NetworkAdapterConfiguration.Index=\"0\""); };

unless ($@) 
{
 push @ipaddr, "192.168.144.107";
 push @subnet, "255.255.255.0";

 $RetVal = $Adapter->EnableStatic(\@ipaddr, \@subnet);

 if ($RetVal == 0) 
 {
  print "\nDHCP disabled, using static IP address\n";
 }
 else 
 {
  print "\nDHCP disable failed\n";
 }
}
else
{
 print STDERR "\n", Win32::OLE->LastError, "\n";
}

Требования

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

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

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

Поделиться через