Compartir a través de

  • Artículo

Get-CsAllowedDomain

 

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

Devuelve información acerca de los dominios incluidos en la lista de dominios aprobados por federación. Después de que un dominio se haya aprobado para la federación (agregándolo a la lista de dominios permitidos), los usuarios pueden intercambiar mensajes instantáneos e información de presencia con las personas que tengan cuentas en ese dominio.

Sintaxis

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

Get-CsAllowedDomain [-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 Microsoft Lync 2010. Microsoft 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. En primer lugar, debe habilitar los servidores perimetrales de acceso 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 permitida (obligatorio si EnablePartnerDiscovery se ha desactivado) representa las organizaciones que ha elegido federar. Si aparece un dominio en la lista permitida entonces (según sus parámetros de configuración) los usuarios podrán intercambiar mensajes instantáneos e información de presencia con usuarios que tienen cuentas en ese dominio federado. 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-CsAllowedDomain ofrece un modo de recuperar información acerca de todos los dominios incluidos en las listas de permitidos.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsAllowedDomain 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-CsAllowedDomain"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Nombre del dominio a devolver. En la lista de permitidos, los dominios se ordenan según su nombre de dominio completo (FQDN); lo cual significa que 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 permitidos.

Filter

Opcional

Cadena de caracteres

Le permite usar caracteres comodín a fin de recuperar uno o varios dominios de la lista de dominios permitidos. Para devolver todos los dominios con una identidad que empiece por 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 "r" o con la letra "g", use esta sintaxis: -Filter [rg]*.

LocalStore

Opcional

Parámetro modificador

Recupera los dominios permitidos desde la réplica local del Almacén de administración central en lugar de recuperarlo desde Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsAllowedDomain no acepta una entrada canalizada.

Tipos de valores devueltos

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

Ejemplo

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

Get-CsAllowedDomain

El comando anterior devuelve una recopilación de todos los dominios incluidos en la lista de dominios aprobados para federación. Llamar a Get-CsAllowedDomain sin ningún parámetro adicional siempre devuelve la recopilación completa de dominios aprobados.

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

Get-CsAllowedDomain -Identity fabrikam.com

En el Ejemplo 2 se devuelve información acerca del dominio permitido cuyo parámetro Identity es "fabrikam.com". Dado que las identidades deben ser únicas, este comando nunca devolverá más de un elemento.

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

Get-CsAllowedDomain -Filter *fabrikam*

El comando que se muestra en el Ejemplo 3 devuelve una recopilación de todos los dominios permitidos que tienen el valor de cadena "fabrikam" en algún lugar de su parámetro Identity. Para ello, el comando usa el parámetro -Filter y el valor de filtro "*fabrikam*". Este valor de filtro le indica a Get-CsAllowedDomain que únicamente devuelva los dominios en donde el parámetro Identity (la única propiedad que puede filtrar) incluya el valor de cadena "fabrikam". Este comando devolverá todos los dominios del tipo: fabrikam.com, fabrikam.net y africa.fabrikam.org

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

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

En el Ejemplo 4, los cmdlets Get-CsAllowedDomain y Where-Object se usan para recuperar una recopilación de todos los dominios en los que no se haya incluido ningún valor para la propiedad ProxyFqdn. Para llevar a cabo esta tarea, se llama en primer lugar a Get-CsAllowedDomain (sin parámetros adicionales) para recuperar una recopilación de todos los dominios permitidos. Esta recopilación luego se transfiere al Where-Object, el cual selecciona únicamente aquellos dominios cuya propiedad ProxyFqdn sea igual a un valor nulo; un valor nulo significa que no se ha incluido ningún valor para la propiedad. Para encontrar todos los dominios que tiene algún valor configurado para la propiedad ProxyFqdn, use esta sintaxis:

Where-Object {$_.ProxyFqdn -ne $Null}

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

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $True}

El comando anterior devuelve todos los dominios permitidos cuyo estado de mantenimiento es comprobado por el Servidor de supervisión. Para ello, primero se usa Get-CsAllowedDomain, para recuperar una recopilación de todos los dominios incluidos en la lista de dominios permitidos. Esa recopilación luego se transfiere al cmdlet Where-Object, el cual escoge únicamente aquellos dominios en los que la propiedad MarkForMonitoring es igual a True.