New-CsRegistrarConfiguration
上次修改主題的時間： 2012-03-25
建立新的登錄器組態設定集合。登錄器可用來驗證登入要求，並維護使用者狀態與可用性的相關資訊。
語法
New-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]
詳細描述
登錄器可能是 Lync Server 中最重要的元件；畢竟，若無登錄器，使用者將無法登入系統，且 Lync Server 也無法追蹤使用者及其目前的狀態。當使用者登入 Lync Server 時，使用者從中登入的端點會傳送 REGISTER 要求給登錄器；而伺服器則以要求用戶端裝置提出驗證認證作為回應。如果用戶端通過質詢 (亦即，如果用戶端呈現一組有效的認證)，則使用者會通過驗證，並將 IP 位址、連接埠與使用者名稱等端點資訊記錄到登錄資料庫中。當使用者登出時，這項資訊便會從資料庫移除。在登入後與登出前的這段時間，登錄器會保持最新的狀態資訊，並協助路由要給該使用者和該使用者傳來的訊息。
登錄器組態設定用於協助管理端點與端點訂閱；這些設定可以在通用、網站或服務範圍內套用。(服務範圍的設定僅能搭配登錄程式服務使用)。
New-CsRegistrarConfiguration 指令程式可讓您在站台或服務範圍建立新的登錄器組態設定。請注意，指定的站台或服務最多只能有一個這種設定集合；如果您嘗試將新的集合加到已經主控登錄器組態設定集合的站台或服務，您的命令將會失敗。如果您嘗試在全域範圍建立新設定，您的命令也會失敗。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsRegistrarConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRegistrarConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要建立之登錄器組態設定的唯一識別碼。若要建立在網站範圍設定的設定，請使用類似如下的語法：-Identity site:Redmond。若要建立服務層級的設定，請使用類似如下的語法：-Identity service:Registrar:atl-cs-001.litwareinc.com。請注意，指定的站台或服務最多只能有一個單一的登錄器設定集合。如果您嘗試使用 Identity site:Redmond 建立新的集合，而且 Redmond 站台已經主控登錄器設定集合，則您的命令將會失敗。 此外，您無法在全域範圍建立新的登錄器設定。如果您要在全域範圍變更值，請使用 Set-CsRegistrarConfiguration 指令程式。 |
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。 |
MinEndpointExpiration |
選用 |
整數 |
端點登入時，會看到要求到期逾時的選項；這個選項能指定端點在必須連絡伺服器並要求延長之前，仍可在系統上保留登入狀態的時間間隔。MinEndpointExpiration 屬性代表可授與用戶端的時間長度下限。例如，如果時間下限設為 600 秒，而用戶端要求的逾時間隔為 200 秒，則用戶端將獲得下列允許的到期時間下限：600 秒。 MinEndpointExpiration 必須介於 300 (5 分鐘) 和 900 (15 分鐘) 之間。預設值為 300。 |
MaxEndpointsPerUser |
選用 |
整數 |
表示使用者可以同時連線到系統的端點數目上限 (例如，同時使用電腦和行動電話登入 Lync Server 2010 的使用者算使用 2 個端點)。MaxEndpointsPerUser 必須設為介於 1 與 64 (含) 之間的值。預設值為 8。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsRegistrarConfiguration 不接受管線傳送的輸入。
傳回類型
New-CsRegistrarConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings 物件的新執行個體。
範例
-------------------------- 範例 1 --------------------------
New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True
以上的命令會針對 Redmond 站台 (-Identity site:Redmond)，建立新的登錄器組態設定集合。除了指定新設定的 Identity 之外，此命令也會將每個使用者的端點上限設為 4 (-MaxEndpointsPerUser 4)，並允許使用 DHCP 伺服器進行用戶端登錄 (-EnableDHCPServer $True)。請注意，如果 Redmond 站台已被指派登錄器組態設定集合，此命令將會失敗。
-------------------------- 範例 2 --------------------------
$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory
$x.MaxEndpointsPerUser = 4
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x
範例 2 所示的命令也會針對 Redmond 站台 (-Identity site:Redmond)，建立新的登錄器組態設定集合。不過，在此範例中，這些設定一開始僅在記憶體中建立，稍後才會套用至站台本身。
若要執行此工作，第一個命令會使用 New-CsRegistrarConfiguration 建立 site:Redmond 的新設定集合；將 InMemory 參數加到命令結尾是為了確保這些設定僅在記憶體中建立，而不會立即套用到 Redmond 站台。由於這些設定只存在於記憶體中，因此必須以變數儲存；在此範例中，這是名稱為 $x 的變數。
在命令 2 和 3 中，這些新虛擬設定的兩個屬性 (MaxEndpointsPerUser 和 EnableDHCPServer) 會經過修改。接著，此範例中的最後一個命令會使用 Set-CsRegistrarConfiguration，將儲存在 $x 中的虛擬設定轉換為套用到 Redmond 站台的一組實際登錄器組態設定。如果您沒有呼叫 Set-CsRegistrarConfiguration，將不會建立 Redmond 站台的新設定，而且只要您結束 Windows PowerShell 工作階段或刪除變數 $x，虛擬設定就會消失。