Compartir a través de

  • Artículo

Remove-CsAllowedDomain

 

Última modificación del tema: 2012-03-26

Quita un dominio de la lista de dominios aprobados para la federación.

Sintaxis

Remove-CsAllowedDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La federación es un mecanismo mediante el cual dos organizaciones pueden establecer una relación de confianza que facilita la comunicación entre los dos grupos. Cuando se ha establecido una federación, los usuarios de ambas organizaciones pueden enviarse mensajes instantáneos, suscribirse para recibir notificaciones de presencia y comunicarse entre sí usando aplicaciones SIP, como Microsoft Lync 2010. Microsoft Lync Server 2010 permite sacar partido de tres tipos de federación: 1) federación directa entre su organización y otra organización; 2) federación entre su organización y un proveedor público y 3) federación entre su organización y un proveedor de hospedaje de terceros.

Establecer una federación directa con otra organización implica varias tareas. Para comenzar, debe habilitar los servidores que ejecutan el servicio perimetral de acceso de Lync Server para permitir la federación. Además, la otra organización debe habilitar la federación con usted; la relación de federación no se puede establecer a menos que ambas partes estén de acuerdo.

Para configurar una relación federada, es posible que también sea necesario administrar dos listas relacionadas con la federación: la lista de dominios permitidos y la lista de dominios bloqueados. La lista de dominios permitidos representa las organizaciones con las que usted ha decidido establecer una relación de federación. Si un dominio aparece en la lista de dominios permitidos (según las opciones de configuración), los usuarios podrán intercambiar mensajes instantáneos e información de presencia con los usuarios que tengan cuentas en dicho dominio federado. Por el contrario, la lista de dominios bloqueados engloba los dominios con los que los usuarios tienen expresamente prohibido federarse. Por ejemplo, Lync Server 2010 rechazará automáticamente los mensajes enviados desde un dominio bloqueado.

Si desea interrumpir una relación de federación, use el cmdlet Remove-CsAllowedDomain para quitar el dominio pertinente de la lista de dominios permitidos y, a continuación, si lo cree conveniente, use New-CsBlockedDomain para agregar el domino a la lista de dominios bloqueados. Observe que un dominio no puede aparecer simultáneamente en ambas listas, la de dominios permitidos y la de bloqueados.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Remove-CsAllowedDomain: 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-CsAllowedDomain"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

El nombre de dominio completo (FQDN) del dominio que se va a quitar de la lista de dominios permitidos, por ejemplo, fabrikam.com. No se pueden usar caracteres comodín para especificar la identidad de un dominio.

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.WritableConfig.Settings.Edge.AllowedDomain. Remove-CsAllowedDomain acepta las instancias transferidas del objeto de dominio permitido.

Tipos de valores devueltos

Elimina instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Remove-CsAllowedDomain -Identity fabrikam.com

El comando mostrado en el Ejemplo 1 quita el dominio fabrikam.com de la lista de dominios permitidos.

-------------------------- Ejemplo 2 ------------------------

Get-CsAllowedDomain -Filter *fabrikam* | Remove-CsAllowedDomain

En el Ejemplo 2, todos los dominios que tengan el valor de cadena de caracteres "fabrikam" en su identidad se quitan de la lista de dominios permitidos. Para ello, el comando primero usa Get-CsAllowedDomain y el parámetro Filter para devolver una colección de dominios que tengan el valor de cadena de caracteres "fabrikam" en su identidad (Identity es la única propiedad por la que se puede filtrar). A continuación, la colección filtrada se transfiere a Remove-CsAllowedDomain que, a su vez, quita todos los elementos de la colección filtrada de la lista de dominios permitidos.

-------------------------- Ejemplo 3 ------------------------

Get-CsAllowedDomain | Where-Object {$_.ProxyFqdn -eq $Null} | Remove-CsAllowedDomain

En el Ejemplo 3 se quitan todos los dominios que no tengan un servidor proxy identificado de la lista de dominios permitidos. Para llevar a cabo esta tarea, se llama a Get-CsAllowedDomain para devolver una colección de todos los dominios que figuran en la lista de dominios permitidos. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona los dominios cuya propiedad ProxyFqdn sea igual a un valor nulo. A continuación, la colección filtrada se transfiere a Remove-CsAllowedDomain, que quita todos los dominios incluidos en la colección de la lista de dominios permitidos.

-------------------------- Ejemplo 4 ------------------------

Get-CsAllowedDomain | Where-Object {$_.Comment -match "Ken Myer"} | Remove-CsAllowedDomain

En el ejemplo anterior, todos los dominios cuyo campo Comment contiene el valor de cadena "Ken Myer" se quitan de la lista de dominios permitidos. Para ello, el comando primero usa Get-CsAllowedDomain para recuperar una colección de todos los dominios que figuran en la lista de dominios permitidos. Dicha colección se transfiere al cmdlet Where-Object, que solo selecciona los dominios cuya propiedad Comment contenga el valor de cadena "Ken Myer". A continuación, la colección filtrada se transfiere a Remove-CsAllowedDomain, que quita todos los elementos incluidos en la colección de la lista de dominios permitidos.