Azure PowerShell函数用托管身份操作SharePoint列表遇模块加载错误

1. 检查requirements.psd1配置正确性 #

确保文件格式无语法错误，模块名称和版本指定准确，示例：

@{
    'PnP.PowerShell' = '2.2.0' # 选择与PowerShell运行时兼容的版本，2.x系列适配PowerShell 7.x
}

注意：不要在模块列表末尾加多余逗号，否则会导致解析失败，模块无法自动下载

2. 匹配PowerShell运行时版本 #

PnP.PowerShell 2.x及以上版本仅支持PowerShell 7.x，需将函数应用的运行时版本调整为7.2或更高：

• 进入函数应用 -> 配置 -> 常规设置 -> 运行时版本
• 选择PowerShell 7.2或PowerShell 7.4，保存后重启函数应用

3. 手动强制加载模块 #

在函数代码开头添加模块导入命令，避免自动加载失效：

Import-Module PnP.PowerShell -RequiredVersion 2.2.0 -Force

4. 验证模块是否成功部署 #

通过Kudu控制台确认模块已下载：

• 进入函数应用 -> 高级工具 -> 调试控制台 -> PowerShell
• 导航到D:\home\site\wwwroot\.powershell\modules，检查是否存在PnP.PowerShell文件夹及对应版本目录
• 若不存在，检查requirements.psd1是否有拼写错误，或函数应用是否有网络访问权限下载模块（需允许访问PowerShell Gallery）

5. 托管身份连接SharePoint的完整代码示例 #

模块加载正常后，使用托管身份连接并批量删除列表项的代码：

# 强制加载指定版本的PnP模块
Import-Module PnP.PowerShell -RequiredVersion 2.2.0 -Force

# 连接HR站点
Connect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/HR" -ManagedIdentity

# 分页获取emails列表所有项（适配大量数据场景）
$listItems = @()
$page = 1
do {
    $items = Get-PnPListItem -List "emails" -PageSize 500 -Page $page
    $listItems += $items
    $page++
} while ($items.Count -eq 500)

# 批量删除所有项
if ($listItems.Count -gt 0) {
    Remove-PnPListItem -List "emails" -Identity $listItems -Force -Batch
    Write-Host "成功删除$($listItems.Count)条列表项"
} else {
    Write-Host "emails列表中无项可删除"
}

6. 确认托管身份权限 #

确保托管身份已获得HR站点的必要权限：

• 测试阶段可直接授予站点管理员权限：在SharePoint站点设置 -> 站点权限 -> 高级权限设置 -> 添加用户/组，搜索托管身份名称并设为站点管理员
• 生产环境可配置最小权限：使用PnP命令授予对emails列表的读取和删除权限（需模块加载正常后执行）

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