New-CsSipDomain
Última modificación del tema: 2012-03-27
Crea un nuevo dominio SIP en su organización. Los dominios SIP son dominios autorizados para enviar y recibir tráfico SIP y sirven para asignar direcciones SIP a los usuarios.
Sintaxis
New-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-WhatIf [<SwitchParameter>]]
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 y 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.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsSipDomain localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsSipDomain"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) para el nuevo dominio SIP. Por ejemplo: -Identity fabrikam.com. |
IsDefault |
Opcional |
Booleano |
Indica si el dominio es el dominio SIP predeterminado, el dominio usado por Lync Server 2010 siempre que un nombre de dominio no esté explícitamente establecido. Si se establece en True, el nuevo dominio también se convertirá en el nuevo dominio predeterminado. El valor predeterminado para IsDefault es False. Si no desea que el nuevo dominio sea el dominio predeterminado, simplemente puede omitir el parámetro. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. New-CsSipDomain no acepta datos transferidos.
Tipos de valores devueltos
New-CsSipDomain crea nuevas instancias del objeto Microsoft.Rtc.Management.Xds.SipDomain.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsSipDomain -Identity fabrikam.com
El comando que se muestra en el Ejemplo 1 crea un nuevo dominio SIP, uno que tenga el valor Identity fabrikam.com.
-------------------------- Ejemplo 2 ------------------------
New-CsSipDomain -Identity fabrikam.com -IsDefault $True
El comando anterior crea un nuevo dominio SIP llamado fabrikam.com y lo establece como el dominio SIP predeterminado. Al convertir fabrikam.com en el dominio predeterminado, este comando también "relega" el dominio que anteriormente era el dominio SIP predeterminado. Por ese motivo, solo puede tener un dominio SIP predeterminado.