如何使用PnP Core SDK向指定用户组共享指定文件夹及子文件夹？

要实现给单个或部分文件夹分配用户组权限，核心是操作文档库中对应文件夹的ListItem对象——因为SharePoint的文档库本质是List，文件夹属于List中的特殊ListItem（Folder类型）。具体步骤如下：

1. 获取目标文档库（List） #

先获取你要操作的文档库实例，可通过名称或ID定位：

// 按名称获取文档库
var docLib = await context.Web.Lists.GetByTitleAsync("文档库名称");
// 或按ID获取
// var docLib = await context.Web.Lists.GetByIdAsync(docLibUniqueId);
await context.LoadAsync(docLib);
await context.ExecuteQueryAsync();

2. 获取目标文件夹对象 #

通过文档库获取指定路径的文件夹，路径为相对于文档库的相对路径：

// 获取根目录下的"目标文件夹"
var folder = await docLib.RootFolder.Folders.GetByPathAsync("目标文件夹");
await context.LoadAsync(folder);
await context.ExecuteQueryAsync();

// 如果是多层子文件夹，路径用"/"分隔，比如"父文件夹/子文件夹"
// var folder = await docLib.RootFolder.Folders.GetByPathAsync("父文件夹/子文件夹");

也可直接通过ListItem查询获取（更适配后续权限操作）：

// 通过文件夹名称查询对应的ListItem
var folderItem = await docLib.Items.Where(i => i.FileSystemObjectType == FileSystemObjectType.Folder && i.Title == "目标文件夹").FirstOrDefaultAsync();
await context.LoadAsync(folderItem);
await context.ExecuteQueryAsync();

3. 打破文件夹的权限继承 #

调用文件夹ListItem的BreakRoleInheritanceAsync方法，参数按需设置：

• copyRoleAssignments：设为false表示不继承父项权限；设为true会先复制父项权限再打破继承
• clearSubscopes：设为true会让该文件夹下所有子文件夹/文件同步使用此权限设置（可选）

// 打破继承，不复制父项权限（仅保留系统默认权限）
await folderItem.BreakRoleInheritanceAsync(false, false);
await context.ExecuteQueryAsync();

4. 给文件夹分配用户组权限 #

用你已创建的newGroup和roleDefinition，调用文件夹ListItem的权限分配方法：

// 给目标文件夹分配用户组权限
await folderItem.AddRoleDefinitionAsync(newGroup.Id, roleDefinition);
await context.ExecuteQueryAsync();

额外建议 #

• Azure安全组的处理：无需创建SharePoint组，直接通过Azure AD安全组的邮箱或Object ID获取组对象，再分配权限：

  // 通过邮箱获取Azure AD安全组
  var azureGroup = await context.Web.SiteUsers.GetByEmailAsync("安全组邮箱@domain.com");
  // 或通过Object ID获取
  // var azureGroup = await context.Web.SiteUsers.GetByIdAsync("Azure组Object ID");
  await context.LoadAsync(azureGroup);
  await context.ExecuteQueryAsync();
  
  // 给文件夹分配Azure组权限
  await folderItem.AddRoleDefinitionAsync(azureGroup.Id, roleDefinition);
  

• 权限继承细节：若需让子文件夹/文件同步权限，打破继承时将clearSubscopes设为true；若要保留子项原有权限，设为false。
• 批量处理：给多个文件夹分配权限时，遍历文件夹列表重复上述步骤即可。
• 验证权限：操作完成后可加载folderItem.RoleAssignments查看权限分配结果，确保配置正确。

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