Compartir a través de

  • Artículo

New-CsPublicProvider

 

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

Crea una relación de federación con un nuevo proveedor público. Un proveedor público es una organización que suministra mensajería instantánea, presencia y servicios relacionados al público en general. Microsoft Lync Server 2010 incluye tres proveedores públicos configurados pero no habilitados: Yahoo!, AOL ni MSN.

Sintaxis

New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 establece una federación, los usuarios de ambas organizaciones pueden enviarse mensajes instantáneos entre sí, suscribirse a las notificaciones de presencia y comunicarse entre sí de otras maneras, a través de aplicaciones SIP, como Microsoft Lync 2010. Lync Server 2010 permite 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.

Un proveedor público es una organización que suministra servicios de comunicación SIP para el público en general. Al establecer una relación de federación con un proveedor público, de hecho establece federación con cualquier usuario que tenga una cuenta hospedada en dicho proveedor. Por ejemplo, si se federa con MSN, 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 federar con un proveedor público, debe crear y habilitar un nuevo proveedor público. (Además, el proveedor público deberá crear una relación de federación con usted). Set-CsPublicProvider le permite modificar los valores de propiedad de cualquiera de los proveedores públicos que fueron configurados para la organización.

Tenga en cuenta que no puede establecer una federación con un proveedor público si los servidores perimetrales están configurados para usar el enrutamiento predeterminado, en lugar del enrutamiento del servidor DNS.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

Identificador único para el proveedor público que va a crearse. La identidad es generalmente el nombre del sitio web que suministra los servicios (por ejemplo, Yahoo!; AOL; o MSN).

Las identidades deben ser únicas, no solamente entre los proveedores públicos, sino también entre los proveedores de hospedaje. Supongamos que desea crear un nuevo proveedor público con el parámetro Identity Fabrikam. Si ya existe un proveedor público o de hospedaje con dicho parámetro Identity, el comando producirá un error.

ProxyFqdn

Requerido

Fqdn

Especifica el nombre de dominio completo (FQDN) (por ejemplo, proxyserver.fabrikam.com) del servidor proxy que usa el proveedor público.

Los nombres completos de dominio de proxy (FQDN) deben ser únicos, no solamente entre los proveedores públicos, sino también entre los proveedores de hospedaje. Por ejemplo, suponiendo que intente crear un nuevo proveedor público con el FQDN de proxy proxyserver.fabrikam.com. Este comando producirá un error si ya existe un proveedor público o un proveedor de hospedaje con dicho FQDN de proxy.

Enabled

Requerido

Booleano

Indica si la relación de federación entre la organización y el proveedor público está activa. Si está definido en True, los usuarios de la organización podrán intercambiar mensajes instantáneos e información de presencia con los usuarios que tienen cuentas hospedadas en el proveedor público. Si está definido en False, los usuarios de la organización no podrán intercambiar mensajes instantáneos ni información de presencia con los usuarios que tienen cuentas hospedadas en el proveedor público. Puede habilitar y deshabilitar las relaciones de federación en cualquier momento, con los cmdlets Enable-CsPublicProvider y Disable-CsPublicProvider respectivamente.

VerificationLevel

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. El VerificationLevel debe estar establecido en alguno de los valores siguientes:

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á. 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

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

InMemory

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

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno. New-CsPublicProvider no acepta una entrada canalizada.

Tipos de valores devueltos

Crea instancias nuevas del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Ejemplo

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

New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

El comando que se muestra en el Ejemplo 1 crea una nueva relación de federación con un proveedor público cuyo parámetro Identity es Fabrikam. Además de especificar el parámetro Identity, se deben definir dos valores de propiedad más (con sus parámetros correspondientes): ProxyFqdn (definido en proxyserver.fabrikam.com) y Enabled (que, en este caso, está definido en True).

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

$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x

En el Ejemplo 2 se demuestra cómo crear un nuevo proveedor público solo en memoria, modificar las propiedades de dicho proveedor y, después, convertirlo en un proveedor real que la organización puede usar. Para ello, el primer comando del ejemplo crea un proveedor público cuyo parámetro Identity sea Fabrikam. Además de incluir los parámetros obligatorios (Identity, ProxyFQDN y Enabled), el comando añade el parámetro InMemory; esto crea una instancia del proveedor solo en memoria, que luego se almacena en una variable llamada $x.

Después de que se ha creado la instancia en memoria del proveedor, el segundo comando en el ejemplo modifica el parámetro VerificationLevel del proveedor virtual. A continuación, el comando final usa Set-CsPublicProvider para convertir el proveedor virtual (almacenado en $x) en un proveedor público real. Si no llama a Set-CsPublicProvider, el proveedor real no se creará. A su vez, el proveedor virtual desaparecerá en el momento en que cierre su sesión de Windows PowerShell o que elimine la variable $x.