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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

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

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

Filter 參數是內容資料庫中儲存之特定網站集合屬性的伺服器端篩選器;若沒有 Filter 參數,則篩選這些屬性是一個緩慢的過程。 這些網站集合屬性為 Owner、SecondaryContact 和 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://<site name> 中網站集合的子網站標題集合。

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

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

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

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

Start-SPAssignment -Global
$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1
$s.Url
Stop-SPAssignment -Global

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

The previous example uses the Global method of assignment collection. The Global method is easy to use but the contents of this object grows quickly. Be careful not to run a Get-SPSite command that returns many results while global assignment is enabled.

------------------範例 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

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

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

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

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

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

Get-SPSite -Limit all -CompatibilityLevel 14

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

參數

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CompatibilityLevel

Specifies the version of templates to use when creating a new SPSite object. This value sets the initial CompatibilityLevel value for the site collection. The values for this parameter can be either SharePoint Server or SharePoint Server. When this parameter is not specified, the CompatibilityLevel will default to the highest possible version for the web application depending on the SiteCreationMode setting.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ContentDatabase

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

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

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Filter

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

此類型必須是有效的篩選名稱以及格式為 {$_PropertyName <operator> "filterValue"} 的有效值。

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

Type:ScriptBlock
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-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
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Limit

Limits the maximum number of site collections to return. The default value is 200.

The type must be a valid non-negative number. Specify ALL to return all site collections for the given scope.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NeedsB2BUpgrade

指定網站是否需要升級。

有效值為 True 及 False。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Regex

使用時,為 Identity 參數提供的 URL 會被視為規則運算式。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SiteSubscription

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

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

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

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

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

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition