Compartir a través de

  • Artículo

Set-CsBlockedDomain

 

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

Modifica la propiedad Comment de uno o más de los dominios incluidos en la lista de dominios bloqueados para la federación. Por definición, no se permite a sus usuarios usar 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 SIP en un dominio que aparece en la lista de bloqueo.

Sintaxis

Set-CsBlockedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsBlockedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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. 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 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.

La propiedad Comment, que es la única propiedad de un dominio bloqueado que se puede modificar, se usa para almacenar información adicional sobre el dominio de la lista bloqueada (por ejemplo, por qué el dominio está bloqueado; cuándo se puede quitar el dominio de la lista bloqueada; con quién se debe comunicar si desea quitar el dominio de la lista bloqueada, etc.). Si necesita cambiar la propiedad Comment de cualquier dominio en la lista de dominios bloqueados, use el cmdlet Set-CsBlockedDomain.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) del dominio bloqueado para el que se está modificando la propiedad Comment. Por ejemplo: fabrikam.com

Instance

Opcional

Objeto Dominio bloqueado

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Comment

Opcional

Cadena de caracteres

Permite proporcionar información adicional acerca del dominio que se está modificando. Por ejemplo, podría agregar un Comment que indique por qué el dominio se ha ubicado en la lista bloqueada.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse 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.BlockedDomain. Set-CsBlockedDomain acepta las instancias canalizadas del objeto del dominio bloqueado

Tipos de valores devueltos

Set-CsBlockedDomain no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.BlockedDomain.

Ejemplo

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

Set-CsBlockedDomain -Identity fabrikam.com -Comment "Block this domain pending legal review."

El comando que se muestra en el ejemplo 1 modifica el comentario del dominio bloqueado con identidad "fabrikam.com". En este ejemplo, el parámetro Comment se incluye junto con el valor del parámetro, "Block this domain pending legal review".

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

Get-CsBlockedDomain | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

En el ejemplo anterior, la propiedad Comment se actualiza para todos los dominios incluidos en la lista de dominios bloqueados. Para ello, el comando primero llama a Get-CsBlockedDomain, que devuelve una recopilación de todos los dominios que se encuentran actualmente en la lista de dominios bloqueados. Esa recopilación después se canaliza a Set-CsBlockedDomain, que procede a modificar la propiedad Comment de cada dominio de la recopilación.

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

Get-CsBlockedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsBlockedDomain -Comment "Block this domain pending legal review."

En el ejemplo 3, se agrega el nuevo comentario ("Block this domain pending legal review") a cada dominio de la lista bloqueada que aún no tenga un valor configurado para la propiedad Comment. Para llevar a cabo esta tarea, el comando primero usa Get-CsBlockedDomain, que devuelve una recopilación de todos los dominios que se encuentran actualmente en la lista bloqueada. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige solo aquellos dominios donde la propiedad Comment es igual a un valor nulo. La recopilación filtrada se canaliza a Set-CsBlockedDomain, que asigna el mismo comentario a la propiedad Comment de cada dominio de la recopilación filtrada.