Get-SPSiteAdministration

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

语法

Get-SPSiteAdministration
   [-Identity] <SPSiteAdministrationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSiteAdministration
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSiteAdministration
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]
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 命令。

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

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

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

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ContentDatabase

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

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

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Filter

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

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

Type:ScriptBlock
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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

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

Type:SPSiteAdministrationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Limit

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Regex

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteSubscription

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

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

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

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

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

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019