PowerShell检测SharePoint页面URL时foreach循环不执行问题咨询

问题根因 #

核心触发点如下： #

• 页面库名称不匹配：经典SharePoint站点页面库默认名称为Pages，现代站点默认页面库名称为站点页面（英文环境为Site Pages），库名填写错误会导致查询返回空集合，自然不会进入foreach循环
• CSOM对象未按需加载：SharePoint CSOM采用按需加载模型，脚本仅加载了列表项的基础属性，未显式加载列表项关联的File对象，后续文件操作会静默失败
• 文件读取调用规则错误：OpenBinary()是CSOM异步接口，直接调用无法获取返回值，需要搭配上下文查询执行才能拿到文件二进制内容
• 编码规则错误：使用ASCII编码解析现代页面会出现乱码，导致URL匹配失效

修正后脚本 #

#加载SharePoint CSOM程序集
Add-Type -Path "C:\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

#站点配置
$site = 'https://contoso.sharepoint.com/sites/contoso'
$urlToFind = "https://google.com"
# 注意此处修改为你实际的页面库名称，现代站点优先尝试"站点页面"或"Site Pages"
$pageLibraryName = "Site Pages"

#认证配置
$admin = 'SampleUsername'
$Password = "SamplePassword"
$SecurePassword = ConvertTo-SecureString -String $Password -AsPlainText -Force

#初始化上下文
$context = New-Object Microsoft.SharePoint.Client.ClientContext($site)
$credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($admin , $SecurePassword)
$context.Credentials = $credentials

#获取页面库
$list = $context.Web.Lists.GetByTitle($pageLibraryName)
$context.Load($list)
$context.ExecuteQuery()

#查询所有页面项，显式加载关联的File对象
$query = [Microsoft.SharePoint.Client.CamlQuery]::CreateAllItemsQuery()
$Items = $list.GetItems($query)
$context.Load($Items, $_.Include($_.File, $_.FieldValues))
$context.ExecuteQuery()

# 先输出条目数确认是否拿到页面
Write-Host "查询到的页面总数：" $Items.Count

foreach($item in $Items)
{
    Write-Host "`n*** 正在处理页面 *** "$item.File.ServerRelativeUrl
    # 读取文件二进制流
    $fileStream = $item.File.OpenBinaryStream()
    $context.ExecuteQuery()
    # 使用UTF-8编码解析内容
    $reader = New-Object System.IO.StreamReader($fileStream.Value, [System.Text.Encoding]::UTF8)
    $pageContent = $reader.ReadToEnd()
    $reader.Close()

    if($pageContent -match [regex]::Escape($urlToFind))
    {
        Write-Warning "该页面包含目标URL！"
    }
    else {
        Write-Host "未匹配到目标URL"
    }
}

验证步骤 #

1. 先修改$pageLibraryName为你实际的页面库名称，可直接在站点内容中查看库的实际名称
2. 运行脚本后首先查看查询到的页面总数输出，如果为0则确认库名填写错误
3. 如果已经拿到页面数但仍无匹配结果，可临时输出$pageContent验证内容解析是否正常

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