如何通过PowerShell为脱离父站点的SharePoint库分配权限？

准备工作 #

• 安装Microsoft.Online.SharePoint.PowerShell模块（或直接使用SharePoint Online Management Shell）
• 需持有全局管理员/SharePoint管理员权限，否则无法操作独立库的权限体系

操作步骤 #

1. 连接到SharePoint租户 #

打开带管理员权限的PowerShell窗口，执行以下命令连接你的租户：

Connect-SPOService -Url https://<你的租户名>-admin.sharepoint.com

将<你的租户名>替换为实际租户标识，比如contoso。

2. 定位目标文档库 #

通过库的完整URL获取对应的List对象，命令如下：

# 替换为你的独立库完整URL
$libraryUrl = "https://contoso.sharepoint.com/sites/Marketing/Documents/IsolatedLib"
# 自动匹配库所属的站点URL
$site = Get-SPOSite -Limit All | Where-Object { $libraryUrl.StartsWith($_.Url) }
$webUrl = $site.Url
# 提取库的相对路径并获取List实例
$listRelativePath = $libraryUrl.Replace($webUrl, "")
$list = Get-SPOList -WebUrl $webUrl -Identity $listRelativePath

3. 给自己分配完全控制权限 #

替换成你的登录邮箱，执行命令完成权限分配：

$yourLogin = "mike@contoso.com"
# 获取完全控制权限角色
$fullControlRole = Get-SPORoleDefinition -WebUrl $webUrl -Identity "Full Control"

# 先检查已有权限，避免重复操作
$currentPerms = Get-SPOUserPermission -List $list -User $yourLogin -ErrorAction SilentlyContinue
if (!$currentPerms) {
    Set-SPOUserPermission -List $list -User $yourLogin -AddRole $fullControlRole.Name
    Write-Host "权限分配成功，现在可正常访问该库"
} else {
    Write-Host "你已拥有该库的权限"
}

4. 验证权限生效 #

执行以下命令确认权限是否成功添加：

Get-SPOUserPermission -List $list -User $yourLogin

返回结果中显示Full Control角色即表示权限生效，此时可访问库并进行文件迁移操作。

注意事项 #

• 若库所属站点已被删除，需先恢复站点再执行上述操作
• 文件迁移完成后，建议及时移除自身权限，遵循最小权限原则

内容的提问来源于stack exchange，提问作者Mike E.