Get-SPSiteAdministration
傳回的網站管理物件,可讓伺服器陣列管理員檢視其可能無法存取之網站集合的特定資訊。
語法
AllSitesInIdentity
Get-SPSiteAdministration
[-Identity] <SPSiteAdministrationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-Regex]
[-WhatIf]
[<CommonParameters>]
AllSitesInContentDB
Get-SPSiteAdministration
-ContentDatabase <SPContentDatabasePipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-WhatIf]
[<CommonParameters>]
AllSitesInSiteSubscription
Get-SPSiteAdministration
-SiteSubscription <SPSiteSubscriptionPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-WhatIf]
[<CommonParameters>]
AllSitesInWebApplication
Get-SPSiteAdministration
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
Description
此 Cmdlet 包含一個以上的參數集。 您可能只使用一個參數集中的參數,但不可以結合不同參數集的參數。 如需如何使用參數集的詳細資訊,請參閱 Cmdlet 參數集。
Get-SPSiteAdminitration Cmdlet 會傳回網站管理物件,可讓伺服器陣列系統管理員檢視他們可能無權存取之網站集合的特定資訊。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
Get-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}
此範例會從內容資料庫中的所有網站取得資料子集,其 URL 為 b399a366-d899-4cff-8a9b-8c0594ee755f (陣列系統管理員不需要存取權) 。 此命令使用計算屬性 Storage 來顯示內容資料庫的最大儲存值。
範例 2
Start-SPAssignment -Global
$s = Get-SPSiteAdministration -Identity https://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global
此範例會取得 Identity 參數所指定的網站集合,並將結果插入變數 s。 此範例使用廢棄項目收集的全域方法。 這個方法更容易使用,但增長很快。 請勿在全域指派開啟時執行會傳回許多結果的 Get-SPSite 命令。
範例 3
C:\PS>$GC = Start-SPAssignment
$Sites = $GC | Get-SPSiteAdministration -Filter {$_.Owner -eq "DOMAIN\JDoe"} -Limit 50
Stop-SPAssignment $GC
此範例會使用伺服器端查詢取得使用者 DOMAIN\JDoe 所擁有的前 50 個網站,並將傳回的網站指派給區域變數。 此命令使用進階指派收集方法。
範例 4
Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}
此命令會傳回指定 Web 應用程式中所有網站的磁碟空間使用量總和。
範例 5
Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL
本範例會取得 Web 應用程式中所有網站集合的 URL。
範例 6
Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex
此範例會傳回所有符合特定規則運算式的網站。 使用 Regex 旗標時,必須以引號括住為 Identity 參數指定的值。
範例 7
Get-SPSite "https://sitename/sites/teams/*" -Limit 100
此範例會在 URL 底下取得最多 100 個網站 https://sitename/sites/teams.
參數
-AssignmentCollection
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。
使用 Global 參數時,所有物件會包含在全域儲存區內。 若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
在執行命令之前,提示您確認操作。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ContentDatabase
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定要擷取之網站集合的 URL (完整或局部) 或 GUID。
此類型必須是格式為 https://server_name 的有效 URL,或格式為 1234-456-987fg 的 GUID。
參數屬性
| 類型: | SPContentDatabasePipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AllSitesInContentDB
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Filter
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定要套用的伺服器端篩選指令碼區塊。
類型必須是有效的篩選名稱,且格式為 { $_ PropertyName <operator > “filterValue”}}
參數屬性
| 類型: | ScriptBlock |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定要擷取之網站集合的 URL (完整或局部) 或 GUID。
此類型必須是格式為 https://server_name 的有效 URL,或格式為 1234-456-987fg 的 GUID。
參數屬性
| 類型: | SPSiteAdministrationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AllSitesInIdentity
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Limit
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
限制要傳回的網站集合數上限。 預設值為 200。
此類型必須是有效的非負數。 提供 ALL 會傳回指定範圍內的所有網站集合。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Regex
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
啟用此參數會造成提供給 Identity 參數的 URL,被當成規則運算式處理。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AllSitesInIdentity
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SiteSubscription
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定網站集合取得來源的網站群組。
此類型必須是格式為 12345678-90ab-cdef-1234-567890bcdefgh 的有效 GUID;隸屬於網站訂閱之網站集合成員的 SPSite (物件或 URL);或有效之 SiteSubscription 物件的執行個體。
參數屬性
| 類型: | SPSiteSubscriptionPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AllSitesInSiteSubscription
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WebApplication
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
指定網站列示所在的 URL、GUID 或 Web 應用程式名稱。
此類型必須是有效的 URL (格式為 https://server_name、有效的 GUID (例如,12345678-90ab-cdef-1234-567890bcdefgh) 或 Web 應用程式名稱 (例如,WebApplication1212)。
參數屬性
| 類型: | SPWebApplicationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AllSitesInWebApplication
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用項目:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
顯示訊息會描述命令的功效而不執行命令。
如需詳細資訊,請輸入下列命令:get-help about_commonparameters。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。