Remove-CsSipDomain
Última modificación del tema: 2012-03-27
Quita un dominio SIP configurado anteriormente 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
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 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.
Después de autorizar un dominio SIP, puede "desautorizarlo" con el cmdlet Remove-CsSipDomain. Este cmdlet quita el dominio especificado de la lista de dominios SIP aprobados. No obstante, tenga en cuenta que no es posible quitar el dominio predeterminado; si desea quitarlo, primero tendrá que configurar otro dominio SIP para que actúe como dominio predeterminado. Si solo dispone de un dominio SIP, se configurará automáticamente como dominio predeterminado y no podrá quitarlo.
Además, no podrá quitar ningún dominio SIP que tenga asignada una o más direcciones SIP. Por ejemplo, no puede quitar Contoso.com como dominio SIP si Ken Myer tiene la dirección SIP "sip:kenmyer@contoso.com". Para quitar un dominio SIP que esté en uso, primero tiene que asignar direcciones SIP nuevas a todos los usuarios que tengan ese dominio en sus direcciones SIP.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsSipDomain de forma local: 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 "Remove-CsSipDomain"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del dominio SIP que se va a quitar: Por ejemplo: -Identity fabrikam.com. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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
Objeto Microsoft.Rtc.Management.Xds.SipDomain. Remove-CsSipDomain acepta las instancias transferidas del objeto de dominio SIP.
Tipos de valores devueltos
Ninguno. En su lugar, Remove-CsSipDomain elimina la instancia existente del objeto Microsoft.Rtc.Management.Xds.SipDomain.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
El comando anterior quita el dominio SIP con la identidad fabrikam.com de la lista de nombres de dominio admitidos. Tenga en cuenta que este comando no se completará correctamente si fabrikam.com es el único dominio SIP que está actualmente en uso en la organización. Esto se debe a que la topología debe incluir como mínimo un comando SIP.
-------------------------- Ejemplo 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
El comando mostrado en el Ejemplo 2 elimina todos los dominios SIP de la organización, excepto el dominio predeterminado. Para ello, el comando primero llama a Get-CsSipDomain para devolver una colección de todos los dominios SIP. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona los dominios cuya propiedad IsDefault sea igual a True. El efecto resultante es que se filtra el dominio predeterminado y los dominios restantes se transfieren a Remove-CsSipDomain donde se eliminan.