Get-SPSiteAdministration

 

適用版本: SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間: 2015-03-09

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

Syntax

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

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

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

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

詳細描述

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

Parameters

參數 必要 類型 描述

Identity

必要

Microsoft.SharePoint.PowerShell.SPSiteAdministrationPipeBind

指定所要擷取之網站集合的 URL (完整或局部) 或 GUID。

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

ContentDatabase

必要

Microsoft.SharePoint.PowerShell.SPContentDatabasePipeBind

指定所要擷取之網站集合的 URL (完整或局部) 或 GUID。

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

SiteSubscription

必要

Microsoft.SharePoint.PowerShell.SPSiteSubscriptionPipeBind

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

此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;隸屬於網站訂閱之網站集合成員的 SPSite (物件或 URL);或有效之 SiteSubscription 物件的執行個體。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意

使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

Filter

選用

System.Management.Automation.ScriptBlock

指定要套用的伺服器端篩選指令碼區塊。

此類型必須是格式為 { $_ PropertyName<運算子>“filterValue”}} 的有效篩選名稱和值。

Limit

選用

System.String

限制要傳回的網站集合數上限。預設值為 200

此類型必須是有效的非負數。提供 ALL 會傳回指定範圍內的所有網站集合。

Regex

選用

System.Management.Automation.SwitchParameter

啟用此參數會造成提供給 Identity 參數的 URL,被當成規則運算式處理。

WebApplication

選用

Microsoft.SharePoint.PowerShell.SPWebApplicationPipeBind

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

此類型必須是有效的 URL (格式為 http://server_name)、有效的 GUID (例如,12345678-90ab-cdef-1234-567890bcdefgh) 或 Web 應用程式名稱 (例如,WebApplication1212)。

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

輸入類型

傳回類型

Example

------------------範例 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 http://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global

此範例會取得 Identity 參數所指定的網站集合,並將結果插入至變數 s。此範例會使用廢棄項目收集的 Global 方法。此方法容易使用,但成長非常快。請勿執行 Get-SPSite 命令,以免在執行全域指定時傳回許多結果。

------------------範例 3------------------

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

此範例會使用伺服器端的查詢,取得使用者 DOMAIN\JDoe 所擁有的前 50 個網站,並將傳回的網站指定給本機變數。此命令使用進階的指派收集方法。

------------------範例 4------------------

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

此命令會傳回指定之 Web 應用程式中,所有網站磁碟空間使用量的總和。

------------------範例 5------------------

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

此範例會取得 Web 應用程式中所有網站集合的 URL。

------------------範例 6------------------

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

此範例會傳回所有符合指定規則運算式的網站。使用 Regex 標幟時,需以引號括住為 Identity 參數指定的值。

------------------範例 7------------------

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

此範例最多可取得 URL http://sitename/sites/teams 下的 100 個網站。

See Also

Reference

Set-SPSiteAdministration