共用方式為


Get-SPSite

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

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