Microsoft SharePoint: New Embedded Admin role impact

Microsoft SharePoint Embedded, currently in Public Preview, is an API-only solution empowering app developers to leverage the file and document storage in Microsoft 365 to create line-of-business or multitenant applications. Microsoft Loop is an example of a SharePoint Embedded application.

We are introducing the SharePoint Embedded Administrator role, which will have the capability to manage various aspects of SharePoint Embedded Applications and containers. This role will be available in Microsoft 365 admin center. With the introduction of this new role, Global Administrator can continue to create and manage SharePoint Embedded applications. However, as of mid-March 2024, the SharePoint admin role will lose the ability to execute SharePoint Embedded application and container-specific cmdlets (outlined below) as we roll-out the new role integration. After the rollout, only Global Administrators or SharePoint Embedded Administrators will be authorized to execute such cmdlets. Please track this document for the announcement of availability of the new SharePoint Embedded Administrator role in the Microsoft admin center. 

When this will happen:

Public Preview: We will begin rolling out early March 2024 and expect to complete by late March 2024.

Standard Release: We will begin rolling out mid-April 2024 and expect to complete by early May 2024.

How this will affect your organization:

Tenants creating SharePoint Embedded Applications

Admins who want to create a new containertype through PowerShell cmdlets should be assigned the Global Administrator or the SharePoint Embedded Administrator to be able to execute all the available SharePoint Embedded developer admin cmdlets such as.

  • New-SPOContainerType 
  • Get-SPOContainerType
  • Set-SPOContainerType 

Tenants Registering SharePoint Embedded Applications for use

Admins who want to run the VS code extension to create SharePoint Embedded ContainerTypes should also be assigned the Global Administrator or the SharePoint Embedded Administrator role.

Admins who want to manage containers created on their tenants should be assigned the Global Administrator or the SharePoint Embedded Administrator to run the PowerShell execute all SharePoint Embedded consuming tenant admin cmdlets.

  • Get-SPOApplication
  • Set-SPOApplication (Future)
  • Get-SPOContainer
  • Set -SPOContainer
  • Remove-SPOContainer
  • Get-SPODeletedContainer
  • Restore-SPODeletedContainer
  • Remove-SPODeletedContainer

What you need to do to prepare:

Please assign the existing Global Admin role or the new SharePoint Embedded Admin role (available early March) in the Microsoft 365 admin center to create or manage SharePoint Embedded applications.

You may want to notify your users about this change and update any relevant documentation as appropriate.

Message ID: MC718551


No comments yet

Leave a Reply


I've been working with Microsoft Technologies over the last ten years, mainly focused on creating collaboration and productivity solutions that drive the adoption of Microsoft Modern Workplace.

%d bloggers like this: