Compartir a través de

  • Artículo

New-CsBlockedDomain

 

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

Agrega un dominio a la lista de dominios bloqueados para la federación. Por definición, los usuarios no pueden 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 que tenga una cuenta SIP en un dominio que aparezca en la lista de dominios bloqueados.

Sintaxis

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

New-CsBlockedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <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 Lync 2010. 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 establecer una relación federada, también debe administrar dos listas 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 bloqueada 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.

El cmdlet New-CsBlockedDomain permite agregar un dominio a la lista de dominios bloqueados.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) del dominio que se debe agregar a la lista de dominios bloqueados; por ejemplo, "fabrikam.com". Puede usar el parámetro Identity o Domain (pero no ambos) para especificar el nombre de dominio. Si usa Identity, la propiedad Domain se establecerá en el mismo valor que tenga asignado Identity. En cambio, si usa Domain, la propiedad Identity se establecerá en el mismo valor que tenga asignado Domain.

Tenga en cuenta que las identidades deben ser únicas: si el dominio especificado ya existe en la lista de dominios bloqueados o permitidos, el comando no se completará correctamente.

Comment

Opcional

Cadena de caracteres

Valor de cadena de caracteres opcional que proporciona información adicional sobre el dominio bloqueado. Por ejemplo, puede agregar un comentario que explique por qué se ha bloqueado el dominio.

Domain

Opcional

Cadena de caracteres

FQDN (por ejemplo, fabrikam.com) del dominio que se va a agregar a la lista bloqueada. Puede usar el parámetro Identity o Domain (pero no ambos) para especificar el nombre de dominio. Si usa Identity, la propiedad Domain se establecerá en el mismo valor que tenga asignado Identity. En cambio, si usa Domain, la propiedad Identity se establecerá en el mismo valor que tenga asignado Domain.

Tenga en cuenta que los dominios deben ser únicos: si el dominio especificado ya existe en la lista de dominios bloqueados o permitidos, el comando no se completará correctamente.

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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. New-CsBlockedDomain no acepta la entrada transferida.

Tipos de valores devueltos

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

Ejemplo

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

New-CsBlockedDomain -Identity "fabrikam.com" -Comment "Blocked per Ken Myer."

En el ejemplo anterior, se agrega el dominio fabrikam.com a la lista de dominios bloqueados. Para ello, se llama a New-CsBlockedDomain con el parámetro Identity, que se asigna el nombre del dominio que se va a bloquear. Además, se incluye el parámetro Comment para agregar un comentario al dominio bloqueado. Tenga en cuenta que este comando no se completará correctamente si fabrikam.com ya se encuentra en la lista de bloqueados o de permitidos.

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

$x = New-CsBlockedDomain -Identity "fabrikam.com" -InMemory
$x.Comment = "Blocked per Ken Myer."
Set-CsBlockedDomain -Instance $x

El Ejemplo 2 demuestra cómo puede utilizar el parámetro InMemory para crear un nuevo dominio bloqueado que inicialmente solo existe en la memoria. Después de modificar los valores de propiedad de este dominio exclusivo de la memoria, puede llamar a Set-CsBlockedDomain para agregar el dominio a la lista de bloqueados.

Para ello, en la primera línea del comando se usa New-CsBlockedDomain y el parámetro InMemory para crear un dominio bloqueado con la identidad fabrikam.com. Tras la creación, este dominio virtual se almacena en la variable $x.

En la segunda línea, se modifica la propiedad Comment del dominio virtual. A continuación, en la línea 3 se usa el cmdlet Set-CsBlockedDomain para agregar el dominio virtual a la lista de bloqueados. Si se omitiera la línea 3, el dominio virtual solo existiría en la memoria y nunca se agregaría a la lista de bloqueados. En su lugar, el dominio virtual desaparecerá en cuanto finalice la sesión de Windows PowerShell o elimine la variable $x.