Get-CsPool
上次修改主題的時間： 2012-03-23
傳回使用於您 Microsoft Lync Server 2010 部署之集區的相關資訊。集區是站台中執行所有相同 Lync Server 2010 服務集的電腦集合。
語法
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
詳細描述
在 Lync Server 2010 中，集區代表相同站台 (執行相同服務集) 中的一或多部電腦。例如，若您有一部在 Redmond 站台中執行 中繼伺服器 服務的伺服器，則 中繼伺服器 集區會包含該部電腦。若您有兩部在 Redmond 站台中執行 中繼伺服器 務的電腦，則 中繼伺服器 集區會包含兩部電腦。用於您組織中的集區數量會依您具有的伺服器數量與這些伺服器所執行的不同服務而定。
Get-CsPool 指令程式可讓您擷取使用於您組織中每個集區的相關資訊，包含在這些集區上執行之服務的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsPool Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPool"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
字串 |
要傳回之集區的完整網域名稱 (FQDN)。例如：-Identity atl-cs-001.litwareinc.com。 如果未使用此參數，則將會傳回您組織中的所有集區。 |
Filter |
選用 |
字串 |
在指定要傳回之集區的 Identity 時，可讓您使用萬用字元。例如，此語法會傳回其 Identity 以字串值 ".fabrikam.com" 結束的所有集區：-Filter "*.fabrikam.com"。 請注意，您不能在同一個命令中同時使用 Filter 和 Identity 參數。 |
Site |
選用 |
字串 |
傳回在指定站台上找到的所有集區。問題中的站台應可使用站台的 DisplayName (例如，Redmond) 進行參考，而非使用站台 Identity (例如，site:Redmond)。例如：-Site "Redmond"。您可以執行此命令以擷取站台的顯示名稱： Get-CsSite | Select-Object Identity, DisplayName |
輸入類型
無。Get-CsPool 不會接受管線傳送的資料。
傳回類型
Get-CsPool 會傳回 Microsoft.Rtc.Management.Deploy.Internal.Cluster 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsPool
上述命令會傳回在您 Lync Server 部署中找到的所有集區。
-------------------------- 範例 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
範例 2 會顯示於每個集區中所找到電腦的相關資訊。這可藉由呼叫 Get-CsPool 來完成，然後將傳回的資料傳送至 Select-Object 指令程式。Select-Object 的 ExpandProperty 參數會接著用來「擴充」Computers 屬性值。Computers 屬性就是代表集區中每部電腦的物件陣列。當您擴充 Computers 屬性時，您會獲得這些電腦的詳細資訊。
-------------------------- 範例 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
上述範例中，Identity 參數用來限制 Identity 為 atl-cs-001.litwareinc.com 的集區傳回的資料。
-------------------------- 範例 4 --------------------------
Get-CsPool -Site "Redmond"
範例 4 會傳回於 Redmond 站台中找到的所有集區。為達成此目的，命令會使用 Site 參數；參數值 "Redmond" 會將傳回的資料限制為 Site 屬性等於 Redmond 的集區。
-------------------------- 範例 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
範例 5 所示的命令會傳回未安裝任何 Lync Server 服務的集區之集合。為了執行此作業，命令會先在不搭配任何參數的情況下呼叫 Get-CsPool；這會傳回目前使用於組織中之所有集區的集合。然後將此集合傳送給 Where-Object 指令程式，該指令程式會挑出 Services.Count 屬性等於 0 的所有集區。如果 Count 等於 0，代表該集區並未設定任何 Lync Server 服務。