New-SPOContainerType
This cmdlet creates a new container type of standard or trial status. The standard container type can be created with the regular billing structure or direct to customer billing structure.
Syntax
New-SPOContainerType
[-ContainerTypeName] <String>
-OwningApplicationId <Guid>
[-ApplicationRedirectUrl <String>]
[-TrialContainerType]
[-IsPassThroughBilling]
[-IsGovernableByAdmin <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
This cmdlet creates a new standard or trial container type. 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 trial container type does not have a billing profile. In case of regular billing, the next step after creation is the addition of a billing profile using the 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. -TrialContainerType when used creates a trial container type that has a validity of 30 days.
You must be a SharePoint Embedded Administrator to run this cmdlet.
Examples
Example 1
New-SPOContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4afIn Example 1, the cmdlet creates a new regular billed container type ContosoLegal.
Example 2
New-SPOContainerType -IsPassThroughBilling -ContainerTypeName ContosoLegal -OwningApplicationId a735e4afIn Example 2, the cmdlet creates a direct to customer billed container type ContosoLegal.
Example 3
New-SPOContainerType -TrialContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4afIn Example 3, the cmdlet creates a trial container type, ContosoLegal, valid for 30 days.
Example 4
New-SPOContainerType -ContainerTypeName ContosoLegal -OwningApplicationId a735e4af -GovernableByAdmin $falseIn Example 4, the cmdlet creates a standard container type, ContosoLegal that has opted out of management through Microsoft-enabled administrator platforms.
Parameters
-ApplicationRedirectUrl
This parameter specifies the url of that the application should be redirected to.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-ContainerTypeName
This parameter names your container type for your SharePoint Embedded application.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-GovernableByAdmin
Using -GovernableByAdmin, you can decide whether consuming tenant administrators of the application should be provided management capabilities on Microsoft-enabled administrator support, through SharePoint admin center and PowerShell. When not passed, the value is set to True. When set to False, the consuming tenant administrator can perform only read-only actions on containers of the container type, in both SharePoint admin center and PowerShell.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-IsPassThroughBilling
This parameter is used to create a direct to customer billed container type.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-OwningApplicationId
This parameter specifies the ID of the SharePoint Embedded application.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-TrialContainerType
This parameter is used to specify that the cmdlet is used to create a trial container type and thereby the billing profile need not be provided.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |