Compartir a través de

  • Artículo

Set-CsPublicProvider

 

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

Modifica un proveedor público configurado para su uso en la organización. Un proveedor público es una organización que proporciona servicios de mensajería instantánea (IM), presencia y otros servicios relacionados con el público en general. Microsoft Lync Server 2010 tiene tres proveedores públicos configurados pero no habilitados: Yahoo!, AOL y MSN.

Sintaxis

Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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. 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.

Un proveedor público es una organización que proporciona servicios de comunicación SIP para el público en general. Cuando usted establece una relación de federación con un proveedor público, de hecho establece una federación con cualquier usuario que tenga una cuenta hospedada con dicho proveedor. Por ejemplo, si establece una relación de federación con MSN, en función de cómo haya configurado el sistema, sus usuarios podrán intercambiar mensajes instantáneos e información de presencia con cualquier persona que tenga una cuenta de mensajería instantánea de MSN.

Para establecer una federación con un proveedor público es necesario crear y habilitar un proveedor público nuevo. (Asimismo, el proveedor público tendrá que crear una relación de federación con usted.) Lync Server incluye tres proveedores públicos preconfigurados: Yahoo!, AOL y MSN. A medida que haya disponibles proveedores públicos adicionales, puede crear relaciones de federación con estos nuevos proveedores mediante el cmdlet New-CsPublicProvider. Después de establecer las relaciones federadas, puede usar Set-CsPublicProvider para modificar dos valores de propiedad importantes (Enabled y VerificationLevel) de estas relaciones.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsPublicProvider de manera local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único del proveedor público que se va a modificar. El valor de Identity suele ser el nombre del sitio web que proporciona los servicios (por ejemplo, Yahoo!, AOL, MSN, etc.).

Instance

Opcional

Objeto DisplayPublicProvider

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

Enabled

Opcional

Parámetro modificador

Indica si la relación de federación entre la organización y el proveedor público está activa. Si se define en True, los usuarios de la organización podrán intercambiar mensajes instantáneos e información de presencia con los usuarios que tengan cuentas hospedadas en el proveedor público. Si se define en False, los usuarios de la organización no podrán intercambiar mensajes instantáneos ni información de presencia con los usuarios que tengan cuentas hospedadas en el proveedor público.

VerificationLevel

Opcional

Cadena de caracteres

Indica de qué manera se comprueban (y si se comprueban) los mensajes enviados desde un proveedor público para asegurar que se enviaron realmente desde dicho proveedor. VerificationLevel debe configurarse con uno de los siguientes valores:

AlwaysVerifiable. Todos los mensajes supuestamente enviados desde este proveedor serán aceptados. Si no se encuentra un encabezado de comprobación en el mensaje, Lync Server 2010 lo agregará. Éste es el valor predeterminado.

AlwaysUnverifiable. Todos los mensajes supuestamente enviados desde un proveedor público se consideran no comprobados. Se enviarán solo si los envió una persona que se encuentre en la lista de contactos del destinatario. Por ejemplo, si Ken Myer está en su lista de contactos, podrá recibir mensajes enviados por él. Si Pilar Ackerman no está en su lista de contactos, no podrá recibir mensajes enviados por ella.

UseSourceVerification. Usa el encabezado de comprobación que el proveedor público agregó al mensaje. Si falta la información de comprobación, el mensaje se rechazará.

Force

Opcional

Parámetro modificador

Suprime cualquier aviso de confirmación o mensaje de error leve que se pueda producir al ejecutar el 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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider. Set-CsPublicProvider acepta instancias transferidas del objeto de proveedor público.

Tipos de valores devueltos

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

Ejemplo

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

Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"

El comando anterior define el parámetro VerificationLevel para el proveedor público con el valor de Identity MSN. Para ello, se incluye el parámetro VerificationLevel y el valor de parámetro UseSourceVerification.

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

Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

En el Ejemplo 2, se modifica el nivel de comprobación para todos los proveedores públicos que están actualmente en uso en la organización. Para ello, el comando primero llama a Get-CsPublicProvider sin parámetros para devolver una recopilación de todos los proveedores públicos que están configurados para su uso en la organización. A continuación, la recopilación se transfiere a Set-CsPublicProvider, que cambia el valor de la propiedad VerificationLevel de todos los proveedores de la recopilación a UseSourceVerification.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

El comando mostrado en el Ejemplo 3 modifica el nivel de comprobación de todos los proveedores públicos donde dicho nivel esté definido en AlwaysVerifiable. Para realizar esta tarea, el comando primero llama a Get-CsPublicProvider para devolver una recopilación de todos los proveedores públicos configurados para su uso en la organización. Esta recopilación después se transfiere al cmdlet Where-Object, que elige solo los proveedores donde la propiedad VerificationLevel es igual a AlwaysVerifiable. A su vez, la recopilación filtrada se transfiere a Set-CsPublicProvider, que cambia el valor de VerificationLevel de todos los proveedores de la recopilación a UseSourceVerification.