Set-CsRegistrarConfiguration
上次修改主題的時間： 2012-03-26
修改現有登錄器組態設定集合中的屬性值。登錄器可用來驗證登入要求，並維護使用者狀態與可用性的相關資訊。
語法
Set-CsRegistrarConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
詳細描述
登錄器可能是 Microsoft Lync Server 2010 中最重要的元件；畢竟，若無登錄器，使用者將無法登入系統，且 Lync Server 2010 也無法追蹤使用者及其目前的狀態。當使用者登入 Lync Server 時，使用者從中登入的端點會傳送 REGISTER 要求給登錄器；而伺服器則以要求用戶端裝置提出驗證認證作為回應。如果用戶端通過此挑戰 (即用戶端出示一組有效認證)，則使用者通過驗證，而且端點資訊 (例如 IP 位址、連接埠和使用者名稱) 會記錄到註冊資料庫中。當使用者登出時，這項資訊便會從資料庫移除。在登入後與登出前的這段時間，登錄器會保持最新的狀態資訊，並協助路由要給該使用者和該使用者傳來的訊息。
登錄器組態設定用於協助管理端點與端點訂閱；這些設定可以在通用、網站或服務範圍內套用。(服務範圍設定只與登錄器服務搭配使用)。Set-CsRegistrarConfiguration 指令程式可以用來修改您組織中目前使用的任何 (或所有) 登錄器組態集合。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsRegistrarConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRegistrarConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要修改之登錄器組態設定的唯一識別碼。若要修改通用設定，請使用此語法：-Identity global。若要修改在站台範圍設定的設定值，請使用如下的語法：-Identity site:Redmond。若要修改服務層級的設定，請使用如下的語法：-Identity service:Registrar:atl-cs-001.litwareinc.com。請注意，登錄器設定只能套用至登錄器服務。如果嘗試將這些設定套用至任何其他服務，將發生錯誤訊息。 |
Instance |
選用 |
RegistrarSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
DefaultEndpointExpiration |
選用 |
整數 |
端點登入時，會看到要求到期逾時的選項；這個選項能指定端點在必須聯絡伺服器並要求延長之前，仍可在系統上保留登入狀態的時間間隔。DefaultEndpointExpiration 屬性代表當用戶端不要求特定逾時值時的到期逾時間隔。 DefaultEndpointExpiration 必須介於 300 (5 分鐘) 與 900 (15 分鐘) 之間。預設值為 600 (10 分鐘)。 |
EnableDHCPServer |
選用 |
布林值 |
表示端點是否可以使用 DHCP 伺服器來尋找登錄器。若為 True，用戶端將在第一次啟動時傳送 DHCP 通知訊息，而 DHCP 伺服器會傳送可用來登入使用者之登錄器的完整網域名稱 (FQDN) 來回應 |
MaxEndpointExpiration |
選用 |
整數 |
端點登入時，會看到要求到期逾時的選項；這個選項能指定端點在必須聯絡伺服器並要求延長之前，仍可在系統上保留登入狀態的時間間隔。MaxEndpointExpiration 屬性代表可以授與用戶端的時間長度上限。例如，如果時間上限設為 600 秒，而用戶端要求 800 秒的逾時間隔，則用戶端將獲得最高允許的到期時間：600 秒。 MaxEndpointExpiration 必須介於 300 (5 分鐘) 與 900 (15 分鐘) 之間。預設值為 900。 |
MaxEndpointsPerUser |
選用 |
整數 |
表示使用者可以同時用來連接至系統的端點數上限 例如，同時使用電腦和行動電話登入 Lync Server 2010 的使用者算使用兩個端點。MaxEndPointsPerUser 必須設為介於 1 與 64 (含) 之間的值。預設值為 8。 |
MinEndpointExpiration |
選用 |
整數 |
端點登入時，會看到要求到期逾時的選項；這個選項能指定端點在必須聯絡伺服器並要求延長之前，仍可在系統上保留登入狀態的時間間隔。MinEndpointExpiration 屬性代表可以授與用戶端的時間長度下限。例如，如果時間下限設為 600 秒，而用戶端要求 200 秒的逾時間隔，則用戶端將獲得最低允許的到期時間：600 秒。 MinEndpointExpiration 必須介於 300 (5 分鐘) 與 900 (15 分鐘) 之間。預設值為 300。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 物件。Set-CsRegistrarConfiguration 接受登錄器設定物件管線傳送的執行個體。
傳回類型
Set-CsRegistrarConfiguration 不會傳回值或物件。而是此指令程式會設定 Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True
上述命令會修改已套用至 Redmond 站台的登錄器組態設定 (-Identity site:Redmond)。在此範例中，EnableDHCPServer 屬性的值會設為 True。
-------------------------- 範例 2 --------------------------
Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8} | Set-CsRegistrarConfiguration -MaxEndpointsPerUser 8
在範例 2 中，會修改任何允許使用者具有超過 8 個端點的登錄器組態設定。為了執行此工作，命令會先呼叫沒有任何參數的 Get-CsRegistrarConfiguration；這會傳回組織中使用之所有登錄器組態設定的集合。然後，將此集合傳送至 Where-Object，這會只挑出 MaxEndpointsPerUser 屬性大於 (-gt) 8 的設定。最後，將篩選過的集合傳送至 Set-CsRegistrarCollection，這樣會將該集合中每一個項目的端點數上限都設為 8。
-------------------------- 範例 3 --------------------------
Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False
範例 3 所示的命令會透過 DHCP，針對組織中的每個站台停用託管登錄器組態設定集合的用戶端登錄。為達成此目的，命令會呼叫 Get-CsRegistrarConfiguration 搭配 Filter 參數；參數值 "site:*" 會將傳回的資料限制為在站台範圍設定的設定。然後，系統會將此集合傳送給 Set-CsRegistrarConfiguration，以使用 EnableDHCPServer 參數和 $False 參數值，來防止用戶端使用 DHCP 伺服器尋找登錄器。