Get-SPSiteAdministration

返回一个网站管理对象,该对象允许服务器场管理员查看有关他们可能无权访问的网站集的某些信息。

语法

AllSitesInIdentity

Get-SPSiteAdministration
    [-Identity] <SPSiteAdministrationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-Regex]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInContentDB

Get-SPSiteAdministration
    -ContentDatabase <SPContentDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInSiteSubscription

Get-SPSiteAdministration
    -SiteSubscription <SPSiteSubscriptionPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-WhatIf]
    [<CommonParameters>]

AllSitesInWebApplication

Get-SPSiteAdministration
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Filter <ScriptBlock>]
    [-Limit <String>]
    [-WebApplication <SPWebApplicationPipeBind>]
    [-WhatIf]
    [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数,也可以不合并来自不同参数集的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

Get-SPSiteAdminitration cmdlet 返回一个网站管理对象,该对象允许服务器场管理员查看有关他们可能无权访问的网站集的某些信息。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

示例 1

Get-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}

此示例获取 URL 为 b399a366-d899-4cff-8a9b-8c0594ee755f(服务器场管理员无需访问权限)的内容数据库中所有网站的数据子集。 此命令使用计算出的 Storage 属性显示内容数据库的最大存储值。

示例 2

Start-SPAssignment -Global
$s = Get-SPSiteAdministration -Identity https://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global

此示例获取 Identity 参数指定的网站集,并将结果插入变量 s 中。 此示例使用垃圾回收的 Global 方法。 此方法易于使用,但空间增长太快。 在启用全局分配时,请不要运行返回许多结果的 Get-SPSite 命令。

示例 3

C:\PS>$GC = Start-SPAssignment
$Sites = $GC | Get-SPSiteAdministration -Filter {$_.Owner -eq "DOMAIN\JDoe"} -Limit 50
Stop-SPAssignment $GC

此示例使用服务器端查询,获取用户 DOMAIN\JDoe 拥有的前 50 个网站,并将返回的网站分配给局部变量。 此命令使用高级分配集合方法。

示例 4

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}

此命令返回指定 Web 应用程序中所有网站的磁盘空间使用总量。

示例 5

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL

此示例获取 Web 应用程序中所有网站集的 URL。

示例 6

Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex

此示例返回与给定正则表达式匹配的所有网站。 当使用 Regex 标志时,需要在为 Identity 参数指定的值两侧添加引号。

示例 7

Get-SPSite "https://sitename/sites/teams/*" -Limit 100

此示例最多获取 URL 下的 100 个网站 https://sitename/sites/teams.

参数

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

在使用 Global 参数时,所有对象均包含在全局存储中。 如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

执行命令前,看到确认提示。 有关详细信息,请键入以下命令:get-help about_commonparameters

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContentDatabase

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要检索的网站集的 URL(全部或部分)或 GUID。

键入的值必须是有效的 URL(格式为 https://server_name)或 GUID(格式为 1234-456-987fg)。

参数属性

类型:SPContentDatabasePipeBind
默认值:None
支持通配符:False
不显示:False

参数集

AllSitesInContentDB
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Filter

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要应用的服务器端筛选器脚本块。

该类型必须是有效的筛选器名称,并且值为 { $_ PropertyName <运算符 > “filterValue”}}

参数属性

类型:ScriptBlock
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要检索的网站集的 URL(全部或部分)或 GUID。

键入的值必须是有效的 URL(格式为 https://server_name)或 GUID(格式为 1234-456-987fg)。

参数属性

类型:SPSiteAdministrationPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

AllSitesInIdentity
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Limit

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

限制要返回的网站集的最大数目。 默认值为 200。

键入的值必须为有效非负数。 提供 ALL 将返回给定范围的所有网站集。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Regex

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

如果启用此开关,则会将为 Identity 参数提供的 URL 视为正则表达式。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

AllSitesInIdentity
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SiteSubscription

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定要从其获取网站集的网站组。

键入的值必须是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);是作为网站订阅成员的网站集的 SPSite(对象或 URL);或者是有效 SiteSubscription 对象的实例。

参数属性

类型:SPSiteSubscriptionPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

AllSitesInSiteSubscription
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WebApplication

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定从其列出网站的 Web 应用程序的 URL、GUID 或名称。

键入的值必须是有效的 URL(格式为 https://server_name);有效的 GUID(例如 12345678-90ab-cdef-1234-567890bcdefgh);或者是 Web 应用程序名称(例如 WebApplication1212)。

参数属性

类型:SPWebApplicationPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

AllSitesInWebApplication
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

显示一条描述命令作用的消息,而不执行命令。 有关详细信息,请键入以下命令:get-help about_commonparameters

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters