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>]
说明
此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数,而不能结合使用不同参数集中的参数。 有关如何使用参数集的详细信息,请参阅 Cmdlet 参数集。
              Get-SPOSite cmdlet 可检索并返回符合给定条件的所有网站集的属性。
使用 5361 版本的 SharePoint Online Management Shell 时,你可能会遇到以下情况:
此时将显示其他网站集。 例如,将显示所有组和视频网站以及团队网站。
Detailed 参数已被弃用。 它将继续用于较早版本
你需要是 SharePoint Online 管理员和网站集管理员才能运行 cmdlet。
有关适用于 SharePoint Online 的 Windows PowerShell 的权限和最新信息,请参阅在线文档简介 SharePoint Online 命令行管理程序的简介。
注意
如果为租户启用了网站集存储管理,则你将无法设置配额,并返回一个一般性错误。 若要解决此问题,请暂时将网站集存储管理设置为“手动”,设置配额,然后将网站集存储管理设置重新设置为原始设置。
注意
如果提供了 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 Management Shell 版本 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。
目前,可以按以下属性进行筛选:所有者、模板 (可用于筛选(如果它是筛选器中的唯一属性) 、LockState、Url、IsAuthoritative (仅支持比较运算符 -eq 和 -ne) )。
不支持使用 -or 运算符包含其他筛选器。
注意:运算符值区分大小写。
参数属性
| 类型: | System.String | 
| 默认值: | None | 
| 支持通配符: | False | 
| 不显示: | False | 
参数集
					ParamSet2 
					
				 
				| Position: | Named | 
| 必需: | False | 
| 来自管道的值: | False | 
| 来自管道的值(按属性名称): | False | 
| 来自剩余参数的值: | False | 
-GroupIdDefined 
		适用:SharePoint Online
当值设置为$true时,筛选返回到具有组 ID 的站点的站点列表(即:连接到Microsoft 365组的站点)。 当值$false时,将站点列表筛选为只有没有组 ID 的站点。
这些值 $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 Search、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。