SharePoint Online 站點模板中許可權的設置
- 2021 年 1 月 28 日
- 筆記
- sharepoint online
SharePoint Online可以使用PnP引擎部署站點模板。這個模板的功能非常強大，除了可以訂製主題，外觀以外，還可以生成list並導入數據，生成文檔庫，導入文檔等等。
今天重點說一下其中的站點許可權部分。目前最新的Schema版本是202002，完整版可以參考 //github.com/pnp/PnP-Provisioning-Schema/blob/master/OfficeDevPnP.ProvisioningSchema/ProvisioningSchema-2020-02.xsd。另外還有一個非常詳細的樣例文件，鏈接是：//github.com/pnp/PnP-Provisioning-Schema/blob/master/Samples/ProvisioningSchema-2020-02-FullSample-01.xml。
1 <pnp:Security BreakRoleInheritance="true" 2 CopyRoleAssignments="false" 3 ClearSubscopes="true" 4 AssociatedGroups="Test Value" 5 AssociatedMemberGroup="{parameter:AssociatedMemberGroup}" 6 AssociatedOwnerGroup="{parameter:AssociatedOwnerGroup}" 7 AssociatedVisitorGroup="{parameter:AssociatedVisitorGroup}" 8 RemoveExistingUniqueRoleAssignments="true" 9 ResetRoleInheritance="true" > 10 <pnp:AdditionalAdministrators ClearExistingItems="false"> 11 <pnp:User Name="[email protected]"/> 12 <pnp:User Name="U_SHAREPOINT_ADMINS"/> 13 </pnp:AdditionalAdministrators> 14 <pnp:AdditionalOwners ClearExistingItems="true"> 15 <pnp:User Name="[email protected]"/> 16 <pnp:User Name="U_SHAREPOINT_ADMINS"/> 17 </pnp:AdditionalOwners> 18 <pnp:AdditionalMembers> 19 <pnp:User Name="[email protected]"/> 20 <pnp:User Name="U_SHAREPOINT_ADMINS"/> 21 </pnp:AdditionalMembers> 22 <pnp:AdditionalVisitors> 23 <pnp:User Name="[email protected]"/> 24 <pnp:User Name="U_SHAREPOINT_ADMINS"/> 25 </pnp:AdditionalVisitors> 26 <pnp:SiteGroups> 27 <pnp:SiteGroup 28 Title="Power Users" 29 Description="Group of Power Users" 30 Owner="[email protected]"> 31 <pnp:Members ClearExistingItems="true"> 32 <pnp:User Name="[email protected]" /> 33 <pnp:User Name="[email protected]" /> 34 <pnp:User Name="[email protected]" /> 35 </pnp:Members> 36 </pnp:SiteGroup> 37 </pnp:SiteGroups> 38 <pnp:Permissions> 39 <pnp:RoleDefinitions> 40 <pnp:RoleDefinition Name="Manage List Items" Description="Allows a user to manage list items"> 41 <pnp:Permissions> 42 <pnp:Permission>ViewListItems</pnp:Permission> 43 <pnp:Permission>AddListItems</pnp:Permission> 44 <pnp:Permission>EditListItems</pnp:Permission> 45 <pnp:Permission>DeleteListItems</pnp:Permission> 46 </pnp:Permissions> 47 </pnp:RoleDefinition> 48 </pnp:RoleDefinitions> 49 <pnp:RoleAssignments> 50 <pnp:RoleAssignment Principal="Power Users" RoleDefinition="Manage List Items"/> 51 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="Manage List Items"/> 52 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="Full Control"/> 53 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="Full Control" Remove="true"/> 54 </pnp:RoleAssignments> 55 </pnp:Permissions> 56 </pnp:Security>
我們從中截取<pnp:Security>部分來看看如何自定義站點許可權。
程式碼第10行到第13行，可以指定site collection的管理員。
14行到17行，指定站點的管理員，要注意的是這個和site collection管理員是不一樣的。
18-25行，指定站點的成員和訪問者。
26-37行創建一個新的SharePoint Group，並且添加用戶和其他組到這個新組之中。
39-48行創建的新的permission level.
49-54行指定許可權到user或group。指定Group的時候，要使用「c:0t.c|tenant|{groupID}」作為Principal的參數，另外特別需要注意的是，Full Control，Edit，Read許可權像樣例填寫是不能正確應用的，需要分別改成Administrator，Editor和Reader。
另外可以針對列表和文檔庫單獨設置許可權。在<pnp:ListInstance>下面，可以找到如下單獨的許可權設置部分。
1 <pnp:Security> 2 <pnp:BreakRoleInheritance CopyRoleAssignments="true" ClearSubscopes="true"> 3 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="Full Control"/> 4 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="Edit"/> 5 <pnp:RoleAssignment Principal="[email protected]" RoleDefinition="View Only"/> 6 </pnp:BreakRoleInheritance> 7 </pnp:Security>
在設置好模板文件後，可以使用powershell 進行測試
Apply-PnPProvisioningTemplate -Path template.xml #部署全部模板
or
Apply-PnPProvisioningTemplate -Path template.xml -Handlers SiteSecurity #只部署<pnp:Security>部分
