Get-CsRegistrarConfiguration
上次修改主題的時間： 2012-03-23
傳回組織中目前使用之登錄器組態設定的相關資訊。登錄器可用來驗證登入要求，並維護使用者狀態與可用性的相關資訊。
語法
Get-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
登錄器可能是 Microsoft Lync Server 2010 中最重要的元件；畢竟，若無登錄器，使用者將無法登入系統，且 Lync Server 2010 也無法追蹤使用者及其目前的狀態。當使用者登入 Lync Server 時，使用者從中登入的端點會傳送 REGISTER 要求給登錄器；而伺服器則以要求用戶端裝置提出驗證認證作為回應。如果用戶端通過質詢 (亦即，如果用戶端呈現一組有效的認證)，則使用者會通過驗證，並將 IP 位址、連接埠與使用者名稱等端點資訊記錄到登錄資料庫中。當使用者登出時，這項資訊便會從資料庫移除。在登入後與登出前的這段時間，登錄器會保持最新的狀態資訊，並協助路由要給該使用者和該使用者傳來的訊息。
登錄器組態設定用於協助管理端點與端點訂閱；這些設定可以在通用、網站或服務範圍內套用。(服務範圍的設定僅能搭配登錄程式服務使用)。Get-CsRegistrarConfiguration 指令程式可用於傳回關於組織中目前使用之所有登錄器組態集合的資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsRegistrarConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRegistrarConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要傳回之登錄器組態設定的唯一識別碼。若要傳回通用設定，請使用此語法：-Identity global。若要傳回在網站範圍設定的設定，請使用類似如下的語法：-Identity site:Redmond。若要傳回服務層級的設定，請使用類似如下的語法：-Identity service:Registrar:atl-cs-001.litwareinc.com。 如果省略此參數，則 Get-CsRegistrarConfiguration 會傳回組織中目前使用的所有登錄器組態設定。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元，以傳回一或多個登錄器組態設定集合。例如，若要傳回在站台範圍所設定的所有設定，請使用此語法：-Filter "site:*"。若要傳回在服務範圍所設定的所有設定，請使用此語法：-Filter "service:*"。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取登錄器組態設定資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsRegistrarConfiguration 不會接受管線傳送的輸入。
傳回類型
Get-CsRegistrarConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsRegistrarConfiguration
範例 1 所示的命令會傳回在組織中使用之所有登錄器組態設定的集合。
-------------------------- 範例 2 --------------------------
Get-CsRegistrarConfiguration -Identity site:Redmond
範例 2 會傳回登錄器組態設定的單一集合：為 Redmond 網站設定的設定 (-Identity site:Redmond)。
-------------------------- 範例 3 --------------------------
Get-CsRegistrarConfiguration -Filter "service:*"
在範例 3 中，會傳回在服務範圍指派之所有登錄器組態設定的資訊。若要這樣做，此命令會使用 Filter 參數及篩選值 "service:*"；該篩選值可確保只傳回 Identity 開頭為字串值 "service:" 的設定。。
-------------------------- 範例 4 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}
範例 4 會傳回關於啟用 DHCP 伺服器以登錄用戶端之登錄器組態設定的資訊。若要執行此工作，此命令會先呼叫沒有任何參數的 Get-CsRegistrarConfiguration 以傳回目前使用中之所有登錄器組態設定的集合。接著，此集合會傳送到 Where-Object，只選取 EnableDHCPServer 屬性等於 True 的設定。
-------------------------- 範例 5 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8}
在以上的命令中，會傳回允許每個使用者使用 8 個以上端點之所有登錄器組態設定的資訊。若要完成這個工作，此命令會先使用 Get-CsRegistrarConfiguration 傳回組織中使用之所有登錄器組態設定的集合。接著會將此集合傳送到 Where-Object Cmdlet，只挑出 MaxEndpointsPerUser 屬性大於 8 的設定。