New-CsSipProxyRealm
Última modificación del tema: 2012-03-27
Usado para asignar el dominio kerberos predeterminado (servicio de comunicaciones SIP) a una recopilación de opciones de configuración proxy. Los dominios kerberos (también denominados dominios de protección) se usan para autenticar las credenciales de usuario durante el inicio de sesión.
Sintaxis
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
Descripción detallada
Los servidores proxy permiten a los usuarios externos a la red interna obtener acceso a recursos de dicha red. Cada servidor proxy debe estar asociado con un dominio kerberos; los dominios kerberos (también conocidos como dominios de protección) indican donde se deben procesar las credenciales de inicio de sesión del usuario. De forma predeterminada, Microsoft Lync Server 2010 usa el servicio de comunicaciones SIP como dominio predeterminado; sin embargo, es posible cambiar el dominio kerberos que usa un servidor proxy. Los cmdlets New-CsSipProxyUseDefault y New-CsSipProxyCustom permiten cambiar el dominio que usa un servidor proxy. Estos cambios también pueden realizarse con New-CsSipProxyRealm. No obstante, puesto que este cmdlet requiere un paso adicional es posible que prefiera usar los otros dos cmdlets cuando tenga que cambiar el dominio kerberos que usa un servidor proxy.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsSipProxyRealm de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipProxyRealm"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
RealmChoice |
Requerido |
Objeto SipProxy.IRealmChoice |
Objeto que representa el dominio kerberos que usará un servidor proxy. RealmChoice debe crearse con el cmdlet New-CsSipProxyUseDefault o con el cmdlet New-CsSipProxyCustom. |
Tipos de entrada
Ninguno. New-CsSipProxyRealm no acepta entradas transferidas.
Tipos de valores devueltos
New-CsSipProxyRealm crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
Los comandos mostrados en el ejemplo 1 asignan el dominio predeterminado (servicio de comunicaciones SIP) a una variable denominada $y. Para ello, el primer comando llama a New-CsSipProxyUseDefault para crear un objeto SipProxy.UseDefault; este objeto se almacena en una variable denominada $x.
En el segundo comando se usa $x como valor de parámetro para New-CsSipProxyRealm y el parámetro RealmChoice. A su vez, se crea un nuevo objeto de dominio proxy que se almacena en una variable denominada $y.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
Los comandos mostrados en el ejemplo 2 asignan un dominio personalizado (servicio de comunicaciones Litwareinc) a una variable denominada $y. Para ello, el primer comando llama a New-CsSipProxyCustom para crear un objeto SipProxy.Custom; este objeto que usa el servicio de comunicaciones Litwareinc de CustomValue) se almacena en una variable denominada $x.
En el segundo comando, se usa $x junto con el cmdlet New-CsSipProxyRealm y el parámetro –RealmChoice para crear un objeto de dominio personalizado.