Get-SPOSite

  • 參考
模組:
Microsoft.Online.SharePoint.PowerShell
適用於:
SharePoint Online

傳回一或多個網站集合。

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 管理命令介面 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
Required:False
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
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

指定網站集合的 URL。

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

-IncludePersonalSite

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

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

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

-Limit

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

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

輸入

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

輸出

System.Object