Get-SPWeb
適用版本： SharePoint Foundation 2010, SharePoint Server 2010
上次修改主題的時間： 2015-03-09
傳回所有符合指定準則的子網站。
Syntax
Get-SPWeb [[-Identity] <SPWebPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Filter <ScriptBlock>] [-Limit <String>] [-Regex <SwitchParameter>] [-Site <SPSitePipeBind>] [-WhatIf [<SwitchParameter>]]
詳細描述
Get-SPWeb Cmdlet 會傳回所有符合 Identity 參數所指定範圍的子網站。凡符合該準則的子網站都會傳回。
Identity 可以是完整的 URL 或相對路徑。若指定相對路徑，也必須指定 Site 參數，以找到要從中傳回子網站的網站集合。
Identity 參數也支援提供以萬用子元 (*) 結尾的部分 URL。指定範圍內所有符合此部分 URL 的子網站都會傳回。此外，若已提供 Regex 參數，則 Identity 參數會被視為規則運算式，並傳回符合此運算式之具有指定範圍內 URL 的子網站。
Filter 參數是伺服器端的篩選，可篩選儲存在內容資料庫的特定子網站屬性；若無 Filter 參數，篩選這些屬性的過程會很緩慢。這些子網站屬性為 Template 及 Title。Filter 參數是與 Where-Object 陳述使用相同語法的指令碼區塊，但在伺服器端執行以提供快速的結果。
請特別注意，Get-SPWeb Cmdlet 傳回的每一個網站集合，都會在輸送過程的末端自動處置。若要以區域變數儲存 Get-SPWeb 的結果，必須使用 Start-SPAssignment 及 Stop-SPAssignment Cmdlets 以避免記憶體遺漏。
Parameters
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Microsoft.SharePoint.PowerShell.SPWebPipeBind |
指定子網站的名稱或完整或部分的 URL。若使用相對路徑，您必須指定 Site 參數。 格式為 http://server_name 的有效 URL，或格式為 /SubSites/MySubSite 的相對路徑。 |
AssignmentCollection |
選用 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。 注意 使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。 |
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
Filter |
選用 |
System.Management.Automation.ScriptBlock |
指定要針對指定範圍使用的伺服器端篩選。 此類型必須是格式為 {filterName <operator> "filterValue"} 的有效篩選。 |
Limit |
選用 |
System.String |
限制要傳回的子網站數目上限。預設值為 200。若要傳回所有網站，請輸入 ALL。 此類型必須是大於 0 的有效數字或 ALL。 |
Regex |
選用 |
System.Management.Automation.SwitchParameter |
指定為 Identity 參數提供的 URL 當成規則運算式處理。 |
Site |
選用 |
Microsoft.SharePoint.PowerShell.SPSitePipeBind |
指定要從中列示子網站之網站集合的 URL 或 GUID。 此類型必須是格式為 http://server_name 的有效 URL、格式為 1234-5678-9807 的 GUID，或 SPSite 物件。 |
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters |
輸入類型
傳回類型
Example
--------------------範例 1----------------------
Get-SPWeb -site http://sitename/sites/site1
此範例會傳回指定網站集合中所有的子網站。
--------------------範例 2----------------------
Get-SPWeb -Site http://sitename/sites/site1 -filter {$_.Template -eq "STS#0"}
此範例會顯示所有使用 "STS#0" 範本的子網站。
--------------------範例 3----------------------
Start-SPAssignment -Global
$w = Get-SPWeb http://sitename
$w.set_SiteLogoUrl("http://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global
此範例會展示如何將子網站儲存為變數，以及如何呼叫 SPAssignment 物件的物件模型方法。