Get-SPSite

模組:: SharePointServer module

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

語法

AllSitesInIdentity

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

AllSitesInContentDB

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

AllSitesInSiteSubscription

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

AllSitesInWebApplication

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 命令處置物件，將會發生記憶體不足的狀況。

參數屬性

類型:	SPAssignmentCollection
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-CompatibilityLevel

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

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ContentDatabase

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

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

參數屬性

類型:	SPContentDatabasePipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInContentDB

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Filter

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

此類型必須是格式為 {$_PropertyName <運算子> “filterValue” } 的有效篩選名稱和值。

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

參數屬性

類型:	ScriptBlock
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Identity

指定要取得的網站集合 URL 或 GUID。

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

參數屬性

類型:	SPSitePipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInIdentity

Position:	1
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Limit

限制要傳回的網站集合數上限。預設值為 200。

此類型必須是有效的非負數。指定 ALL 會傳回指定範圍內的所有網站集合。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NeedsB2BUpgrade

指定網站是否需要升級。

有效值為 True 及 False。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInContentDB

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Regex

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInIdentity

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SiteSubscription

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

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

參數屬性

類型:	SPSiteSubscriptionPipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInSiteSubscription

Position:	Named
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WebApplication

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

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

參數屬性

類型:	SPWebApplicationPipeBind
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

AllSitesInWebApplication

Position:	Named
必要:	False
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

意見反應

此頁面對您有幫助嗎？

共用方式為

Get-SPSite

語法

AllSitesInIdentity

AllSitesInContentDB

AllSitesInSiteSubscription

AllSitesInWebApplication

Description

範例

範例 1

範例 2

範例 3

範例 4

範例 5

範例 6

範例 7

範例 8

範例 9

參數

-AssignmentCollection

參數屬性

參數集

-CompatibilityLevel

參數屬性

參數集

-Confirm

參數屬性

參數集

-ContentDatabase

參數屬性

參數集

-Filter

參數屬性

參數集

-Identity

參數屬性

參數集

-Limit

參數屬性

參數集

-NeedsB2BUpgrade

參數屬性

參數集

-Regex

參數屬性

參數集

-SiteSubscription

參數屬性

參數集

-WebApplication

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

意見反應