很多web安装程序都会在IIS里添加应用程序或者应用程序池,早期用ASP.NET操作IIS非常困难,不过,从7.0开始,微软提供了 Microsoft.Web.Administration 类,可以很容易操作IIS。
本文主要介绍四点:
一.添加应用程序
二.添加应用程序池
三.设置应用程序所使用的应用程序池
四.IIS里其他属性的设置
首先,必须确保电脑上已经安装了IIS,安装后,系统默认会注册一个DLL,通常位置是
C:\Windows\assembly\GAC_MSIL\Microsoft.Web.Administration\7.0.0.0__31bf3856ad364e35\Microsoft.Web.Administration.dll
要获取站点和应用程序,代码为:
public static ApplicationPool getAppPool()
{
ServerManager manager = new ServerManager();
return manager.ApplicationPools;
}
public static SiteCollection GetAllSite()
{
ServerManager manager = new ServerManager();
SiteCollection sites = manager.Sites;
return sites;
}
一.添加应用程序
手动添加应用程序,通常是在“Default Web Site”上,右键,选择“添加应用程序...”,然后在弹出的对话框里,输入应用程序名称和物理路径,如下图所示。
这个操作,使用C#代码操作为
public static void CreateVdir(string vdir, string phydir)
{
ServerManager serverManager = new ServerManager();
Site mySite = serverManager.Sites["Default Web Site"];
mySite.Applications.Add("/" + vdir, phydir);
serverManager.CommitChanges();
}
首先定义一个ServerManager 对象,然后用Sites获取站点的集合。,最后调用Applications属性里的Add方法将应用程序添加到站点里。但是请注意:建立应用程序是以“/”为路径的,所以,上面代码里传入的参数,直接输入应用程序名称即可。
要在Default Web Site默认站点下建立一个名称为 test的应用程序,其物理路径为 D:\web\sample ,则调用为
CreateVdir("test","d:\\web\\sample")
删除一个应用程序也很简单,直接调用Remove方法即可。
public static void DeleteVdir(string vDirName)
{
ServerManager serverManager = new ServerManager();
Site mySite = serverManager.Sites["Default Web Site"];
Microsoft.Web.Administration.Application application = mySite.Applications["/" + vDirName];
mySite.Applications.Remove(application);
serverManager.CommitChanges();
}
二、添加应用程序池
手动在IIS里添加应用程序池为直接在IIS控制面板里添加。
使用c#代码如下
public static void CreateAppPool( string appPoolName)
{
ServerManager serverManager = new ServerManager();
serverManager.ApplicationPools.Add(appPoolName);
ApplicationPool apppool = serverManager.ApplicationPools[appPoolName];
apppool.ManagedPipelineMode = ManagedPipelineMode.Integrated;
apppool.Enable32BitAppOnWin64 = true;
apppool.ManagedRuntimeVersion = "v4.0";
serverManager.CommitChanges();
apppool.Recycle();
}
从上面代码里可以看到,ApplicationPool 提供了 Enable32BitAppOnWin64 、ManagedPipelineMode 、ManagedRuntimeVersion等属性,可以很容易使用。
就像上面代码,要使用集成模式可以直接设置 apppool.ManagedPipelineMode = ManagedPipelineMode.Integrated 。
删除应用程序池同样也比较简单,调用remove方法
public static void DeleteAppPool(string appPoolName)
{
ServerManager serverManager = new ServerManager();
ApplicationPool apppool = serverManager.ApplicationPools[appPoolName];
serverManager.ApplicationPools.Remove(apppool);
serverManager.CommitChanges();
}
三:设置应用程序所使用的应用程序池
手动操作:在IIS里,选择应用程序后,在高级设置里,可以直接修改应用程序所使用的应用程序池。
要完成类似上面的操作,可以设置Applications的ApplicationPoolName属性,该属性表示应用程序所使用的应用程序池名称。
public static void AssignVDirToAppPool(string vdir, string appPoolName)
{
ServerManager serverManager = new ServerManager();
Site site = serverManager.Sites["Default Web Site"];
site.Applications["/" + vdir].ApplicationPoolName = appPoolName;
serverManager.CommitChanges();
}
四:控制IIS里的其他属性
除了应用程序和应用程序池,使用ServerManager类还可以操控IIS里的更多属性。例如设置ISAPI和CGI的限制。
手动操作为:打开ISAPI和CGI操作,在需要的.NET版本上启用或者禁用。
完成上面操的代码如下
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection isapiCgiRestrictionSection = config.GetSection("system.webServer/security/isapiCgiRestriction");
ConfigurationElementCollection isapiCgiRestrictionCollection = isapiCgiRestrictionSection.GetCollection();
foreach (ConfigurationElement element in isapiCgiRestrictionCollection)
{
string path = element["path"].ToString();
string allowed = element["allowed"].ToString();
string description = element["description"].ToString();
string groupId = element["groupId"].ToString();
if (description == "ASP.NET v4.0.30319")
{
element["allowed"] = true;
}
}
serverManager.CommitChanges();
}
你甚至可以在ISPAPI里增加自己的配置:
ConfigurationElement addElement = isapiCgiRestrictionCollection.CreateElement("add");
addElement["path"] = @"C:\Windows\abc\aspnet_isapi.dll";
addElement["allowed"] = true;
addElement["groupId"] = @"ContosoGroup";
addElement["description"] = @"Contoso Extension";
isapiCgiRestrictionCollection.Add(addElement);
serverManager.CommitChanges();
当然,上面代码里的“难点”是,可能你并不知道IIS里,各个属性的 Section("system.webServer/security/isapiCgiRestriction") 是多少,不过不用担心
微软的官方文档已经详细列出了各个节点,你只要根据根据需要使用相应的节点即可进行相关操作。
网址为: https://docs.microsoft.com/en-us/iis/configuration/system.webserver/security/isapicgirestriction/
有了上面的属性,如果后期想定制exe版本的web安装程序,就可以使用这些类控制IIS。