Skip to content

Commit c73a1eb

Browse files
committed
adding edits to PR SharePoint#10117
1 parent 65a396c commit c73a1eb

File tree

1 file changed

+21
-14
lines changed

1 file changed

+21
-14
lines changed

docs/embedded/concepts/app-concepts/containertypes.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ ms.localizationpriority: high
99

1010
A container type is a SharePoint Embedded resource that defines the relationship, access privileges, and billing accountability between a SharePoint Embedded application and a set of containers. Also, the container type defines behaviors on the set of containers.
1111

12-
Each container type is strongly coupled with one SharePoint Embedded application, which is referred to as the owning application. The owning application developer is responsible for creating and managing their container types. SharePoint Embedded mandates a 1:1 relationship between owning application and container type.
12+
Each container type is strongly coupled with one SharePoint Embedded application, which is referred to as the owning application. The owning application developer is responsible for creating and managing their container types.
13+
SharePoint Embedded mandates a 1:1 relationship between owning application and container type.
1314

1415
Container type is represented on each container instance as an immutable property (ContainerTypeID) and is used across the entire SharePoint Embedded ecosystem, including:
1516

@@ -20,21 +21,24 @@ Container type is represented on each container instance as an immutable propert
2021

2122
> [!NOTE]
2223
>
23-
> 1. You must specify the purpose of the container type you are creating at creation time. Depending on the purpose, you may or may not need to provide your Azure Subscription ID. A container type set for trial purpose cannot be converted for production; or vice versa.
24-
> 1. You must use the latest version of SharePoint Powershell for container type configurations. For permissions and the most current information about Windows PowerShell for SharePoint Embedded, see the documentation at [Intro to SharePoint Embedded Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell).
24+
> 1. You must specify the purpose of the container type you're creating at creation time. Depending on the purpose, you may or may not need to provide your Azure Subscription ID. A container type set for trial purpose can't be converted for production; or vice versa.
25+
> 1. You must use the latest version of SharePoint PowerShell for container type configurations. For permissions and the most current information about Windows PowerShell for SharePoint Embedded, see the documentation at [Intro to SharePoint Embedded Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell).
2526
2627
## Trial use
2728

28-
A container type can be created for trial/development purposes and isn't linked to any Azure billing profile. This enables developers to explore SharePoint Embedded application development and assess its features for free. In this scenario, the developer tenant is the same as the consuming tenant. Each developer can have only one container type in the trial status in their tenant at a time. The container type is valid for up to 30 days but can be removed at any time within this period. To create a container type for trial purposes, you can:
29+
A container type can be created for trial/development purposes and isn't linked to any Azure billing profile. This enables developers to explore SharePoint Embedded application development and assess its features for free. For trial container types, the developer tenant is the same as the consuming tenant.
30+
Each developer can have only one container type in the trial status in their tenant at a time. The trial container type is valid for up to 30 days but can be removed at any time within this period.
2931

30-
- Use SharePoint Embedded Visual Studio Code Extension to create the container type in just a few steps. The Visual Studio Code extension also registers your container type and creates containers for you.
32+
To create a container type for trial purposes, you can:
33+
34+
- Use SharePoint Embedded Visual Studio Code Extension to create the container type in just a few steps. The Visual Studio Code extension registers your container type and creates containers for you.
3135
- Use SharePoint PowerShell. You must be a SharePoint Embedded Administrator or Global Administrator to run this cmdlet. If you're a SharePoint Administrator, grant yourself the SharePoint Embedded Admin role as well to execute these cmdlets.
3236

3337
```powershell
3438
New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
3539
```
3640

37-
The following restrictions are applied to container type in the trial status:
41+
The following restrictions are applied to trial container types:
3842

3943
- Up to five active containers of the container type can be created.
4044
- Each container has up to 1 GB of storage space.
@@ -44,13 +48,15 @@ The following restrictions are applied to container type in the trial status:
4448

4549
## Standard/Non-trial use
4650

47-
A standard container type, by definition, has a billing profile associated with it and can be either regular billed or direct to consumer billed. A standard container type is created using the [New-SPOContainerType](/powershell/module/sharepoint-online/new-spocontainertype) cmdlet . In case of regular billing, the next step after creation is the addition of a billing profile using the [Add-SPOContainerTypeBilling](/powershell/module/sharepoint-online/add-spocontainertypebilling) cmdlet. With the use of `-IsPassThroughBilling`, you can create a direct to customer billed container type. There is no need to attach a billing profile in case this case. You need the following to create a container type in the standard status:
51+
A standard container type is linked to a billing profile, which can be either regular billing or direct-to-consumer billing. Each developer tenant can create up to five standard container types.
52+
Standard container types are created using the [New-SPOContainerType](/powershell/module/sharepoint-online/new-spocontainertype) cmdlet. For container types with regular billing, create a billing profile using the [Add-SPOContainerTypeBilling](/powershell/module/sharepoint-online/add-spocontainertypebilling) cmdlet. For container types with direct to customer billing, use the flag `-IsPassThroughBilling`. For a direct to customer billed container type, there's no need to attach a billing profile.
53+
54+
You need the following to create a standard container type:
4855

49-
- An Azure subscription and Resource Group must be present in the Azure portal, in case of regular billed.
56+
- An Azure subscription and Resource Group must be present in the Azure portal for regular billing.
5057
- An App registration must be created in Microsoft Entra ID
51-
- Each developer tenant can create up to five container types in the standard status.
5258

53-
To create a regular billed, standard container type, use the following cmdlets:
59+
To create a standard container type with a regular billing profile, use the following cmdlets:
5460

5561
```powershell
5662
New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
@@ -61,7 +67,7 @@ Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscript
6167
```
6268

6369
> [!NOTE]
64-
> The user or admin who will set up a billing relationship for SharePoint Embedded will need to have owner or contributor permissions on the Azure subscription.
70+
> The user or admin who sets up a billing relationship for SharePoint Embedded must have owner or contributor permissions on the Azure subscription.
6571
6672
To create a direct to customer billed, standard container type, use the following cmdlet:
6773

@@ -71,7 +77,7 @@ New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <Strin
7177

7278
## Configuring Container Types
7379

74-
Developer Admin can set selected settings on the SharePoint Embedded container types created by using this PowerShell cmdlet.
80+
The Developer Admin can set selected settings on the SharePoint Embedded container types created by using this PowerShell cmdlet.
7581

7682
This cmdlet allows admins to set [Microsoft 365 content discoverability](../content-experiences/user-experiences-overview.md) and [sharing](../app-concepts/sharing-and-perm.md) settings on container types. The setting applies to all container instances of the container type
7783

@@ -81,7 +87,7 @@ Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb
8187

8288
## Viewing Container Types
8389

84-
Developer Admin can view all the SharePoint Embedded container types created by them on their tenant using this PowerShell cmdlet. This cmdlet retrieves and returns the list of container types created for a SharePoint Embedded Application in the tenant.
90+
The Developer Admin can view all the SharePoint Embedded container types created by them on their tenant using `Get-SPOContainerType`. This cmdlet retrieves and returns the list of container types created for a SharePoint Embedded Application in the tenant.
8591

8692
```powershell
8793
Get-SPOContainerType [<CommonParameters>]
@@ -105,7 +111,8 @@ To create and interact with containers, you must [register](../app-concepts/regi
105111

106112
## Deleting Container Types
107113

108-
Developer admins can delete container types of both trial and standard status. To delete a container type, you must remove all containers of the container type first, including from the deleted container collection. To remove containers, refer to [Consuming Tenant Admin](../admin-exp/consuming-tenant-admin/cta.md). Once all the containers are deleted, Developer admins can delete the container type using the below PowerShell cmdlet.
114+
Developer admins can delete both trial and standard container types. To delete a container type, you must first remove all containers of that container type, including from the deleted container collection. To remove containers, refer to [Consuming Tenant Admin](../admin-exp/consuming-tenant-admin/cta.md).
115+
Once all the containers are deleted, Developer admins can delete the container type using `Remove-SPOContainerType`.
109116

110117
```powershell
111118
Remove-SPOContainerType

0 commit comments

Comments
 (0)