Get-SPWeb
傳回所有符合特定準則的子網站。
Syntax
Get-SPWeb
[[-Identity] <SPWebPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-Regex]
[-Site <SPSitePipeBind>]
[-WhatIf]
[<CommonParameters>]
Description
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 Cmdlet 以避免記憶體流失。
如需 SharePoint 產品和技術的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint 伺服器 Cmdlet。
範例
--------------------範例 1----------------------
Get-SPWeb -site https://sitename/sites/site1
此範例會傳回指定網站集合中所有的子網站。
--------------------範例 2----------------------
Get-SPWeb -Site https://sitename/sites/site1 -filter {$_.Template -eq "STS#0"}
此範例會顯示所有使用 "STS#0" 範本的子網站。
--------------------範例 3----------------------
Start-SPAssignment -Global
C:\PS>$w = Get-SPWeb https://sitename
C:\PS>$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
C:\PS>$w.Update()
Stop-SPAssignment -Global
此範例會展示如何將子網站儲存為變數,以及如何呼叫 SPAssignment 物件的物件模型方法。
參數
-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 |
-Filter
指定要針對指定範圍使用的伺服器端篩選。
此類型必須是格式為 {filterName < 運算子 > 「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。 若使用相對路徑,您必須指定 Site 參數。
格式為 https://server_name 的有效 URL,或格式為 /SubSites/MySubSite 的相對路徑。
Type: | SPWebPipeBind |
Position: | 1 |
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 |
-Limit
限制要傳回的子網站數目上限。 預設值為 200。 若要傳回所有網站,請輸入 ALL 。
此類型必須是大於 0 的有效數字或 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 |
-Site
指定要從中列示子網站之網站集合的 URL 或 GUID。
此類型必須是格式為 的有效 URL https://server_name ;格式為 1234-5678-9807 的 GUID,或 SPSite 物件。
Type: | SPSitePipeBind |
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 |