sharepoint - 如何在 PowerShell 函数中安全地处理 SharePoint 对象？

Question

处理函数内创建的对象的正确方法是什么？我在一个网站上发现了这个方法。

function get-spweb ([String]$webUrl=$(throw 'Parameter -webUrl is missing!'))
{
   $site = get-SPSite $weburl
   return $site.OpenWeb()
   $site.Dispose()
}

此函数中是否调用过 Dispose 方法？

Answer 1

首先，您实际上并不希望在此处调用 Dispose - 当您在 SPSite 实例上调用 Dispose 时，通过其 OpenWeb 返回的所有 Web 也会被释放，因为它们由该 SPSite“拥有”!

SharePoint 2010 的 cmdlet 使用的模型之一是一种“延迟处置”，这意味着 SPWeb 实例在它们所涉及的管道完成之前不会被处置。其工作原理如下:

function Get-SPWeb {
     param([uri]$Url)

     begin {
         # get SPSite that owns the passed Url
         $site = new-object microsoft.sharepoint.spsite $url
         # return specific SPWeb instance
         $site.OpenWeb() 
     }
     end {
         # this disposes owning spsite AND the returned web
         $site.Dispose()
     }
}

现在这是它在实践中的工作原理(这是一行):

ps> get-spweb "http://localhost/sites/test" | foreach-object {
    $_.Title = "New Name"; $_.update()
}

第一部分将获取单个 SPWeb 实例并将其传递给 ForEach-Object 部分。仅当 foreach 完成(并完成更改网站标题)时，才会在 get-spweb 中调用相应的 End block ，从而处理站点和网站。重要的是整个管道是在单次调用中执行的单个代码块。

这不会像这样交互工作:

ps> $w = get-spweb "http://localhost/sites/test" # calls begin AND end
ps> $w.title = "new name"
ps> $w.update() # boom! web is already disposed

因此，在后一个示例中，您必须使用 get-spweb 的不同实现(省略结束 block ，或使用 switch 参数抑制它)，然后您必须自己处理该站点。

另一个重要的细节是，在 powershell 中与共享点对象交互工作将导致内存泄漏。默认情况下，powershell 在 MTA(多线程单元)中运行，并将使用线程池来执行你的命令。输入的每一行将使用不同的线程。每次使用不同的线程访问 COM 对象时，都会从非托管堆中泄漏一些内存，因为为上下文切换分配了新堆(没有释放旧堆)。可以通过使用以下命令启动 powershell.exe 来缓解这一问题: -STA 开关。这将确保所有命令和管道都使用同一线程执行，避免内存泄漏。也就是说，只需关闭 powershell 控制台即可再次重新获得所有内存，但如果您不小心，长时间运行的脚本可能会导致服务器内存不足，从而导致 SharePoint 瘫痪(任何其他不喜欢缺乏工作集的东西)。 )这就是为什么单行方法在前一个示例中效果如此良好:对象在同一个管道中分配和处置，并且通过扩展，在同一个线程中。无泄漏。