Get-SPOSite
傳回一或多個網站集合。
語法
ParamSet1 (預設值)
Get-SPOSite
[[-Identity] <SpoSitePipeBind>]
[-Limit <String>]
[-Detailed]
[-IsAuthoritative <Boolean>]
[<CommonParameters>]
ParamSet3
Get-SPOSite
[-Identity] <SpoSitePipeBind>
[-DisableSharingForNonOwnersStatus]
[<CommonParameters>]
ParamSet2
Get-SPOSite
[-Filter <String>]
[-Limit <String>]
[-Detailed]
[-Template <String>]
[-IncludePersonalSite <Boolean>]
[-GroupIdDefined <Boolean>]
[-ArchiveStatus <ArchiveStatusFilterType>]
[<CommonParameters>]
Description
此 Cmdlet 包含一個以上的參數集。 您可能只會使用到一個參數集中的參數，而且您無法合併不同參數集中的參數。 如需如何使用參數集的詳細資訊，請參閱 Cmdlet 參數集。
Get-SPOSite Cmdlet 會擷取並傳回所有符合指定條件之網站集合的屬性。
使用 SharePoint Online 管理命令介面版本 5361 可能會遇到下列情況︰
現在顯示其他網站集合。 例如，將顯示所有的群組和視訊網站以及小組網站。
Detailed 參數已經過時。 會繼續使用較早的版本
注意事項
若是使用 Get-SPOSite Cmdlet，將不會擷取資源回收筒內的網站集合。
網站重新導向，例如 變更 SharePoint 網域名稱 之後建立的重新導向，將會使用此 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
此範例會傳回與網站相關聯的 InformationSegment。 適用於已啟用 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 -Filter { IsAuthoritative -eq true }
此範例會使用伺服器端篩選來傳回授權網站 (，也就是將 IsAuthoritative 屬性設定為 true) 的網站。
範例 9
Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}
此範例會使用用戶端篩選來傳回已連線至 Microsoft Teams 的網站清單。
範例 10
Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}
此範例會使用用戶端篩選來傳回已連線至 Microsoft Teams 私人或共用頻道的網站清單。
範例 11
Get-SPOSite -Limit ALL -GroupIdDefined $true
此範例會使用伺服器端篩選來傳回具有相關聯 Microsoft 365 群組的所有網站。
範例 12
$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"
此範例會使用變數擷取依指定擁有者篩選的所有網站。
參數
-ArchiveStatus
適用：SharePoint Online
顯示特定封存狀態的網站。 例如，NotArchived、RecentlyArchived、FullyArchived、Archived 或 Reactivating。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType |
| 預設值: | None |
| 接受的值: | NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Detailed
適用：SharePoint Online
使用此參數可取得網站集合的其他屬性資訊。 若是使用 Detailed 參數，回應時間將會明顯變慢。
會傳回下列屬性：
- ResourceUsageCurrent
- ResourceUsageAverage
- StorageUsageCurrent
- LockIssue
- WebsCount
- CompatibilityLevel
- AllowSelfServiceUpgrade
- SiteDefinedSharingCapability
傳回網站原則儲存的值。
- SharingCapability
傳回有效的存取層級，即網站原則結合租用戶原則。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet1
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DisableSharingForNonOwnersStatus
適用：SharePoint Online
這個參數可防止非擁有者共用。
注意事項
只能在 SharePoint Online 管理命令介面 16.0.4613.1211 版或更新版本中使用此參數。 DisableSharingForNonOwnersStatus 不是保存的設定，而是網站集合狀態的分析。 這樣做的目的是取得此設定，而且不保證傳回的其他設定正確無誤。 若要取得其他設定和值，請使用沒有此參數的 Get-SPOSite，以確保所有內容都正確顯示。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet3
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用：SharePoint Online
指定要套用的伺服器端篩選指令碼區塊。 此類型必須是有效的篩選名稱，值格式必須為 { PropertyName <operator> "filterValue"}。 有效運算子如下：-eq、-ne、-like、-notlike。
目前，您可以依下列屬性進行篩選：Owner、Template (是否是篩選器) 中唯一存在的屬性，可用來篩選 LockState、Url、IsAuthoritative (僅支援比較運算子 -eq 和 -ne) 。
不支援使用 -or 運算子來包含其他篩選。
注意：運算子值為區分大小寫。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GroupIdDefined
適用：SharePoint Online
當值設定為 $true 時，篩選網站清單會傳回具有群組識別碼的網站 (例如：已連線至 Microsoft 365 群組的網站)。 當值為 $false，篩選網站清單只會傳回沒有群組識別碼的網站。
值為 $true、$false 和未定義。 根據預設，未定義值表示不會套用篩選。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：SharePoint Online
指定網站集合的 URL。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet1
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ParamSet3
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludePersonalSite
適用：SharePoint Online
值設定為 $true 時，請顯示個人站台。
有效值為 $true 和 $false。 根據預設，值會是 $false，這表示沒有個人站台會傳回。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IsAuthoritative
適用：SharePoint Online
篩選 IsAuthoritative 屬性設定為 true 的網站清單。 當 IsAuthoritative 為 true 時，它會向 Microsoft 搜尋、Copilot (BizChat) 和其他 AI 代理程式發出訊號，指出網站的內容是官方的、可信任的且經過驗證。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet1
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Limit
適用：SharePoint Online
指定要傳回的網站集合數上限。 此數量不受限制。 若要擷取所有的網站集合，請使用 ALL。 預設值為 200。 如果提供此參數，則不會填入某些網站集合屬性，且可能包含預設值。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet1
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Template
適用：SharePoint Online
顯示特定範本的網站。 例如，STS、STS#0、STS#1、STS#3、GROUP#0、SRCHCEN#0 或 SITEPAGEPUBLISHING#0。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ParamSet2
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。