Get-SPSiteAdministration

傳回的網站管理物件,可讓伺服器陣列管理員檢視其可能無法存取之網站集合的特定資訊。

Syntax

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

Description

此 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 參數所指定的網站集合,並將結果插入變數。 此範例使用垃圾收集的全域方法。 這個方法比較容易使用,但會快速成長。 請勿執行在全域指派開啟時傳回許多結果的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。

此類型必須是格式為 https://server_name 的有效 URL,或格式為 1234-456-987fg 的 GUID。

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。

此類型必須是格式為 https://server_name 的有效 URL,或格式為 1234-456-987fg 的 GUID。

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

指定網站集合取得來源的網站群組。

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;隸屬於網站訂閱之網站集合成員的 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

指定網站列示所在的 URL、GUID 或 Web 應用程式名稱。

此類型必須是有效的 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