透過 WMI `Win32_NetworkAdapterConfiguration` 類別,可程式化設定本機網路介面的 IP 位址、子網路遮罩、預設閘道、DNS 伺服器,或啟用 DHCP。適用於嵌入式裝置、自動化部署、網路切換工具開發。
using System;
using System.Management;
using System.Text.RegularExpressions;
public static class NetworkConfigurator
{
/// 設定靜態 IP、子網路遮罩、閘道、DNS (全部或部分)
public static void SetIPAddress(string[] ipAddresses, string[] subnetMasks, string[] gateways, string[] dnsServers)
{
var wmi = new ManagementClass("Win32_NetworkAdapterConfiguration");
var moc = wmi.GetInstances();
foreach (ManagementObject mo in moc)
{
// 僅處理已啟用 IP 的網路介面
if (!(bool)mo["IPEnabled"]) continue;
ManagementBaseObject inParams, outParams;
// 1. 設定 IP 與子網路遮罩 (EnableStatic)
if (ipAddresses != null && subnetMasks != null && ipAddresses.Length == subnetMasks.Length)
{
inParams = mo.GetMethodParameters("EnableStatic");
inParams["IPAddress"] = ipAddresses;
inParams["SubnetMask"] = subnetMasks;
outParams = mo.InvokeMethod("EnableStatic", inParams, null);
CheckWmiResult(outParams, "EnableStatic (IP/Subnet)");
}
// 2. 設定預設閘道 (SetGateways)
if (gateways != null && gateways.Length > 0)
{
inParams = mo.GetMethodParameters("SetGateways");
inParams["DefaultIPGateway"] = gateways;
inParams["GatewayCostMetric"] = new int[] { 1 }; // 成本度量
outParams = mo.InvokeMethod("SetGateways", inParams, null);
CheckWmiResult(outParams, "SetGateways");
}
// 3. 設定 DNS 伺服器搜尋順序 (SetDNSServerSearchOrder)
if (dnsServers != null && dnsServers.Length > 0)
{
inParams = mo.GetMethodParameters("SetDNSServerSearchOrder");
inParams["DNSServerSearchOrder"] = dnsServers;
outParams = mo.InvokeMethod("SetDNSServerSearchOrder", inParams, null);
CheckWmiResult(outParams, "SetDNSServerSearchOrder");
}
}
}
/// 啟用 DHCP (自動取得 IP 與 DNS)
public static void EnableDHCP()
{
var wmi = new ManagementClass("Win32_NetworkAdapterConfiguration");
var moc = wmi.GetInstances();
foreach (ManagementObject mo in moc)
{
if (!(bool)mo["IPEnabled"]) continue;
// 先清除 DNS
mo.InvokeMethod("SetDNSServerSearchOrder", null, null);
// 啟用 DHCP
var result = mo.InvokeMethod("EnableDHCP", null, null);
CheckWmiResult(result, "EnableDHCP");
}
}
/// 檢查 WMI 方法呼叫結果 (ReturnValue: 0=成功, 其他=錯誤碼)
private static void CheckWmiResult(ManagementBaseObject result, string methodName)
{
if (result == null) return;
uint retVal = (uint)result["ReturnValue"];
if (retVal != 0)
{
string msg = GetWmiErrorMessage(retVal);
throw new InvalidOperationException($"WMI {methodName} 失敗 (代碼: {retVal}): {msg}");
}
}
private static string GetWmiErrorMessage(uint code)
{
return code switch
{
0 => "成功",
1 => "不支援",
2 => "存取被拒 (需管理員權限)",
3 => "參數錯誤",
4 => "無法執行",
5 => "未知錯誤",
_ => $"未定義錯誤碼: {code}"
};
}
/// 驗證 IPv4 格式
public static bool IsValidIPv4(string ip)
{
if (string.IsNullOrWhiteSpace(ip)) return false;
var parts = ip.Split('.');
if (parts.Length != 4) return false;
foreach (var p in parts)
{
if (!int.TryParse(p, out int n) || n < 0 || n > 255) return false;
if (p.Length > 1 && p.StartsWith("0")) return false; // 避免八進位誤判
}
return true;
}
}
// 設定靜態 IP
NetworkConfigurator.SetIPAddress(
new[] { "192.168.1.100" },
new[] { "255.255.255.0" },
new[] { "192.168.1.1" },
new[] { "8.8.8.8", "8.8.4.4" }
);
// 僅變更 DNS
NetworkConfigurator.SetIPAddress(null, null, null, new[] { "1.1.1.1", "1.0.0.1" });
// 切回 DHCP
NetworkConfigurator.EnableDHCP();
| 代碼 | 常見原因 | 解決 |
|---|---|---|
| 2 (Access Denied) | 非管理員權限 / UAC 未昇權 | 加入 app.manifest requireAdministrator 或程式碼昇權 |
| 3 (Invalid Parameter) | IP 格式錯誤、陣列長度不符、閘道不在同網段 | 驗證 IP 格式、確認閘道與 IP 同網段、陣列一一對應 |
| 4 (Cannot Execute) | 網路介面狀態異常 (已停用、纜線未插、驅動問題) | 檢查裝置管理員、啟用網路介面、更新驅動 |
| 5 (Unknown) | WMI 儲存庫損毀 / 系統錯誤 | 執行 `winmgmt /salvagerepository` 或 `winmgmt /resetrepository` (謹慎) |
public static void PrintCurrentConfig()
{
var wmi = new ManagementClass("Win32_NetworkAdapterConfiguration");
foreach (ManagementObject mo in wmi.GetInstances())
{
if (!(bool)mo["IPEnabled"]) continue;
Console.WriteLine($"介面: {mo["Description"]}");
Console.WriteLine($" MAC: {mo["MACAddress"]}");
Console.WriteLine($" IP: {string.Join(", ", (string[])mo["IPAddress"])}");
Console.WriteLine($" 遮罩: {string.Join(", ", (string[])mo["IPSubnet"])}");
Console.WriteLine($" 閘道: {string.Join(", ", (string[])(mo["DefaultIPGateway"] ?? new string[0]))}");
Console.WriteLine($" DNS: {string.Join(", ", (string[])(mo["DNSServerSearchOrder"] ?? new string[0]))}");
Console.WriteLine($" DHCP: {mo["DHCPEnabled"]}");
}
}
善用 WMI 進行網路自動化配置,需謹記權限門檻與參數嚴格驗證,建議搭配單元測試驗證各種網路拓撲下的行為。