Get-SPOSite

傳回一或多個網站集合。

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]
Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<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.

Get-SPOSite Cmdlet 會擷取並傳回所有符合指定條件之網站集合的屬性。

使用 SharePoint Online 管理命令介面版本 5361 可能會遇到下列情況︰

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

注意

若是使用 Get-SPOSite Cmdlet,將不會擷取資源回收筒內的網站集合。

您必須是 SharePoint Online 管理員或全域系統管理員和網站集合系統管理員,才能執行 Cmdlet。

如需有關適用於 SharePoint Online 的 Windows PowerShell 權限和最新資訊,請參閱位於 SharePoint Online Management Shell 簡介的線上文件。

注意

If Site Collection Storage Management is enabled for the tenant, you will not be able to set quota and will have a generic error returned. To workaround this issue, set the site collection storage management to "manual" temporarily, set your quotas and then set the site collection storage management setting back to its original setting.

注意

如果提供 Limit 或 Filter 參數,則將不會填入下列網站集合屬性,而且可能包含預設值:AllowDownloadingNonWebViewableFiles、 AllowEditing、AllowSelfServiceUpgrade、AnonymousLinkExpirationInDays、ConditionalAccessPolicy、DefaultLinkPermission、DefaultLinkToExistingAccess、DefaultSharingLinkType、DenyAddAndCustomizePages、DisableCompanyWideSharingLinks、ExternalUserExpirationInDays、InformationSegment、LimitedAccessFileType、 OverrideTenantAnonymousLinkExpirationPolicy、OverrideTenantExternalUserExpirationPolicy、PWAEnabled、SandboxedCodeActivationCapability、SensitivityLabel、SharingAllowedDomainList、SharingBlockedDomainList、SharingCapability、SharingDomainRestrictionMode。

範例

-----------------------範例 1-----------------------------

Get-SPOSite

範例 1 會傳回所有網站集合。

-----------------------範例 2-----------------------------

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

範例 2 會列出網站集合及其詳細屬性。

-----------------------範例 3-----------------------------

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

範例 3 會在網站集合的非擁有者可共用網站集合的情況下 (未設定此值),更新狀態。

-----------------------範例 4-----------------------------

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

此範例會列舉租用戶中的群組網站集合。

-----------------------範例 5-----------------------------

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

此範例會取得群組網站的配額詳細資料。

-----------------------範例 6-----------------------------

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

此範例會傳回與網站相關聯的 InformationSegments。 適用於已啟用 Microsoft 365 資訊屏障功能的租用戶。 閱讀 瞭解資訊屏障 以瞭解 SharePoint Online 中的資訊屏障。

注意:此屬性僅適用于 SharePoint Online 管理命令介面 16.0.19927.12000 版或更新版本。

-----------------------範例 7-----------------------------

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

此範例會使用伺服器端篩選來傳回符合 18 的網站。

-----------------------範例 8-----------------------------

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

此範例會使用用戶端篩選來傳回已連線至 Microsoft Teams 的網站清單。

-----------------------範例 9-----------------------------

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

此範例會使用用戶端篩選來傳回已連線至 Microsoft Teams 私人或共用頻道的網站清單。

-----------------------範例 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

此範例會使用伺服器端篩選來傳回具有相關聯 Microsoft 365 群組的所有網站。

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

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

此範例會使用變數,擷取由指定擁有者篩選的所有網站。

參數

-Detailed

Use this parameter to get additional property information on a site collection. You will notice a slower response time when the Detailed parameter is used.

會傳回下列屬性:

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

傳回網站原則儲存的值。

  • SharingCapability

傳回有效的存取層級,即網站原則結合租用戶原則。

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

-DisableSharingForNonOwnersStatus

這個參數可防止非擁有者共用。

注意

只能在 SharePoint Online 管理命令介面 16.0.4613.1211 版或更新版本中使用此參數。 DisableSharingForNonOwnersStatus 不是保存的設定,而是網站集合狀態的分析。 這樣做的目的是要取得此設定,而且不保證傳回的其他設定正確無誤。 若要取得其他設定和值,請使用不含此參數的Get-SPOSite,以確保所有專案都正確顯示。

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

-Filter

指定要套用的伺服器端篩選指令碼區塊。 此類型必須是有效的篩選名稱,值格式必須為 { PropertyName <operator> "filterValue"}。 有效運算子如下:-eq、-ne、-like、-notlike。 目前,您可以根據這些屬性進行篩選:Owner、Template (如果這是篩選中的唯一屬性,則可用來篩選)、LockState、Url。 不支援使用 -or 運算子來包含其他篩選。

注意:運算子值為區分大小寫。

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

-GroupIdDefined

當值設定為 $true 時,篩選網站清單會傳回具有群組識別碼的網站 (例如:已連線至 Microsoft 365 群組的網站)。 當值為 $false,篩選網站清單只會傳回沒有群組識別碼的網站。

值為 $true$false未定義。 根據預設,未定義 值表示不會套用篩選。

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

-Identity

指定網站集合的 URL。

Type:SpoSitePipeBind
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-IncludePersonalSite

值設定為 $true 時,請顯示個人站台。

The values are $true and $false. By default, the value is $false which means no personal sites will be returned.

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

-Limit

指定要傳回的網站集合數上限。 此數量不受限制。 若要擷取所有的網站集合,請使用 ALL。 預設值為 200。 如果提供此參數,則不會填入某些網站集合屬性,且可能包含預設值。

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

-Template

顯示特定範本的網站。 例如,STS、STS#0、STS#1、STS#3、GROUP#0、SRCHCEN#0 或 SITEPAGEPUBLISHING#0。

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

輸入

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

輸出

系統.物件