如何查找SharePoint文档库失效链接，解决Invoke-WebRequest返回200异常

根本原因 #

你通过Connect-PnPOnline -WebLogin获取的身份凭证仅在PnP PowerShell模块内部生效，Invoke-WebRequest不会自动复用该身份，匿名请求访问SharePoint资源时会被重定向到登录页，而登录页本身返回200状态码，因此无法判断目标链接的真实有效性。

解决方案 #

方案1：复用PnP模块的访问令牌（推荐，适用于同租户内的SharePoint链接） #

从已完成身份验证的PnP上下文中提取访问令牌，手动添加到Invoke-WebRequest的请求头中，同时禁用自动重定向避免跳转到登录页：

# 提取当前PnP会话的SharePoint访问令牌
$accessToken = Get-PnPAccessToken
$headers = @{
    Authorization = "Bearer $accessToken"
}

# 读取.url文件内容并解析目标链接
$text = Get-PnPFile -Url $Item.FileRef -AsString
$link_url = ($text | Select-String -Pattern 'URL=(.*)').Matches.Groups[1].Value

$isLinkValid = $false
try {
    # 禁用自动重定向，防止跳转到登录页掩盖真实状态码
    $response = Invoke-WebRequest -Uri $link_url -Headers $headers -DisableKeepAlive -UseBasicParsing -MaximumRedirection 0 -ErrorAction Stop
    if ($response.StatusCode -ge 200 -and $response.StatusCode -lt 300) {
        $isLinkValid = $true
    }
} catch {
    # 非2xx状态码会进入异常捕获，可根据状态码判断失效原因
    $errorStatusCode = $_.Exception.Response.StatusCode.value__
    # 示例：仅将404判定为链接失效，401/403属于权限问题不属于链接失效可自行调整规则
    if ($errorStatusCode -eq 404) {
        $isLinkValid = $false
    }
}

方案2：针对外部非SharePoint链接的处理 #

如果待检测的.url文件包含租户外的外部链接，不需要携带SharePoint访问令牌，直接发起请求即可，部分网站会拦截无UA的请求，可手动添加User-Agent请求头避免被拦截：

$headers = @{
    "User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}
$response = Invoke-WebRequest -Uri $externalLinkUrl -Headers $headers -UseBasicParsing

额外校验规则 #

部分SharePoint站点配置了自定义404页面，这类页面也会返回200状态码，可额外增加返回内容校验：

• 判断返回的Content-Type是否符合目标资源类型（比如Word文档对应application/vnd.openxmlformats-officedocument.wordprocessingml.document等）
• 检查返回内容中是否包含“未找到文件”“资源不存在”等失效提示关键词

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