Compartir a través de

  • Artículo

Remove-CsPublicProvider

 

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

Quita 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 incluye tres proveedores públicos configurados pero no tiene habilitados: Yahoo!, AOL y MSN.

Sintaxis

Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <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 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.) Si, más adelante, decide finalizar la relación, puede usar el cmdlet Remove-CsPublicProvider para eliminar el proveedor público. Cuando elimina un proveedor público, el proveedor se quita de la lista de socios federados y la única forma de volver a establecer la relación es volver a crear el proveedor. Si desea suspender una relación de forma temporánea, use el cmdlet Disable-CsPublicProvider. Cuando se deshabilita un proveedor público, el proveedor no se elimina de la lista de socios federados; en su lugar, simplemente se marca el proveedor como deshabilitado y se suspende la comunicación entre la organización y el proveedor. Para volver a establecer la relación puede usar simplemente Enable-CsPublicProvider para volver a habilitar el proveedor.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

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

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves que se produzcan 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.DisplayPublicProvider. Remove-CsPublicProvider acepta las instancias transferidas del objeto de proveedor público.

Tipos de valores devueltos

Ninguno. En su lugar, el cmdlet elimina las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Ejemplo

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

Remove-CsPublicProvider -Identity "MSN"

El comando anterior elimina el proveedor público con la identidad MSN. Una vez completado este comando, MSN ya no aparecerá en la lista de proveedores públicos configurados y la única forma de volver a establecer la federación con MSN es volver a crear el proveedor.

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

Get-CsPublicProvider | Remove-CsPublicProvider

En el Ejemplo 2 se eliminan todos los proveedores públicos configurados para su uso en la organización. Para ello, el comando primero usa Get-CsPublicProvider para devolver una colección de todos los proveedores públicos configurados actualmente para el uso. A continuación, dicha colección se transfiere a Remove-CsPublicProvider que, a su vez, elimina todos los proveedores de la colección.

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

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

En el Ejemplo 3, todos los proveedores públicos que actualmente están deshabilitados se quitan del conjunto de proveedores públicos configurados. Para llevar a cabo esta tarea, el comando primero usa Get-CsPublicProvider para devolver una colección de todos los proveedores públicos que actualmente están configurados para su uso. Dicha colección se transfiere al cmdlet Where-Object, que únicamente selecciona los proveedores cuya propiedad Enabled sea igual a False. A continuación, la colección filtrada se transfiere a Remove-CsPublicProvider, que elimina todos los elementos de la colección.