萬盛學電腦網

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

C# 程式啟動時自動提升為系統管理員權限 (UAC 昇權)

當應用程式需執行需要系統管理員權限的操作 (修改系統時間、寫入受保護登錄機碼、安裝服務、修改 hosts 檔等),必須以「系統管理員身分執行」。透過在 `Program.cs` 的 `Main` 入口點檢測目前權限並啟動 UAC 昇權,可實現程式預設以管理員身分運行。

完整實作程式碼 (Program.cs)

using System;
using System.Diagnostics;
using System.Security.Principal;
using System.Windows.Forms;

static class Program
{
    [STAThread]
    static void Main(string[] args)
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);

        // 1. 檢查目前使用者是否為系統管理員
        WindowsIdentity identity = WindowsIdentity.GetCurrent();
        WindowsPrincipal principal = new WindowsPrincipal(identity);
        bool isAdmin = principal.IsInRole(WindowsBuiltInRole.Administrator);

        if (isAdmin)
        {
            // 已是管理員,直接啟動主視窗
            Application.Run(new MainForm());
        }
        else
        {
            // 2. 非管理員:啟動新進程並要求 UAC 昇權
            ProcessStartInfo startInfo = new ProcessStartInfo
            {
                FileName = Application.ExecutablePath, // 當前執行檔路徑
                Arguments = string.Join(" ", args),    // 傳遞原始參數
                Verb = "runas",                        // 關鍵:要求以管理員身分執行
                UseShellExecute = true                 // 必須為 true 才能使用 runas verb
            };

            try
            {
                Process.Start(startInfo); // 觸發 UAC 提示視窗
            }
            catch (System.ComponentModel.Win32Exception ex)
            {
                // 使用者點擊 UAC 視窗的「否」
                MessageBox.Show("此程式需要系統管理員權限才能執行。", "權限不足", 
                    MessageBoxButtons.OK, MessageBoxIcon.Warning);
            }

            // 3. 結束目前非管理員進程
            Application.Exit();
        }
    }
}

關鍵點解析

屬性/方法作用
WindowsPrincipal.IsInRole(WindowsBuiltInRole.Administrator)檢查目前使用者 Token 是否包含 Administrators 群組 SID (已啟用)
ProcessStartInfo.Verb = "runas"要求 Shell 以提升權限啟動進程 (觸發 UAC 同意提示)
UseShellExecute = true啟用 Shell 執行模式,`runas` verb 僅在此模式有效
Application.ExecutablePath取得目前執行檔完整路徑,支援偵錯/發布/安裝後各種情境
string.Join(" ", args)保留原始命令列參數傳遞給昇權後的新進程

應用程式清單檔 替代方案 (無需程式碼檢測)

在專案屬性 → Application → 「View Windows Settings」建立 `app.manifest`,設定 `requestedExecutionLevel`:

<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
    <security>
      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
        <!-- level="requireAdministrator" 會強制 UAC 昇權 -->
        <requestedExecutionLevel level="requireAdministrator" uiAccess="false" />
      </requestedPrivileges>
    </security>
  </trustInfo>
</assembly>

差異: Manifest 方式會在啟動前就彈出 UAC,無法在程式碼中判斷使用者是否點選「否」並優雅處理 (如顯示唯讀模式)。程式碼檢測方式彈性更高。

常見應用場景

  • 修改系統時間 (`SetSystemTime` API)
  • 寫入 `HKEY_LOCAL_MACHINE` 登錄
  • 安裝/啟動/停止 Windows Service
  • 修改 `C:\Windows\System32\drivers\etc\hosts`
  • 建立防火牆規則 (`netsh advfirewall`)
  • 註冊 COM 元件、安裝裝置驅動程式

注意事項

  1. ClickOnce 部署不支援 UAC 昇權:需改用 MSI/InstallShield 或手動部署。
  2. 網路磁碟機映射問題:昇權後進程在不同 Token 下,可能看不到當前使用者的網路磁碟機 (需 `EnableLinkedConnections` 登錄值或重新映射)。
  3. 子進程繼承權限:昇權進程啟動的子進程預設也具管理員權限。
  4. 最小權限原則:僅在確實需要時昇權,核心業務邏輯盡量設計為無需管理員權限即可運行。

在 `Main` 入口點實作 UAC 昇權檢測,是 WinForms/WPF 桌面應用程式確保必要管理員權限的標準做法,配合 `app.manifest` 可提供雙重保障。

copyright © 萬盛學電腦網 all rights reserved