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