Get-CsUserPoolInfo
上次修改主題的時間： 2012-03-23
傳回登錄器集區、備份登錄器集區及使用者已指派之使用者服務集區的相關資訊。
語法
Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]
詳細描述
如果使用者已啟用 Microsoft Lync Server 2010，則該使用者必須隸屬於登錄器集區。該集區負責驗證使用者，並追蹤使用者目前的狀態與位置。如果您需要知道使用者被指派的登錄集區，您可以使用類似如下的命令來擷取該資訊：
Get-CsUser "Ken Myer" | Select-Object RegistrarPool
在許多情況下，只知道使用者的登錄集區可能就是您需要的所有資訊。在其他情況下，您可能也想要知道使用者已被指派之備份登錄器集區 (也就是，當主要登錄器集區無法使用時要使用的集區)、組成這些集區之個別電腦的名稱，以及使用者已被指派的使用者服務集區等等。您可以執行 Get-CsUserPoolInfo 指令程式來傳回該類型的詳細資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsUserPoolInfo Cmdlet：RTCUniversalReadOnlyAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中輸入下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserPoolInfo"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
使用者 ID 參數 |
表示要擷取其使用者集區資訊之使用者的 Identity。您可以使用下列四種格式的其中一種來指定 Identity：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\kenmyer)；4) 使用者的 Active Directory 網域服務 (AD DS) 顯示名稱 (如 Ken Myer)。您也可以利用使用者的 Active Directory 辨別名稱來參考使用者帳戶。 使用「顯示名稱」作為使用者 Identity 時，您可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回姓氏結尾為字串值 " Smith" 之使用者的資訊。 |
LocalStore |
切換參數 |
從中央管理存放區的本機複本擷取使用者集區資訊，而非從中央管理存放區本身擷取。 |
輸入類型
字串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Set-CsUser 接受管線傳送的字串值，其代表已經針對 Lync Server 2010 啟用的使用者帳戶 SamAccountName。該指令程式也接受管線傳送的 Active Directory 使用者物件執行個體。
傳回類型
Get-CsUserPoolInfo 會傳回 Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"
以上的命令會傳回下列單一使用者的使用者集區資訊：SIP 位址為 sip:kenmyer@litwareinc.com 的使用者。
-------------------------- 範例 2 ------------------------
Get-CsUser | Get-CsUserPoolInfo
在範例 2 中, 會傳回已啟用 Lync Server 2010 之所有使用者的使用者集區資訊。為了執行此作業，命令會先呼叫 Get-CsUser (不用任何參數)，以傳回啟用 Lync Server 之所有使用者的集合。接著，此集合會傳送到 Get-CsUserPoolInfo，以顯示集合中每個使用者的集區資訊。
-------------------------- 範例 3 ------------------------
Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo
範例 3 所示的命令是範例 2 中所使用的命令變化。在範例 2 中，會傳回已啟用 Lync Server 之所有使用者的集區資訊。但是，可能會有已啟用 Lync Server，但未指派登錄器集區的使用者。範例 2 所示的命令會顯示符合這些準則之每位使用者的錯誤訊息；這些錯誤訊息會在範例 3 中隱藏。
為了隱藏錯誤訊息，範例 3 再次使用 Get-CsUser 傳回所有已啟用 Lync Server 的使用者集合。但是這次將集合傳送給 Where-Object 指令程式，只會挑選出 RegistrarPool 屬性不等於 Null 值的使用者。(換言之，已指派登錄器集區的使用者)。接著，該篩選過的集合會傳送到 Get-CsUserPoolInfo，以顯示已篩選集合中每個使用者的集區資訊。
-------------------------- 範例 4 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}
在上述命令中，會顯示已指派主要集區 redmond-cs-001.litwareinc.com 之所有使用者的集區資訊。為達成此目的，先呼叫 Get-CsUser 以傳回已啟用 Lync Server 之所有使用者的集合。該集合會傳送到 Get-CsUserPoolInfo，以擷取集合中每個使用者的集區資訊。該集區資訊也會傳送到 Where-Object 指令程式，只會選取 PrimaryPoolFqdn 屬性等於 redmond-cs-001.litwareinc.com 的那些使用者。
-------------------------- 範例 5 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}
範例 5 所示的命令會傳回尚未指派備份登錄器集區之所有使用者的集區資訊。為了執行此作業，命令會先呼叫 Get-CsUser 以傳回已啟用 Lync Server 之所有使用者的集合。接著，該資訊會傳送到 Get-CsUserPoolInfo，以擷取集合中每個使用者的集區資訊。最後，將該集區資訊傳送到 Where-Object，它只會顯示 BackupPoolFqdn 內容等於 null 值的那些使用者的資料。
-------------------------- 範例 6 ------------------------
Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder
於範例 6 中，會報告組成 Ken Myer 之登錄器集區之個別電腦的相關資訊。若要擷取此資訊，會先呼叫 Get-CsUserPoolInfo 以傳回 Ken Myer 之使用者帳戶的相關資料。該資料接著傳送至 Select-Object 指令程式。Select-Object 使用 Expand 參數來「展開」儲存在 PrimaryPoolMachinesInPreferredOrder 內容中的資訊。擴充屬性表示會以易於讀取的格式將儲存於該屬性的所有值顯示於螢幕上。