New-CsSipProxyRealm
上一次修改主题： 2012-03-27
用于为代理配置设置集合分配默认领域（SIP 通信服务）。领域（也称为保护域）用于在登录期间对用户凭据进行身份验证。
语法
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
详细说明
代理服务器提供了一种方法，使内部网络之外的用户可以访问内部网络上的资源。每个代理服务器都必须与一个领域相关联；领域（也称为保护域）指示在哪里处理用户的登录凭据。默认情况下，Microsoft Lync Server 2010 将 SIP 通信服务用作其默认领域；但是，可以更改代理服务器所使用的领域。New-CsSipProxyUseDefault cmdlet 和 New-CsSipProxyCustom cmdlet 提供了一种更改代理服务器所使用领域的方法。也可以使用 New-CsSipProxyRealm 进行这些更改。但由于此 cmdlet 需要另外一个步骤，因此在任何需要更改代理服务器所使用领域的时候，您可能希望使用另外两个 cmdlet。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsSipProxyRealm cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyRealm"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
RealmChoice |
必需 |
SipProxy.IRealmChoice 对象 |
代表代理服务器所使用领域的对象。必须使用 New-CsSipProxyUseDefault cmdlet 或 New-CsSipProxyCustom cmdlet 创建 RealmChoice。 |
输入类型
无。New-CsSipProxyRealm 不接受通过管道传递的输入。
返回类型
New-CsSipProxyRealm 创建 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
示例 1 中显示的命令为名为 $y 的变量分配默认领域（SIP 通信服务）。为执行此操作，第一个命令调用 New-CsSipProxyUseDefault 以创建 SipProxy.UseDefault 对象，此对象存储在名为 $x 的变量中。
在第二个命令中，$x 用作 New-CsSipProxyRealm 和 RealmChoice 参数的参数值。随后，这将创建一个新的代理领域对象，存储在名为 $y 的变量中。
-------------------------- 示例 2 --------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
示例 2 中显示的命令为名为 $y 的变量分配自定义领域（Litwareinc 通信服务）。为执行此操作，第一个命令调用 New-CsSipProxyCustom 以创建 SipProxy.Custom 对象，此对象（使用 CustomValue Litwareinc 通信服务）存储在名为 $x 的变量中。
在第二个命令中，将 $x 用于 New-CsSipProxyRealm cmdlet 和 RealmChoice 参数，以创建新的自定义领域对象。