SharePoint高权限PowerShell脚本函数参数传递失效求解

核心原因 #

SharePoint的RunWithElevatedPrivileges会启动独立的安全执行上下文，该上下文默认无法直接访问外部函数的参数变量，导致参数传递失效；而硬编码值是直接在该上下文内定义，因此能正常运行。

正确传参方法 #

方法1：将参数作为脚本块的参数传入 #

调用RunWithElevatedPrivileges时，把需要的参数通过脚本块的参数列表传递进去，示例代码：

function Get-SPItemPermissions {
    param(
        [Parameter(Mandatory=$true)]
        [string]$SiteUrl,
        [Parameter(Mandatory=$true)]
        [string]$ListName
    )

    # 定义接收参数的脚本块
    $elevatedScript = {
        param($TargetUrl, $TargetList)
        $site = Get-SPSite $TargetUrl
        $web = $site.OpenWeb()
        $list = $web.Lists[$TargetList]
        # 执行权限查询逻辑
        $list.RoleAssignments | Select-Object Member, RoleDefinitionBindings
        # 释放SharePoint对象
        $web.Dispose()
        $site.Dispose()
    }

    # 传入参数并执行高权限逻辑
    [Microsoft.SharePoint.SPSecurity]::RunWithElevatedPrivileges($elevatedScript, $SiteUrl, $ListName)
}

# 调用函数
Get-SPItemPermissions -SiteUrl "http://portal.contoso.com" -ListName "Documents"

方法2：使用$using:作用域修饰符（PowerShell 3.0+） #

若你的PowerShell版本为3.0及以上，可直接用$using:引用外部上下文的变量，无需显式传参，示例：

function Get-SPItemPermissions {
    param(
        [Parameter(Mandatory=$true)]
        [string]$SiteUrl,
        [Parameter(Mandatory=$true)]
        [string]$ListName
    )

    [Microsoft.SharePoint.SPSecurity]::RunWithElevatedPrivileges({
        # 通过$using:直接调用外部参数
        $site = Get-SPSite $using:SiteUrl
        $web = $site.OpenWeb()
        $list = $web.Lists[$using:ListName]
        $list.RoleAssignments | Select-Object Member, RoleDefinitionBindings
        # 释放对象
        $web.Dispose()
        $site.Dispose()
    })
}

# 调用函数
Get-SPItemPermissions -SiteUrl "http://portal.contoso.com" -ListName "Documents"

关键注意事项 #

• 必须在高权限上下文内调用Dispose()释放SPSite、SPWeb等对象，避免内存泄漏。
• 调试时可在脚本块内添加Write-Host $using:SiteUrl（或对应参数），验证参数是否成功传入。

内容的提问来源于stack exchange，提问作者Andy5