編程控制IIS實際上很簡單,和ASP一樣,.Net中需要使用ADSI來操作IIS,但是此時我們不再需要GetObject,因為.Net為我們提供了更加強大功能的新東西。
System.DirectoryServices命名空間中包括了些強大的--DirectoryEntry,DirectoryEntries,它們為我們提供了訪問活動目錄的強大功能,在這些類允許我們操作IIS、LDAP、NDS以及WinNT。
不過我們此處只談IIS的控制,一般來說,我們操作IIS一般都是對虛擬目錄的操作,因此我將此列為主要的內容來講。
首先我們要搞清楚IIS的層次結構的問題,下面是我從國外找來的一張圖,很好的解釋了IIS的層次結構:
[htmChina:Image id=Image1|12][/htmChina:Image]
為了搞清楚IIS的控制語法,我們就必須搞清上圖,了解IIS元數據(Metabase)的層次結構。圖中的每一個節點稱之Key,而每個Key可以包含一個或多個值,這些值就是我們說的屬性(properties),IIS元數據中的Key與IIS中的元素是相符的,因此元數據中的屬性值的設定是會影響IIS中的設置。這就是我們編程的基本思路和核心。
另外還要了解一下Schema這個概念。它表示IIS中構架的名稱,即可以理解IIS元數據中Key的類型,具體點說就是指每個結點的類型。我們知道,IIS中有虛擬目錄,普通目錄,以及文件這些東東,而這些都屬於IIS的元素,區分的他們的標幟就是Schema。比如虛擬目錄的Schema就是"IIsVirtualDir",普通目錄就是"IIsWebDir"。這樣我們添加、刪除目錄時,IIS就知道我們添加的是虛擬目錄還是普通目錄。
創建虛擬目錄
DirectoryEntry是.Net給我們的一大禮物,他的名字我們就知道他的功能--目錄入口。使用過ADSI的人都知道操作IIS,WinNT這些時,我們還需要提供他們的Path,操作IIS時,這個Path的格式為:
IIS://ComputerName/Service/Website/Directory
ComputerName:即操作的服務器的名字,可以是名字也可以是IP,經常用的就是localhost
Service:即操作的服務器,IIS中有Web,也有FTP,還有SMTP這些服務,我們主要是操作IIS的Web功能,因此此處就是"W3SVC",如果是FTP則應是"MSFTPSVC"
WebSite:一個IIS服務中可以包括很多的站點,這個就用於設置操作的站點。他的值是一個數字,默認是1,表示缺省站點,如果有其它,則從1開始依次類推。
Directory:不用說,即操作的目錄名稱,一個站點一般頂層目錄為"ROOT",其它目錄則是他的孩子(Child)。
首先我們獲取一個站點的頂層目錄(根目錄):
DirectoryEntry rootfolder = new DirectoryEntry("IIS://localhost/W3SVC/1/ROOT");
如果我們創建這個對象是沒有發生異常,則表示這個目錄是真實存在的。
下面我們來添加新的虛擬目錄,比如我們要加的是"Aspcn":
DirectoryEntry newVirDir = rootfolder.Children.Add("Aspcn","IIsWebVirtualDir"); newVirDir.Invoke("AppCreate",true); newVirDir.CommitChanges(); rootfolder.CommitChanges();
創建目錄的思路很簡單,即在根目錄的子集(rootfolder.Children)中再添加一條記錄,這裡使用的是DirectoryEntries類中的Add方法,它返回的是一個DirectoryEntry,表示新加入的目錄,第一個參數是虛擬目錄的名字,第二個則是Schema的類名以表明我們加入的目錄類型。然後再使用DirectoryEntry的Invoke方法,調用ADSI中的"AppCreate"方法將目錄真正創建(似乎不走這一步也可以創建目錄成功,但是為了保險起見,大家還是用吧),最後便是依次調用新、根目錄的CommitChanges方法,確認此次操作。
在創建新目錄時,我們也可以同時給這個目錄的屬性賦值,但是我的實戰經驗告訴我,最好不要這樣做,如果創建時就賦值,將有很多屬性不能賦值成功,比如重要的表示真實目錄的Path屬性。因此飛刀建議大家最好是先創建目錄,然後再賦值,即更新目錄信息。
更新虛擬目錄
相信大家對IIS都比較熟悉,了解IIS中一些重要的設置,如可讀(AccessRead)、可寫(AccessWrite)、可執行(AccessExecute)等。這些都可通過對DirectoryEntry的Properties屬性集合的賦值來實現。賦值可以通過兩種方式來完成:
第一種是調用Properties集合的Add方法,如:
dir.Properties["AccessRead"].Add(true);
第二種是對第一個索引值賦值:
dir.Properties["AccessRead"][0] = true;
這兩種方法都是可行的。具體是要看你的喜好了。
在進行賦值之前我們還是要確定要要賦值的目標吧:)這裡我們使用DirectoryEntries類的Find方法,如:
DirectoryEntry de = rootfolder.Children.Find("Aspcn","IIsVirtualDir");
找到了,我們就可以賦值了。賦值時一定要好好看看啊,虛擬目錄的屬性值可以超多,一查一大堆。。:(太多了,飛刀我也不重復了,大家去微軟的站點上查:)
比較常用的有:AccessRead,AccessWrite,AccessExecute,AccessScript,DefaultDoc,EnableDefaultDoc,Path
刪除虛擬目錄
刪除虛擬目錄的方法也很簡單,就是找到你要刪除的虛擬目錄,然後調用AppDelete方法。
DirectoryEntry de = rootfolder.Children.Find("Aspcn","IIsVirtualDir"); de.Invoke("AppDelete",true); rootfolder.CommitChanges();
還有一種方法,就是調用Root目錄的Delete方法。
object[] paras = new object[2]; paras[0] = "IIsWebVirtualDir"; //表示操作的是虛擬目錄 paras[1] = "Aspcn"; rootfolder.Invoke("Delete",paras); rootfolder.CommitChanges();
.Net中如何操作IIS(源代碼)
using System; using System.Data; using System.DirectoryServices; using System.Collections; namespace Aspcn.Management { /// <summary> /// IISManager 的摘要說明。 /// </summary> public class IISManager { //定義需要使用的 private string _server,_website; private VirtualDirectories _virdirs; protected System.DirectoryServices.DirectoryEntry rootfolder; private bool _batchflag; public IISManager() { //默認情況下使用localhost,即訪問本地機 _server = "localhost"; _website = "1"; _batchflag = false; } public IISManager(string strServer) { _server = strServer; _website = "1"; _batchflag = false; } /// <summary> /// 定義公共屬性 /// </summary> //Server屬性定義訪問機器的名字,可以是IP與計算名 public string Server { get{ return _server;} set{ _server = value;} } //WebSite屬性定義,為一數字,為方便,使用string //一般來說第一台主機為1,第二台主機為2,依次類推 public string WebSite { get{ return _website; } set{ _website = value; } } //虛擬目錄的名字 public VirtualDirectories VirDirs { get{ return _virdirs; } set{ _virdirs = value;} } ///<summary> ///定義公共方法 ///</summary> //連接服務器 public void Connect() { ConnectToServer(); } //為方便重載 public void Connect(string strServer) { _server = strServer; ConnectToServer(); } //為方便重載 public void Connect(string strServer,string strWebSite) { _server = strServer; _website = strWebSite; ConnectToServer(); } //判斷是否存這個虛擬目錄 public bool Exists(string strVirdir) { return _virdirs.Contains(strVirdir); } //添加一個虛擬目錄 public void Create(VirtualDirectory newdir) { string strPath = "IIS://" + _server + "/W3SVC/" + _website + "/ROOT/" + newdir.Name; if(!_virdirs.Contains(newdir.Name) || _batchflag ) { try { //加入到ROOT的Children集合中去 DirectoryEntry newVirDir = rootfolder.Children.Add(newdir.Name,"IIsWebVirtualDir"; newVirDir.Invoke("AppCreate",true); newVirDir.CommitChanges(); rootfolder.CommitChanges(); //然後更新數據 UpdateDirInfo(newVirDir,newdir); } catch(Exception ee) { throw new Exception(ee.ToString()); } } else { throw new Exception("This virtual directory is already exist."; } } //得到一個虛擬目錄 public VirtualDirectory GetVirDir(string strVirdir) { VirtualDirectory tmp = null; if(_virdirs.Contains(strVirdir)) { tmp = _virdirs.Find(strVirdir); ((VirtualDirectory)_virdirs[strVirdir]).flag = 2; } else { throw new Exception("This virtual directory is not exists"; } return tmp; } //更新一個虛擬目錄 public void Update(VirtualDirectory dir) { //判斷需要更改的虛擬目錄是否存在 if(_virdirs.Contains(dir.Name)) { DirectoryEntry ode = rootfolder.Children.Find(dir.Name,"IIsWebVirtualDir"; UpdateDirInfo(ode,dir); } else { throw new Exception("This virtual directory is not exists."; } } //刪除一個虛擬目錄 public void Delete(string strVirdir) { if(_virdirs.Contains(strVirdir)) { object[] paras = new object[2]; paras[0] = "IIsWebVirtualDir"; //表示操作的是虛擬目錄 paras[1] = strVirdir; rootfolder.Invoke("Delete",paras); rootfolder.CommitChanges(); } else { throw new Exception("Can't delete " + strVirdir + ",because it isn't exists."; } } //批量更新 public void UpdateBatch() { BatchUpdate(_virdirs); } //重載一個:-) public void UpdateBatch(VirtualDirectories vds) { BatchUpdate(vds); } ///<summary> ///私有方法 ///</summary> //連接服務器 private void ConnectToServer() { string strPath = "IIS://" + _server + "/W3SVC/" + _website +"/ROOT"; try { this.rootfolder = new DirectoryEntry(strPath); _virdirs = GetVirDirs(this.rootfolder.Children); } catch(Exception e) { throw new Exception("Can't connect to the server ["+ _server +"] ...",e); } } //執行批量更新 private void BatchUpdate(VirtualDirectories vds) { _batchflag = true; foreach(object item in vds.Values) { VirtualDirectory vd = (VirtualDirectory)item; switch(vd.flag) { case 0: break; case 1: Create(vd); break; case 2: Update(vd); break; } } _batchflag = false; } //更新東東 private void UpdateDirInfo(DirectoryEntry de,VirtualDirectory vd) { de.Properties["AnonymousUserName"][0] = vd.AnonymousUserName; de.Properties["AnonymousUserPass"][0] = vd.AnonymousUserPass; de.Properties["AccessRead"][0] = vd.AccessRead; de.Properties["AccessExecute"][0] = vd.AccessExecute; de.Properties["AccessWrite"][0] = vd.AccessWrite; de.Properties["AuthBasic"][0] = vd.AuthBasic; de.Properties["AuthNTLM"][0] = vd.AuthNTLM; de.Properties["ContentIndexed"][0] = vd.ContentIndexed; de.Properties["EnableDefaultDoc"][0] = vd.EnableDefaultDoc; de.Properties["EnableDirBrowsing"][0] = vd.EnableDirBrowsing; de.Properties["AccessSSL"][0] = vd.AccessSSL; de.Properties["AccessScript"][0] = vd.AccessScript; de.Properties["DefaultDoc"][0] = vd.DefaultDoc; de.Properties["Path"][0] = vd.Path; de.CommitChanges(); } //獲取虛擬目錄集合 private VirtualDirectories GetVirDirs(DirectoryEntries des) { VirtualDirectories tmpdirs = new VirtualDirectories(); foreach(DirectoryEntry de in des) { if(de.SchemaClassName == "IIsWebVirtualDir" { VirtualDirectory vd = new VirtualDirectory(); vd.Name = de.Name; vd.AccessRead = (bool)de.Properties["AccessRead"][0]; vd.AccessExecute = (bool)de.Properties["AccessExecute"][0]; vd.AccessWrite = (bool)de.Properties["AccessWrite"][0]; vd.AnonymousUserName = (string)de.Properties["AnonymousUserName"][0]; vd.AnonymousUserPass = (string)de.Properties["AnonymousUserName"][0]; vd.AuthBasic = (bool)de.Properties["AuthBasic"][0]; vd.AuthNTLM = (bool)de.Properties["AuthNTLM"][0]; vd.ContentIndexed = (bool)de.Properties["ContentIndexed"][0]; vd.EnableDefaultDoc = (bool)de.Properties["EnableDefaultDoc"][0]; vd.EnableDirBrowsing = (bool)de.Properties["EnableDirBrowsing"][0]; vd.AccessSSL = (bool)de.Properties["AccessSSL"][0]; vd.AccessScript = (bool)de.Properties["AccessScript"][0]; vd.Path = (string)de.Properties["Path"][0]; vd.flag = 0; vd.DefaultDoc = (string)de.Properties["DefaultDoc"][0]; tmpdirs.Add(vd.Name,vd); } } return tmpdirs; } } /// <summary> /// VirtualDirectory類 /// </summary> public class VirtualDirectory { private bool _read,_execute,_script,_ssl,_write,_authbasic,_authntlm,_indexed,_endirbrow,_endefaultdoc; private string _ausername,_auserpass,_name,_path; private int _flag; private string _defaultdoc; /// <summary> /// 構造函數 /// </summary> public VirtualDirectory() { SetValue(); } public VirtualDirectory(string strVirDirName) { _name = strVirDirName; SetValue(); } private void SetValue() { _read = true;_execute = false;_script = false;_ssl= false;_write=false;_authbasic=false;_authntlm=false; _indexed = false;_endirbrow=false;_endefaultdoc = false; _flag = 1; _defaultdoc = "default.htm,default.aspx,default.asp,index.htm"; _path = "C:"; _ausername = "";_auserpass ="";_name=""; } ///<summary> ///定義屬性,IISVirtualDir太多屬性了 ///我只搞了比較重要的一些,其它的大伙需要的自個加吧。 ///</summary> public int flag { get{ return _flag;} set{ _flag = value;} } public bool AccessRead { get{ return _read;} set{ _read = value;} } public bool AccessWrite { get{ return _write;} set{ _write = value;} } public bool AccessExecute { get{ return _execute;} set{ _execute = value;} } public bool AccessSSL { get{ return _ssl;} set{ _ssl = value;} } public bool AccessScript { get{ return _script;} set{ _script = value;} } public bool AuthBasic { get{ return _authbasic;} set{ _authbasic = value;} } public bool AuthNTLM { get{ return _authntlm;} set{ _authntlm = value;} } public bool ContentIndexed { get{ return _indexed;} set{ _indexed = value;} } public bool EnableDirBrowsing { get{ return _endirbrow;} set{ _endirbrow = value;} } public bool EnableDefaultDoc { get{ return _endefaultdoc;} set{ _endefaultdoc = value;} } public string Name { get{ return _name;} set{ _name = value;} } public string Path { get{ return _path;} set{ _path = value;} } public string DefaultDoc { get{ return _defaultdoc;} set{ _defaultdoc = value;} } public string AnonymousUserName { get{ return _ausername;} set{ _ausername = value;} } public string AnonymousUserPass { get{ return _auserpass;} set{ _auserpass = value;} } } /// <summary> /// 集合VirtualDirectories /// </summary> public class VirtualDirectories : System.Collections.Hashtable { public VirtualDirectories() { } //添加新的方法 public VirtualDirectory Find(string strName) { return (VirtualDirectory)this[strName]; } } }