Get-SPOSite

  • 参考
模块:
Microsoft.Online.SharePoint.PowerShell
适用于:
SharePoint Online

返回一个或多个网站集。

语法

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>]

说明

此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数，而不能结合使用不同参数集中的参数。 有关如何使用参数集的详细信息，请参阅 Cmdlet 参数集。

Get-SPOSite cmdlet 可检索并返回符合给定条件的所有网站集的属性。

使用 5361 版本的 SharePoint Online Management Shell 时，你可能会遇到以下情况：

此时将显示其他网站集。 例如，将显示所有组和视频网站以及团队网站。

Detailed 参数已被弃用。 它将继续用于较早版本

注意

回收站中的网站集将不会通过 Get-SPOSite cmdlet 进行检索。

你需要是 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

此示例返回与网站关联的 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 Management Shell 版本 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。 目前，可以按以下属性进行筛选：所有者、模板（如果是筛选器中的唯一属性，则可用于筛选）、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时，筛选返回到具有组 ID 的站点的站点列表（即：连接到Microsoft 365组的站点）。 当值$false时，将站点列表筛选为只有没有组 ID 的站点。

这些值 $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