Compartir a través de

  • Artículo

Set-CsAllowedDomain

 

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

Modifica valores de propiedad para un dominio (o dominios) incluido en la lista de dominios aprobados para la 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 el dominio federado.

Sintaxis

Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-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.

El cmdlet Set-CsAllowedDomain permite modificar los valores de propiedad de cualquier dominio de la lista de dominios permitidos.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

Nombre de dominio completo (FQDN) del dominio permitido cuyos valores de propiedad se van a modificar. Por ejemplo:

-Identity fabrikam.com

Instance

Opcional

Objeto de 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

Valor de cadena de caracteres opcional que proporciona información adicional sobre el dominio que se está modificando. Por ejemplo, puede agregar un comentario que proporciona información de contacto para el dominio federado.

MarkForMonitoring

Opcional

Booleano

Indica si la conexión de federación entre su dominio y el dominio remoto se supervisará mediante el Servidor de supervisión. De forma predeterminada, el valor de MarkForMonitoring es False, lo que significa que la conexión no se supervisará.

Esta propiedad se omitirá si no ha implementado el Servidor de supervisión.

ProxyFqdn

Opcional

Fqdn

Nombre de dominio completo (por ejemplo, proxy-server.fabrikam.com) del servidor proxy SIP implementado en el dominio que se agrega a la lista de dominios permitidos. Esta propiedad es opcional: si no se especifica, se utilizan los procedimientos de detección DNS SRV para determinar la ubicación del servidor proxy SIP.

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. Set-CsAllowedDomain acepta las instancias transferidas del objeto de dominio permitido.

Tipos de valores devueltos

Set-CsAllowedDomain no devuelve valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain.

Ejemplo

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

Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

El comando mostrado en el Ejemplo 1 modifica la propiedad Comment del dominio permitido con el valor de Identity "fabrikam.com". Para ello, se incluye el parámetro Comment y el valor de parámetro apropiado: "Contact: Ken Myer (kenmyer@fabrikam.com)".

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

Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True

El comando anterior modifica las propiedades Comment y MarkForMonitoring de todos los dominios permitidos que tengan el valor de cadena de caracteres "fabrikam" en la identidad. Para llevar a cabo esta tarea, el comando llama primero a Get-CsAllowedDomain junto con el parámetro Filter. El valor de filtro "*fabrikam*" indica a Get-CsAllowedDomain que devuelva los dominios en los que Identity incluya el valor de cadena de caracteres "fabrikam". (Por ejemplo, este comando devuelve dominios como fabrikam.com, us.fabrikam.net y fabrikam-users.org). A continuación, la colección filtrada se transfiere a Set-CsAllowedDomain, que modifica la propiedad Comment y establece la propiedad MarkForMonitoring en True ($True) para todos los elementos incluidos en la colección.

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

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

El comando mostrado en el Ejemplo 3 modifica todos los dominios de la lista de dominios permitidos que no estén siendo supervisados por el Servidor de supervisión. (Es decir, todos los dominios cuya propiedad MarkForMonitoring esté establecida en False). Para ello, se llama a Get-CsAllowedDomain sin parámetros adicionales para recuperar una colección de todos los dominios que se encuentran en la lista de permitidos. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona los dominios en los que MarkForMonitoring sea igual a False. A continuación, la colección filtrada se transfiere a Set-CsAllowedDomain, que establece la propiedad MarkForMonitoring de todos los dominios de la colección en True.

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

Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."

En el Ejemplo 4, se agrega un comentario genérico ("Need contact information.") a todos los dominios de la lista de permitidos en que la propiedad Comment no tenga ningún valor. Para ello, el comando primero llama a 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 únicamente selecciona los dominios cuya propiedad Comment sea igual a un valor nulo. A continuación, la colección filtrada se transfiere a Set-CsAllowedDomain, que modifica la propiedad Comment en todos los elementos de la colección.