Compartir a través de

  • Artículo

Disable-CsPublicProvider

 

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

Deshabilita 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, 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

Disable-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Disable-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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í a través de 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 (Protocolo de inicio de sesión) 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.) Cuando crea un proveedor público, tiene la opción de habilitar o deshabilitar dicha relación de federación. Si se habilita un proveedor público, los usuarios de la organización pueden intercambiar mensajes instantáneos e información de presencia con cualquier persona que tenga una cuenta con el proveedor público. Si se deshabilita un proveedor público, se suspenderá la posibilidad de comunicarse con personas que tengan cuentas con el proveedor público, y seguirá suspendida hasta que el proveedor la vuelva a habilitar. Si desea suspender una relación de proveedor de forma temporal, puede usar el cmdlet Disable-CsPublicProvider. Si prefiere eliminar el proveedor, use el cmdlet Remove-CsPublicProvider.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único para el proveedor público que se va a deshabilitar. La identidad es, por lo general, 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.

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.DisplayPublicProvider. Disable-CsPublicProvider acepta las instancias transferidas del objeto de proveedor público.

Tipos de valores devueltos

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

Ejemplo

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

Disable-CsPublicProvider -Identity "MSN"

El comando anterior deshabilita el proveedor público con la identidad MSN. Este comando devuelve un error si MSN ya se ha deshabilitado.

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

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

El Ejemplo 2 deshabilita todos los proveedores públicos que hay habilitados. Para ello, el comando usa primero Get-CsPublicProvider para devolver una colección de todos los proveedores públicos en 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 True. A su vez, esta colección filtrada se transfiere a Disable-CsPublicProvider, que deshabilita cada proveedor de la colección.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsPublicProvider

El comando del Ejemplo 3 deshabilita todos los proveedores públicos que hay habilitados y cuyo nivel de verificación sea AlwaysVerifiable. Para realizar esta tarea, el comando primero llama a Get-CsPublicProvider para devolver una colección de todos los proveedores públicos en uso en la organización. Esta colección se transfiere a Where-Object, que extrae los proveedores que cumplen dos criterios: 1) la propiedad VerificationLevel es igual a AlwaysVerifiable, y 2) la propiedad Enabled es igual a True. (El operador -and indica a Where-Object que los objetos deben cumplir todos los criterios especificados para poderse seleccionar). A continuación, la colección filtrada se transfiere a Disable-CsPublicProvider, que deshabilita cada proveedor de la colección.