Compartir a través de

  • Artículo

Get-CsPublicProvider

 

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

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

Sintaxis

Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPublicProvider [-Filter <String>] [-LocalStore <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 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 establecer una federación con un proveedor público es necesario crear y habilitar un proveedor público nuevo. (Además, el proveedor público tendrá que crear una relación de federación con usted.) El cmdlet Get-CsPublicProvider permite devolver información sobre los proveedores públicos que se han configurado para el uso en la organización.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único del proveedor público que se va a devolver. La Identidad es, por lo general, el nombre del sitio web que proporciona los servicios (por ejemplo, Yahoo!, AOL, MSN, etc.).

No puede usar caracteres comodín para especificar la identidad. Si desea usar caracteres comodín para devolver uno o más proveedores públicos, use el parámetro Filter.

Filter

Opcional

Cadena de caracteres

Permite usar valores de caracteres comodín para devolver uno o más proveedores públicos. Por ejemplo, para devolver una colección de todos los proveedores públicos que tengan una identidad que comience por la letra Y, use esta sintaxis: -Filter "Y*". Para devolver una colección de todos los proveedores públicos que incluyan el valor de cadena de caracteres "Windows" en su identidad, use esta sintaxis: -Filter "*Windows*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos del proveedor público de la réplica local de Almacén de administración central en lugar de recuperarlos de Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsPublicProvider no acepta la entrada transferida.

Tipos de valores devueltos

Devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Ejemplo

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

Get-CsPublicProvider

El comando mostrado en el Ejemplo 1 devuelve una recopilación de todos los proveedores públicos que están configurados para su uso en la organización. Al llamar a Get-CsPublicProvider sin parámetros adicionales, siempre se devuelve la colección completa de proveedores públicos.

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

Get-CsPublicProvider -Identity "MSN"

En el Ejemplo 2, se devuelven todos los proveedores públicos que tienen la identidad MSN. Dado que las identidades deben ser únicas entre los proveedores públicos (y entre los proveedores de hospedaje), este comando siempre devolverá, como mucho, un elemento.

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

Get-CsPublicProvider -Filter W*

El comando anterior devuelve todos los proveedores públicos que tienen una identidad que comienza por la letra W. Para ello, se incluye el parámetro Filter y el valor de filtro "W*".

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

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False}

El comando mostrado en el Ejemplo 4, devuelve una recopilación de todos los proveedores públicos que están deshabilitados. Para ello, el comando primero llama a Get-CsPublicProvider para devolver una colección de todos los proveedores públicos configurados para su uso en la organización. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona los proveedores cuya propiedad Enabled sea igual a False.

-------------------------- Ejemplo 5 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}

El comando anterior devuelve todos los proveedores públicos cuya propiedad VerificationLevel esté definida en AlwaysUnverifiable o UseSourceVerification. (Los niveles de comprobación se pueden definir en AlwaysUnverifiable, UseSourceVerification o AlwaysVerifiable.) Para realizar esta tarea, el comando primero llama a Get-CsPublicProvider para devolver una colección de todos los proveedores públicos configurados para su uso en la organización. La colección se transfiere a Where-Object, que únicamente selecciona los proveedores cuya propiedad VerificationLevel no sea igual a AlwaysVerifiable. El efecto resultante es que solo se seleccionan los proveedores cuya propiedad VerificationLevel esté definida en AlwaysUnverifiable o UseSourceVerification.