萬盛學電腦網

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

VB.NET 程式化建立 IIS 虛擬目錄:DirectoryEntry 實戰教學

前言:自動化 IIS 部署的關鍵技能

在自動化部署、CI/CD 流程或多租戶 SaaS 系統中,程式化建立 IIS 虛擬目錄是常見需求。VB.NET 透過 System.DirectoryServices 命名空間的 DirectoryEntry 類別,可輕鬆操作 IIS 元數據庫完成此任務。

核心程式碼

Function CriaDiretorioVirtual(ByVal vdirname As String, _
    ByVal serverID As String, ByVal vdirPath As String, _
    ByVal criaApplication As Boolean) As DirectoryEntry

    Dim newvdir As DirectoryEntry
    Dim root As DirectoryEntry
    root = New DirectoryEntry("IIS://localhost/W3SVC/" + serverID + "/Root")
    newvdir = root.Children.Add(vdirname, "IIsWebVirtualDir")
    newvdir.Properties("Path")(0) = vdirPath

    If criaApplication Then
        newvdir.Invoke("AppCreate", True)
        newvdir.Properties("AppFriendlyName")(0) = vdirname
        newvdir.Properties("AppIsolated")(0) = 2 ' 應用程式隔離模式:進程外(集區)
    End If

    newvdir.CommitChanges()
    Return newvdir
End Function

參數說明

參數用途
vdirname虛擬目錄名稱(URL 路徑段)
serverID網站識別碼(預設網站通常為 "1")
vdirPath對應的實體磁碟路徑
criaApplication是否轉換為應用程式(獨立應用程式域)

關鍵步驟解析

  1. 連接 IIS 根節點:IIS://localhost/W3SVC/{siteID}/Root
  2. 新增 IIsWebVirtualDir 類型的子節點
  3. 設定 Path 屬性指向實體路徑
  4. 若需獨立應用程式:呼叫 AppCreate、設定友好名稱與隔離等級
  5. CommitChanges() 將變更寫入元數據庫

注意事項

  • 需參考 System.DirectoryServices.dll
  • 執行身份需具備 IIS 管理權限(通常需管理員權限)
  • IIS 7+ 建議改用 Microsoft.Web.Administration (ServerManager) API,支援更完整的配置結構

此技術適用於舊版 IIS (6.0) 環境維護,或需相容 .NET Framework 2.0/3.5 的專案。現代專案建議採用 PowerShell Cmdlets (New-WebVirtualDirectory) 或 Microsoft.Web.Administration 以獲得更佳支援。

copyright © 萬盛學電腦網 all rights reserved