萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

C# 使用 WMI (Win32_NetworkAdapterConfiguration) 程式化設定網路參數 (IP、DNS、閘道、子網路遮罩)

透過 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();

必要條件與權限

  1. 管理員權限: 修改網路設定需要 `SeLoadDriverPrivilege` / `SeNetworkLogonRight`,程式必須以系統管理員身分執行 (參考前一篇 UAC 昇權文章)。
  2. 目標框架: .NET Framework / .NET Core / .NET 5+ 皆支援 `System.Management` (需安裝 NuGet `System.Management`)。
  3. WMI 服務啟動: 確認 `Winmgmt` 服務正在執行。

常見錯誤碼對照

代碼常見原因解決
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 進行網路自動化配置,需謹記權限門檻與參數嚴格驗證,建議搭配單元測試驗證各種網路拓撲下的行為。

copyright © 萬盛學電腦網 all rights reserved