Get-SPSite

參考

模組:: SharePointServer

適用於:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

傳回所有符合指定準則的網站集合。

Syntax

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Description

此 Cmdlet 包含一個以上的參數集。您可能只使用一個參數集中的參數，但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊，請參閱 Cmdlet 參數集。

Get-SPSite Cmdlet 會傳回符合 Identity 參數的單一網站，或符合指定範圍之 Filter 參數的所有網站。範圍包括 WebApplication、ContentDatabase 和 SiteSubscription 參數。如果未提供這些範圍，範圍就是伺服器陣列。如果指定範圍時沒有 Filter 參數，則會返回該範圍的所有網站。

Identity 參數支援提供以萬用字元 (*) 結尾的部分 URL。返回與指定範圍的此部分 URL 相符的所有網站集合。此外，如果提供 Regex 參數，Identity 參數會被視為規則運算式，且返回指定範圍中提供的 URL 與運算式相符的任何網站集合。

Filter 參數是內容資料庫中儲存之特定網站集合屬性的伺服器端篩選器；若沒有 Filter 參數，則篩選這些屬性是一個緩慢的過程。這些網站集合屬性為 Owner、SecondaryOwner 和 LockState。 Filter 參數是指令碼區塊，使用與 Where-Object 陳述式相同的語法，但會在伺服器上執行以取得更快的結果。

LockState 的有效值為：Unlock、NoAdditions、ReadOnly、NoAccess。

請注意，Get-SPSite Cmdlet 傳回的每一個網站集合都會在管線結束時自動銷毀。若要將 Get-SPSite 的結果儲存在區域變數中，請使用 Start-SPAssignment 和 Stop-SPAssignment Cmdlet 以避免記憶體流失。

如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。

範例

------------------範例 1---------------------

Get-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

本範例會以網站名稱 > 取得網站集合中子網站標題的集合 HTTPs:// < 。

------------------範例 2---------------------

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryOwner

此範例會從內容資料庫 b399a366-d899-4cff-8a9b-8c0594ee755f 中取得所有網站的子集合。

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

Start-SPAssignment -Global

$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1

$s.Url

Stop-SPAssignment -Global

此範例會取得 Identity 參數所指定的網站，並將結果插入變數 s。

上述範例使用工作分派集合的 Global 方法。全域方法很容易使用，但此物件的內容會快速成長。請小心不要在啟用全域指派時執行會傳回許多結果的Get-SPSite命令。

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

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

此範例會使用伺服器端查詢來取得使用者 DOMAIN\JDow 所擁有的前 50 個網站，並指派它們至區域變數。

此範例使用進階指派集合方法。

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

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

此範例顯示會傳回特定 Web 應用程式中，所有網站磁碟空間使用量的總和。

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

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

此範例會傳回所有符合特定規則運算式的網站。

使用 Regex 參數時，Identity 參數上必須要有「引號」。

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

Get-SPSite https://<site name>/sites/teams/* -Limit 100

此範例會取得 URL 下最多 100 個網站 https://sitename/sites/teams.

------------------範例 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

此範例使用 .UsageInfo 屬性的儲存欄位取得網站集合所使用的儲存量。

------------------範例 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

此範例會傳回所有的 SharePoint Server 模式網站集合。

參數

-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

-CompatibilityLevel

指定在建立新 SPSite 物件時，所要使用的範本版本。此值會設定網站集合的初始 CompatibilityLevel 值。此參數的值可以是 SharePoint Server 或 SharePoint Server。未指定此參數時，視 SiteCreationMode 設定而定，CompatibilityLevel 預設值將是最新的可能版本。

Type:	Int32
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

-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

指定要從中列出網站集合的內容資料庫 GUID。

此類型必須是格式為 SPContentDB01 的有效資料庫名稱，或有效的 GUID (例如 12345678-90ab-cdef-1234-567890bcdefgh)。

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」 } 的有效篩選名稱和值。

有效運算子是：EQ、NE、LIKE 及 NOTLIKE。

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 或 https://server_name/sites/sitename 的有效 URL，或有效的 GUID (例如 12345678-90ab-cdef-1234-567890bcdefgh)。

Type:	SPSitePipeBind
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

-NeedsB2BUpgrade

指定網站是否需要升級。

有效值為 True 及 False。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	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

指定要從中取得網站集合的網站訂閱。

此類型必須是格式為 https://server_name 的有效 URL，或有效的 GUID (例如 12345678-90ab-cdef-1234-567890bcdefgh)。

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 應用程式名稱。

此類型必須是格式為 https://server_name 的有效 URL、有效的 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