如何优化遍历SharePoint资源的PowerShell脚本性能？

针对你遍历大量SharePoint资源时的性能瓶颈，以下是实用的优化方案：

1. 精准控制OData查询，减少数据传输 #

不要默认拉取所有字段，只请求你需要的属性，同时通过关联查询仅展开必要的共享数据，大幅降低HTTP响应体积：

# 获取文档库时仅拉取关键字段
$libraries = Get-PnPList -Filter "BaseType eq 1" -Fields "Title", "Id", "RootFolder"

# 获取文档时，仅请求必要路径，避免加载冗余数据
$items = Get-PnPListItem -List $library -Fields "ID", "ServerRelativeUrl" -Query "<View><Query><Where><Eq><FieldRef Name='FSObjType'/><Value Type='Integer'>0</Value></Eq></Where></Query></View>"

对于共享成员数，直接查询计数而非拉取全部用户数据，节省传输和处理时间：

$countUrl = $web.Url + "/_api/web/GetFileByServerRelativeUrl('$($item["ServerRelativeUrl"])')/SharedWithUsers/$count"
$shareCount = Invoke-PnPRestMethod -Url $countUrl -Method Get
if ($shareCount -gt 50) {
    # 进一步处理该文档
}

2. 批量处理请求，减少HTTP交互次数 #

使用Invoke-PnPBatch将多个查询合并为单次HTTP调用，大幅降低网络开销：

$batch = New-PnPBatch
foreach ($library in $libraries) {
    Get-PnPListItem -List $library -Fields "ID", "ServerRelativeUrl" -Batch $batch
}
Invoke-PnPBatch -Batch $batch

3. 并行处理多站点/库（PowerShell 7+） #

利用ForEach-Object -Parallel并行处理不同站点或文档库，同时通过-ThrottleLimit控制并发数，避免触发SharePoint限流：

$sites | ForEach-Object -Parallel {
    Connect-PnPOnline -Url $_.Url -Interactive
    # 处理该站点下的库、文档逻辑
} -ThrottleLimit 5

4. 跳过系统库与无共享可能的资源 #

提前过滤掉无需检查的系统库（如Form Templates、Site Pages），减少遍历范围：

$libraries = Get-PnPList -Filter "BaseType eq 1 and Title ne 'Form Templates' and Title ne 'Site Pages'"

5. 利用权限继承避免重复检查 #

检查资源的HasUniqueRoleAssignments属性，若为$false说明继承父级权限，直接复用父级的共享数判断结果，无需重复查询子资源：

$folder = Get-PnPFolder -Url $folderUrl
if (-not $folder.HasUniqueRoleAssignments) {
    # 继承父文件夹的共享状态，跳过检查
    continue
}

6. 分页处理大量数据 #

针对数千条文档的库，使用-PageSize分批拉取数据，避免一次性加载过多数据导致内存溢出：

Get-PnPListItem -List $library -Fields "ID", "ServerRelativeUrl" -PageSize 500

7. 复用PnP上下文 #

单个站点内仅初始化一次PnP上下文，避免频繁创建/销毁上下文的开销：

Connect-PnPOnline -Url $siteUrl -Interactive
$web = Get-PnPWeb
# 该站点下的所有库、文档操作均复用此上下文

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