Get-SPOContainer

Module:

Microsoft.Online.SharePoint.PowerShell

Applies to:

SharePoint Online

Returns one or more Containers in a SharePoint Embedded application.

Syntax

Get-SPOContainer
   [-OwningApplicationId <OwningApplicationId>]
   [<CommonParameters>]

Get-SPOContainer
   [-OwningApplicationId <OwningApplicationId>]
   [-Paged]

Get-SPOContainer
   [-OwningApplicationId <OwningApplicationId>]
   [-Paged]
   [-PagingToken <Token String>]

Get-SPOContainer
   [-OwningApplicationId <OwningApplicationId>]
   [[-Identity] <ContainerId>]

Get-SPOContainer
   [-OwningApplicationId <OwningApplicationId>]
   [[-Identity] <ContainerSiteURL>]

Description

The Get-SPOContainer cmdlet retrieves and returns a list of Containers and details of an individual Container created under a SharePoint Embedded application. This command is available only in SharePoint Online Management Shell version 16.0.24211.12000 or higher to run this cmdlet.

You must be a SharePoint Online Administrator or Global Administrator to run this cmdlet.

Note

Containers in the Recycle Bin will not be retrieved by using the Get-SPOContainer cmdlet. The OwningApplicationId for Microsoft Loop is a187e399-0c36-4b98-8f04-1edc167a0996. The OwningApplicationId for Microsoft Designer is 5e2795e3-ce8c-4cfb-b302-35fe5cd01597.

Examples

Example 1

Get-SPOContainer -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 | FT

Example 1 returns a tabular list of Containers created under the SharePoint Embedded application with the OwningApplicationId of 423poi45-jikl-9bnm-b302-1234ghy56789.

To retrieve Containers for the Microsoft Loop app, use OwningApplicationId: a187e399-0c36-4b98-8f04-1edc167a0996.

To retrieve Containers for the Microsoft Designer app, use OwningApplicationId: 5e2795e3-ce8c-4cfb-b302-35fe5cd01597.

Example 2

Get-SPOContainer -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -Identity b66f5b2e-4cbd-4754-9ad3-8291c2c81ade

Example 2 returns the detailed properties of the Container with associated ContainerId.

Example 3

Get-SPOContainer -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -Identity https://contoso.sharepoint.com/storagecontainers/CSP_b66f5b2e-4cbd-4754-9ad3-8291c2c81ade

Example 3 gives the detailed properties of a Container using the site URL of a Container.

Example 4

Get-SPOContainer -OwningApplicationId <OwningApplicationId> -Identity <ContainerId> -Paged | FT

Example 4 uses the -Paged command to retrieve a paging token.

Example 5

Get-SPOContainer -OwningApplicationId <OwningApplicationId> -Identity <ContainerId> -Paged -PagingToken <Token String> | FT

Example 5 uses the PagingToken to view more Containers.

Parameters

-Identity

Use this parameter to specify the Container in the given OwningApplicationId.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-OwningApplicationId

This parameter specifies the ID of the SharePoint Embedded application. Use the Get-SPOApplication command to retrieve the OwningApplicationId.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Paged

This parameter can be used when there are more than 200 Containers in a given SharePoint repository services application. Using -Paged will provide a <Paging Token> that will display the next 200 Containers.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-PagingToken

Use this parameter to provide the <Paging Token> provided to view the remaining Containers as shown in Example 5. If there are no more Containers to display, the commandlet output will return the message End of Containers view. Otherwise, use the given <Paging Token> to retrieve the next batch of up to 200 Containers.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

Related Links

• Getting started with SharePoint Online Management Shell