Get-SPOSite

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]

Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [-ArchiveStatus <String>]
   [<CommonParameters>]

Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<CommonParameters>]

Description

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

The Get-SPOSite cmdlet retrieves and returns properties of all site collections that match the given criteria.

With version 5361 of the SharePoint Online Management Shell, you may experience the following:

Additional site collections are now displayed. For example, all group and video sites along with team sites will be displayed.

The Detailed parameter has been deprecated. It will continue to work with earlier versions

You need to be a SharePoint Online administrator and be a site collection administrator to run the cmdlet.

For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at Intro to SharePoint Online Management Shell.

Examples

-----------------------EXAMPLE 1-----------------------------

Get-SPOSite

Example 1 returns all site collections.

-----------------------EXAMPLE 2-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com

Example 2 lists the site collection with detailed properties.

-----------------------EXAMPLE 3-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

Example 3 Updates status on if the non owners of a site collection can share the site collection (does not set this value).

-----------------------EXAMPLE 4-----------------------------

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

This example enumerates Group Site Collections in a tenant.

-----------------------EXAMPLE 5-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

This example gets quota details for a Group Site.

-----------------------EXAMPLE 6-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

This example returns the InformationSegments associated with the site. It is applicable for tenants who have enabled Microsoft 365 Information barriers capability. Read Learn about information barriers to understand Information barriers in SharePoint Online.

Note: This property is available only in SharePoint Online Management Shell Version 16.0.19927.12000 or later.

-----------------------EXAMPLE 7-----------------------------

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

This example uses server side filtering to return sites matching 18.

-----------------------EXAMPLE 8-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

This example uses client-side filtering to return a list of sites connected to Microsoft Teams.

-----------------------EXAMPLE 9-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

This example uses client-side filtering to return a list of sites connected to a Microsoft Teams Private or Shared channel.

-----------------------EXAMPLE 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

This example uses server-side filtering to return all sites that have an associated Microsoft 365 Group.

-----------------------EXAMPLE 11-----------------------------

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

This example retrieves all sites filtering by the specified owner using a variable.

Parameters

-ArchiveStatus

-Detailed

-DisableSharingForNonOwnersStatus

-Filter

-GroupIdDefined

-Identity

-IncludePersonalSite

-Limit

-Template

Inputs

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Outputs

System.Object