New-CsSipProxyRealm
上次修改主題的時間： 2012-03-27
用來將預設領域 (SIP Communications Service) 指派給 Proxy 組態設定的集合。領域 (亦稱為保護網域) 可在登入期間用來驗證使用者憑證。
語法
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
詳細描述
Proxy 伺服器提供一種方式，讓您內部網路之外的使用者可以存取內部網路的資源。每台 Proxy 伺服器都必須關聯至一個領域；領域 (亦稱為保護網域) 會指出應繼續處理使用者登入憑證的位置。根據預設，Microsoft Lync Server 2010 使用 SIP Communications Service 做為其預設領域；但是可能會變更 Proxy 伺服器所使用的領域。New-CsSipProxyUseDefault 和 New-CsSipProxyCustom 指令程式會為您提供一種方式，來變更 Proxy 伺服器所使用的領域。您也可以使用 New-CsSipProxyRealm 來進行這些變更。但由於此指令程式需要其他步驟，因此，每當您需要變更 Proxy 伺服器所使用的領域時，可能會想使用其他兩個指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsSipProxyRealm Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyRealm"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
RealmChoice |
必要 |
SipProxy.IRealmChoice 物件 |
代表 Proxy 伺服器所使用之領域的物件。您必須使用 New-CsSipProxyUseDefault 或 New-CsSipProxyCustom 指令程式來建立 RealmChoice。 |
輸入類型
無。New-CsSipProxyRealm 不會接受管線傳送的資料。
傳回類型
New-CsSipProxyRealm 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
範例 1 所示的命令會將預設領域 (SIP Communications Service) 指派給變數 $y。為此，第一個命令會呼叫 New-CsSipProxyUseDefault 以建立 SipProxy.UseDefault 物件；此物件會儲存在名稱為 $x 的變數中。
在第二個命令中，$x 會用來作為 New-CsSipProxyRealm 和 RealmChoice 參數的參數值。而如此一來會建立新的 Proxy 領域物件，此物件會儲存在名稱為 $y 的變數中。
-------------------------- 範例 2 ------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
範例 2 所示的命令會將自訂領域 (Litwareinc Communications Service) 指派給變數 $y。為此，第一個命令會呼叫 New-CsSipProxyCustom 以建立 SipProxy.Custom 物件；此物件 (使用 CustomValue Litwareinc Communications Service) 會儲存在名稱為 $x 的變數中。
在第二個命令中，會將 $x 與 New-CsSipProxyRealm 指令程式和 RealmChoice 參數搭配使用，來建立新的自訂領域物件。