Compartir a través de

  • Artículo

Get-CsBlockedDomain

 

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

Devuelve información acerca de los dominios que están incluidos en la lista de dominios bloqueados para la federación. Por definición, no se permite que sus usuarios usen aplicaciones de Microsoft Lync Server 2010 para comunicarse con personas del dominio bloqueado; por ejemplo, los usuarios no pueden usar Microsoft Lync 2010 para intercambiar mensajes instantáneos con cualquier persona con una cuenta Protocolo de inicio de sesión (SIP) en un dominio que aparece en la lista de bloqueados.

Sintaxis

Get-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsBlockedDomain [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

La federación es una manera en la que dos organizaciones pueden establecer una relación de confianza que facilite la comunicación entre 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 Lync 2010. Lync Server 2010 permite sacar partido de tres tipos de federación: 1) la federación directa entre su organización y otra; 2) la federación entre su organización y un proveedor público y 3) la federación entre su organización y un proveedor que hospeda a un tercero.

El establecimiento de la federación directa con otra organización implica diversas tareas. Para empezar, debe configurar el servicio Lync Server Access Edge para permitir la federación. Además, la otra organización debe habilitar la federación con usted; no se puede establecer la federación a menos que ambas partes acepten la relación.

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

El cmdlet Get-CsBlockedDomain le permite devolver información acerca de los dominios que aparecen en la lista de dominios bloqueados.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsBlockedDomain localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsBlockedDomain"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Nombre del dominio a devolver. Los dominios se enumeran en la lista de bloqueados según su nombre de dominio completo (FQDN); por lo tanto, el parámetro Identity de un dominio dado será similar a fabrikam.com o contoso.net. Tenga en cuenta que no es posible usar caracteres comodines al especificar el parámetro Identity de un dominio. Para usar comodines en la recuperación de un dominio dado (o un conjunto de dominios), use el parámetro Filter.

Si no se especifica este parámetro, se devolverán todos los dominios de la lista de bloqueados.

Filter

Opcional

Cadena de caracteres

Le permite usar caracteres comodín a fin de recuperar uno o varios dominios de la lista de dominios bloqueados. Para recuperar todos los dominios cuyo parámetro Identity comience con la letra "r", use esta sintaxis: -Filter r*. Para recuperar todos los dominios cuyo parámetro Identity termine con ".net", use esta sintaxis: -Filter "*.net". Para recuperar todos los dominios cuyo parámetro Identity comience con la letra "f" o con la letra "g", use esta sintaxis: -Filter [fg]*.

LocalStore

Opcional

Parámetro modificador

Recupera los datos del dominio bloqueado desde una réplica local de Almacén de administración central, en lugar de Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsBlockedDomain no acepta entradas canalizadas.

Tipos de valores devueltos

Devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain.

Ejemplo

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

Get-CsBlockedDomain

El comando que se muestra en el Ejemplo 1 devuelve una recopilación de todos los dominios incluidos en la lista de dominios bloqueados. Esto se lleva a cabo llamando a Get-CsBlockedDomain sin ningún parámetro adicional.

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

Get-CsBlockedDomain -Identity fabrikam.com

En el Ejemplo 2, el único dominio bloqueado que se devuelve es el que tiene el parámetro Identity "fabrikam.com". Dado que los dominios de la lista de bloqueados deben tener identidades únicas, este comando devolverá, como máximo, un único elemento.

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

Get-CsBlockedDomain -Filter *.net

En el Ejemplo 3, se usa el parámetro Filter para devolver una recopilación de todos los dominios bloqueados que tienen una identidad que termina con el valor de cadena ".net". Este comando de muestra devuelve dominios, por ejemplo, northwindtraders.net, contoso.net y fabrikam.net.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null}

El comando anterior devuelve una recopilación de todos los dominios en donde la propiedad Comment no tiene ningún valor. Para llevar a cabo esta tarea, el comando primero usa Get-CsBlockedDomain, que devuelve una recopilación de todos los dominios de la lista de bloqueados. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona solo aquellos dominios donde la propiedad Comment es igual a un valor nulo.

-------------------------- Ejemplo 5 --------------------------

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

En el Ejemplo 5, se devuelven todos los dominios bloqueados que incluyen el valor de cadena "Ken Myer" en alguna parte de la propiedad Comment. Para llevar a cabo esta tarea, primero se llama a Get-CsBlockedDomain para devolver una recopilación de todos los dominios de la lista de dominios bloqueados. Luego, esta recopilación se canaliza hacia Where-Object, el cual elige aquellos dominios donde la propiedad Comment contiene el valor de cadena "Ken Myer".