.NET 透過 System.DirectoryServices.DirectoryEntry 封裝 ADSI (Active Directory Service Interfaces),以 LDAP 風格路徑操作 IIS Metabase。路徑格式:IIS://。
| 元素 | 說明 | 常見值 |
|---|---|---|
| Server | 目標主機 | localhost, IP, 主機名 |
| Service | IIS 服務類型 | W3SVC (Web), MSFTPSVC (FTP) |
| SiteID | 網站識別碼 | 1 (預設站點), 2, 3... |
| Path | 虛擬路徑 | ROOT (根), MyApp (子應用) |
// 連接預設網站根目錄
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 - 指定應用程式集區Microsoft.Web.Administration (ServerManager API) 取代 ADSI,效能更好且型別安全。IIS Management Service。