Skip to main content

spe containertype add

Creates a new Container Type for your app


m365 spe containertype add [options]


-n, --name <name>

Container type name.

--applicationId <applicationId>

Application ID of the Microsoft Entra ID app that will be the owner of the Container Type.


Specify if the Container Type should be a trial.

--azureSubscriptionId [azureSubscriptionId]

Azure Subscription Id. Required unless the trial option was specified.

--resourceGroup [resourceGroup]

Azure Resource group for billing. Required unless the trial option was specified.

--region [region]

Region. Required unless the trial option was specified.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.


Runs command with verbose logging.


Runs command with debug logging.



You can only create one Trial Container per tenant, a single application registration can only contain one Container and a tenant can contain a maximum of five Containers in total.


Adds a new trial Container Type

m365 spe containertype add --name 'trial container' --applicationId '1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac' --trial

Adds a new Container Type using a standard Container Type.

m365 spe containertype add --name 'standard container' --applicationId '1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac' --azureSubscriptionId 'f08575e2-36c4-407f-a891-eabae23f66bc' --region 'West Europe' --resourceGroup 'Standard group'


"AzureSubscriptionId": "f08575e2-36c4-407f-a891-eabae23f66bc",
"ContainerTypeId": "c33cfee5-c9b6-0a2a-02ee-060693a57f37",
"CreationDate": "3/11/2024 2:38:56 PM",
"DisplayName": "standard container",
"ExpiryDate": null,
"IsBillingProfileRequired": true,
"OwningAppId": "1b3b8660-9a44-4a7c-9c02-657f3ff5d5ac",
"OwningTenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
"Region": "West Europe",
"ResourceGroup": "Standard group",
"SPContainerTypeBillingClassification": "Standard"

More information

In SharePoint Embedded, all files and documents are stored in Containers, and each Container is identified by a Container Type.

Container Type is a property stamped on every Container instance. Each Container Type is owned by one Application, and each Application can own only one Container Type.

The primary function of a Container Type is to manage the application workload that can access the Containers. Container Type defines the access permissions an Application has towards all Containers of that type, including create, read, write, delete containers; manage container permissions, etc.

More information about SharePoint Embedded and the limits can be found at the following location: SharePoint Embedded