Get-CsSipDomain
Última modificación del tema: 2012-03-23
Devuelve información sobre los dominios SIP configurados para su uso en la organización. Los dominios SIP son dominios autorizados para enviar y recibir tráfico SIP y se usan para asignar direcciones SIP a los usuarios.
Sintaxis
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
Descripción detallada
Para configurar direcciones SIP para los usuarios (y, por tanto, habilitarlos para usar software relacionado con SIP, como Microsoft Lync 2010) necesita dos cosas: un ID de usuario (por ejemplo, Ken.Myer) y un dominio SIP (por ejemplo, litwareinc.com). El dominio SIP usado para generar una dirección SIP debe ser un dominio que esté ubicado dentro de su bosque de Active Directory que esté autorizado para enviar y recibir tráfico SIP. Por ejemplo, imagine que tiene tres dominios denominados litwareinc.com, fabrikam.com y contoso.com, pero únicamente se ha identificado como dominio SIP a litwareinc.com. En este caso, no puede usar una dirección SIP como sip:Ken.Myer@fabrikam.com o sip:Ken.Myer@contoso.com, a menos que fabrikam.com y contoso.com se configuren como dominios SIP válidos. Para hacer esto, debe ejecutar el cmdlet New-CsSipDomain.
El cmdlet Get-CsSipDomain es una vía para devolver información acerca de los dominios SIP autorizados para usar en la organización. Get-CsSipDomain identifica también el dominio SIP predeterminado para la organización; se trata del dominio que usará Microsoft Lync Server 2010 de forma predeterminada si no se especifica ningún dominio SIP.
Quién puede ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsSipDomain: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del dominio SIP que se debe devolver (por ejemplo, fabrikam.com). Si no se especifica este parámetro ni el parámetro Filter, se devolverán todos los dominios SIP autorizados para su uso en la organización. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para especificar las identidades del dominio (o dominios) SIP que se deben devolver. Por ejemplo, el valor de filtro "*.org" devuelve una colección de todos los dominios SIP autorizados con una identidad que acaba con el valor de cadena ".org". |
Tipos de entrada
Ninguno. Get-CsSipDomain no acepta los datos transferidos.
Tipos de valores devueltos
Get-CsSipDomain devuelve instancias del objeto Microsoft.Rtc.Management.Xds.SipDomain.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsSipDomain
En el Ejemplo 1, se llama a Get-CsSipDomain sin ningún parámetro, con lo cual se devuelve información sobre todos los dominios SIP configurados para su uso en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
El comando que se muestra en el Ejemplo 2 devuelve información sobre cualquier dominio SIP con la identidad fabrikam.com. Dado que las identidades de dominio SIP deben ser únicas, este comando nunca devolverá más de un elemento.
-------------------------- Ejemplo 3 ------------------------
Get-CsSipDomain -Filter "f*"
El comando anterior utiliza Get-CsSipDomain y el parámetro Filter para devolver información sobre todos los dominios SIP con una identidad que empieza por la letra "f". Por ejemplo: fabrikam.com; fabrikam.org; fabrikam-users.com; etc.
-------------------------- Ejemplo 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
El comando del Ejemplo 4 devuelve información acerca del dominio SIP predeterminado. Para ello, en primer lugar se llama a Get-CsSipDomain sin ningún parámetro para devolver una colección de todos los dominios SIP configurados para uso en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona el único dominio en el que la propiedad IsDefault es igual a True.