SharePoint 2013 代码创建应用程序目录(App Catalog)

plantegg

　　众所周知，SharePoint App是2013版本的一大特色，那么，关于App的分发有几种方式呢？SharePoint给我们提供了两种方式，一种是上载到SharePoint应用商店，另一种是在本地SharePoint环境中创建应用程序目录，为本地用户提供App的分发。
　　SharePoint服务器场中可以有多个应用程序目录，每个目录针对服务器场中的一个Web 应用程序。若要为Web应用程序配置应用程序目录，只需提供要用于应用程序目录网站的网站集管理员的名称。创建应用程序目录后，网站集管理员可将 SharePoint相关应用程序上载到该目录。

　　（SharePoint应用程序商店和应用程序目录对比图）
　　从上图中，我们可以看到SharePoint商店和应用程序目录对于本地IT的关系，SharePoint商店不是本文要介绍的，我们进入正题，介绍应用程序目录。SharePoint的应用程序目录，是部署在每个应用程序下的一个SPCatelog类型的站点，我们可以在管理中心的UI中根据向导创建，也可以使用代码创建一个SPCatelog类型的站点，用PowerShell关联应用程序，这是我们要介绍的内容。
　　一开始，我们简单介绍了应用程序目录，以及和SharePoint商店的关系和对比，下面我们介绍如何创建应用程序目录。两种方式：管理中心UI和代码创建，前者就是一系列截图演示，后者才是重点。

一、管理中心通过界面创建
　　1、打开管理中心，在左侧导航选择应用程序，然后点击管理应用程序目录；

　　2、可以选择现有的应用程序目录网站，或者创建新的应用程序目录网站；

　　3、如果已存在SPAppCateLog类型的站点，输入URL地址点击确定即可完成关联；如果不是SPAppCateLog类型的站点，是不能设置为应用程序目录的，如下图报错；

　　4、走向导创建应用程序目录，其实就是创建一个SPAppCateLog类型的站点（SPSite），和创建网站集的过程很相似；

　　5、创建完毕，如下图，我们就可以通过创建的应用程序目录，上载、分发App了：

　　6、查看应用程序目录的网站内容，如下图：

　　7、若要规划应用程序目录设置，请确定以下几点：
　　　　Ø哪些 Web 应用程序将需要应用程序目录。
　　此决定与有关在 SharePoint 环境中支持 SharePoint 相关应用程序的决定是一起做出的。如果您的服务器场中对于不同的 Web 应用程序有不同类型的网站（Intranet、Extranet 和 Internet），则可以确定是否需要为这些 Web 应用程序各配置一个应用程序目录。
　　　　Ø作为应用程序目录网站集管理员添加的人员。
　　应用程序目录是 Web 应用程序中的一个网站，只能通过管理中心中的链接或使用 URL 直接访问该网站。

二、代码创建AppCatelog，PowerShell关联
　　1、其实没什么太多可说的，AppCatelog就是一个SPAppCateLog类型的站点，上面也已经介绍过了，如下代码，创建SPAppCateLog类型的SPSite；



SPWebApplicationBuilder webappbuilder = new SPWebApplicationBuilder(SPFarm.Local);
SPWebService webs = new SPWebService("webs", SPFarm.Local);
SPWebApplicationCollection webappcoll = new SPWebApplicationCollection(webs);
Guid gu = new Guid("693d5e1b-91c0-4829-888e-f67c43afbc50");
SPWebApplication webapp = webappcoll[gu];
SPSite site = webapp.Sites.Add("/sites/spappcatelog", "title", "description", 2052, SPWebTemplate.WebTemplate.AppCatalog.ToString(), "domain\\user", "测试用户", user@domain.com);
webapp.Update();
　　Guid是我要使用的应用程序的ID，当然可以使用应用程序的名称；2052是中文的意思，如果英文应该是1033；模板类型虽然我是读取的，但是输出看了一眼，就是SPCatelog，然后就是网站的管理员，基本就这么几个参数。
　　2、创建应用程序目录，PowerShell命令：



Update-SPAppCatalogConfiguration -Site http://url -Force:$true -SkipWebTemplateChecking:$true
　　PowerShell命令作用是，把改站点设置为所在应用程序的应用程序目录，所以不需要指定应用程序，即可。在SharePoint PowerShell中执行，即可。
　　3、PowerShell封装的C#方法，如下：



public bool UpdateSPAppCatalog(string siteurl)
{
bool myvalue = true;
try
{
PowerShell ps = PowerShell.Create();
ps.AddScript("Add-PsSnapin \"Microsoft.SharePoint.PowerShell\"");
ps.AddScript("Set-ExecutionPolicy -ExecutionPolicy \"Unrestricted\" -Force");
ps.AddScript("Update-SPAppCatalogConfiguration -Site " + siteurl + " -Force:$true -SkipWebTemplateChecking:$true");
ps.Invoke<string>();
}
catch
{
myvalue = false;
}
return myvalue;
}
　　因为PowerShell默认执行的是Windows的PowerShell，所以需要Add-PsSnapin一下SharePoint的引用(Microsoft.SharePoint.PowerShell)才能执行SharePoint的PowerShell。
　　到此为止，应用程序目录C#代码创建已经结束了！

三、弦外之音
　　画外音
　　我用代码创建AppCatelog的初衷，是想封装成WebService，然后给程序调用，然后发现封装完毕WebService了，但是调用的时候没有操作PowerShell的权限，后来查了下资料，发现有人可以封装为COM+组件，但是和我的应用场景不太适合，也就没再弄下去，所以介绍到这里，希望能给需要的人，一点点帮助。
　　特别感谢
　　在做这段东西的时候，特别感谢CSDN论坛的天涯海角提供的思路和博客园的忘忧草提供的PowerShell脚本参考！技术在于分享，有分享、有讨论才有进步。谢谢！
　　附 录
　　使用PowerShell脚本创建SPSite
　　http://msdn.microsoft.com/zh-cn/magazine/ff607937.aspx
　　App Management Service cmdlets in SharePoint 2013
　　http://technet.microsoft.com/en-us/library/jj219772(office.15)
　　规划 SharePoint 2013 相关应用程序
　　http://technet.microsoft.com/zh-cn/library/fp161237