萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 操作 IIS 建立/更新/刪除虛擬目錄完整教學

核心概念:ADSI 與 DirectoryEntry

.NET 透過 System.DirectoryServices.DirectoryEntry 封裝 ADSI (Active Directory Service Interfaces),以 LDAP 風格路徑操作 IIS Metabase。路徑格式:IIS://///。

路徑元素對照表

元素說明常見值
Server目標主機localhost, IP, 主機名
ServiceIIS 服務類型W3SVC (Web), MSFTPSVC (FTP)
SiteID網站識別碼1 (預設站點), 2, 3...
Path虛擬路徑ROOT (根), MyApp (子應用)

取得根目錄 DirectoryEntry

// 連接預設網站根目錄
var root = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT");
// 若無例外,表示路徑存在

建立虛擬目錄 (三步驟)

public void CreateVirtualDir(string vdirName, string physicalPath) {
    using (var root = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT")) {
        // 1. 新增子節點,Schema 類別為 IIsWebVirtualDir
        using (var vdir = root.Children.Add(vdirName, "IIsWebVirtualDir")) {
            // 2. 設定為應用程式根目錄 (關鍵步驟)
            vdir.Invoke("AppCreate", true);
            
            // 3. 寫入物理路徑等屬性
            vdir.Properties["Path"][0] = physicalPath; // 索引 0 寫入
            vdir.Properties["AccessRead"][0] = true;
            vdir.Properties["AccessWrite"][0] = false;
            vdir.Properties["AccessExecute"][0] = false;
            vdir.Properties["AccessScript"][0] = true; // 執行腳本權限
            
            // 4. 提交變更
            vdir.CommitChanges();
        }
        root.CommitChanges();
    }
}

更新虛擬目錄屬性

public void UpdateVirtualDir(string vdirName, Action configAction) {
    using (var root = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT"))
    using (var vdir = root.Children.Find(vdirName, "IIsWebVirtualDir")) {
        configAction(vdir); // 傳入委派設定屬性
        vdir.CommitChanges();
        root.CommitChanges();
    }
}

// 使用範例
UpdateVirtualDir("MyApp", vdir => {
    vdir.Properties["Path"][0] = @"D:\NewPath";
    vdir.Properties["DefaultDoc"][0] = "index.html,default.aspx";
    vdir.Properties["EnableDefaultDoc"][0] = true;
});

刪除虛擬目錄 (兩種方式)

// 方式 1: 透過子節點 Invoke AppDelete
public void DeleteVirtualDir_V1(string vdirName) {
    using (var root = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT"))
    using (var vdir = root.Children.Find(vdirName, "IIsWebVirtualDir")) {
        vdir.Invoke("AppDelete", true); // 移除應用程式標記
        root.Children.Remove(vdir);     // 從集合移除
        root.CommitChanges();
    }
}

// 方式 2: 直接呼叫根目錄 Delete 方法
public void DeleteVirtualDir_V2(string vdirName) {
    using (var root = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT")) {
        object[] args = { "IIsWebVirtualDir", vdirName };
        root.Invoke("Delete", args);
        root.CommitChanges();
    }
}

常用屬性速查表

  • Path - 物理路徑 (最重要)
  • AccessRead, AccessWrite, AccessExecute, AccessScript - 權限控制
  • DefaultDoc - 預設文件 (逗號分隔)
  • EnableDefaultDoc - 是否啟用預設文件
  • AppFriendlyName - 應用程式顯示名稱
  • AppPoolId - 指定應用程式集區

權限與部署提醒

  • 執行身分需具備 IIS 管理權限 (通常需 Administrator 或特定 COM+ 角色)。
  • IIS 7+ 整合模式下,建議改用 Microsoft.Web.Administration (ServerManager API) 取代 ADSI,效能更好且型別安全。
  • 遠端操作需開啟 RPC/WMI 防火牆規則,並確認目標機器啟用 IIS Management Service。
copyright © 萬盛學電腦網 all rights reserved