如何无需点击SharePoint同步按钮自动同步用户有权限的文档到本地OneDrive

核心逻辑 #

通过Microsoft Graph获取用户权限范围内的站点列表，结合OneDrive官方的odopen协议触发静默同步，全程无用户交互，无需手动收集站点信息，自动适配不同用户的权限差异。 #

前置要求 #

• 所有用户设备的OneDrive同步客户端版本≥21.073（Office 365订阅默认预装，可通过租户更新策略统一升级）
• 允许用户设备运行PowerShell脚本，可通过Intune/域组策略统一配置执行权限
• 脚本运行时需要的Graph基础访问权限，可在租户后台提前做管理员同意，免除用户授权弹窗

实现步骤 #

1. 获取当前用户有权限的所有站点/子站点 #

脚本以当前登录用户身份调用Microsoft Graph，天然只会返回用户有权限访问的站点，无需额外做权限校验，无需提前收集站点信息：

# 连接Microsoft Graph，申请站点、文件读取权限
Connect-MgGraph -Scopes "Sites.Read.All", "Files.Read.All"

# 拉取所有根站点
$rootSites = Get-MgSite -All -Filter "siteCollection/root ne null" | Select-Object Id, WebUrl, DisplayName
# 拉取所有子站点
$subSites = @()
foreach ($root in $rootSites) {
    $subSites += Get-MgSiteSubsite -SiteId $root.Id -All | Select-Object Id, WebUrl, DisplayName
}
# 合并所有可访问站点列表
$allAccessibleSites = $rootSites + $subSites

2. 静默触发站点文档库同步 #

用OneDrive官方支持的odopen://协议添加同步任务，完全等价于用户手动点击「同步」按钮，无需用户确认：

# 本地缓存已同步站点ID，避免重复添加
$cachePath = "$env:APPDATA\OneDriveSyncCache.txt"
$syncedSites = if (Test-Path $cachePath) { Get-Content $cachePath } else { @() }

foreach ($site in $allAccessibleSites) {
    # 跳过已同步的站点
    if ($syncedSites -contains $site.Id) { continue }

    # 获取站点默认共享文档库ID，若需同步其他库可修改过滤条件
    $defaultDrive = Get-MgSiteDrive -SiteId $site.Id -Filter "name eq 'Shared Documents'"
    if (-not $defaultDrive) { continue }

    # 构造同步链接
    $syncParam = @(
        "odopen://sync?",
        "siteId=$($site.Id)",
        "webUrl=$([Uri]::EscapeDataString($site.WebUrl))",
        "listId=$($defaultDrive.Id)",
        "userEmail=$((Get-MgUser -UserId (Get-MgContext).Account).Mail)"
    ) -join ""

    # 触发同步
    Start-Process $syncParam
    # 记录到缓存
    $site.Id | Out-File $cachePath -Append
}

3. 批量部署 #

将上述脚本打包为登录触发的任务，通过Intune或者域组策略推送给所有用户即可，用户每次登录时自动校验新增的权限站点，自动同步。 #

常见适配调整 #

• 若需要自定义本地同步路径，可在odopen参数中添加path=自定义路径参数
• 若需要排除特定站点，在拉取站点列表后加过滤逻辑即可
• 若需要同步子站点下的特定库，调整Get-MgSiteDrive的查询条件即可

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