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

此 Cmdlet 包含一個以上的參數集。您可以只使用一個參數集中的參數,但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集。

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

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

現在會顯示其他網站集合。例如,將顯示所有的群組和影片網站以及小組網站。

Detailed 參數已經過時。將繼續搭配較早的版本使用

注意

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

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

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

注意

如果啟用租用戶的「網站集合儲存管理」,則您無法設定配額,且會傳回一般錯誤。若要暫時解決這個問題,請暫時將網站集合儲存管理設定為 [手動]、設定您的配額,然後將網站集合儲存管理設定設回原始設定。

注意

如果提供 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 Management Shell 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

使用此參數可取得網站集合的其他屬性資訊。若是使用 Detailed 參數,回應時間將會明顯變慢。

會傳回下列屬性:

  • 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 版或更新版本中使用此參數。

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 時,請顯示個人站台。

有效值為 $true 和 $false。根據預設,值會是 $false,這表示沒有個人站台會傳回。

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

輸出

系統.物件