Compartir a través de

  • Artículo

Remove-CsHostingProvider

 

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

Quita uno o más de los proveedores de hospedaje que se usan actualmente en la organización. Un proveedor de hospedaje es una organización de terceros que proporciona servicios de mensajería instantánea, presencia y otros servicios relacionados para un dominio con el que quiere establecer una relación de federación. Los proveedores de hospedaje, como Microsoft Lync Online 2010, se diferencian de los proveedores públicos (como Yahoo!, MSN y AOL) por el hecho de que sus servicios no se ofrecen al público en general.

Sintaxis

Remove-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La federación es un medio por el cual dos organizaciones pueden establecer una relación de confianza para facilitar la comunicación entre ambas. 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 Lync 2010. Microsoft Lync Server 2010 permite sacar partido de tres tipos de federación: 1) federación directa entre una organización y otra; 2) federación entre una organización y un proveedor público, y 3) federación entre una organización y un proveedor de hospedaje de terceros.

Un proveedor de hospedaje es una organización que proporciona servicios de comunicación SIP para otras organizaciones; por ejemplo, Fabrikam, Inc. puede hospedar usuarios de Contoso, Northwind Traders y Wingtip Toys. Cuando establece una relación de federación con un proveedor de hospedaje, está estableciendo una relación de federación con todas las demás organizaciones hospedadas por dicho proveedor. Por ejemplo, si establece una relación de federación con Fabrikam, sus usuarios podrán intercambiar mensajes instantáneos e información de presencia con los usuarios de Contoso, Northwind Traders y Wingtip Toys.

Los proveedores de hospedaje se usan también en casos de dominio dividido. En un caso de dominio dividido, algunos de sus usuarios tienen cuentas hospedadas localmente (es decir, hospedadas en su instalación local de Lync Server 2010). Otros usuarios hacen que el proveedor de hospedaje de terceros se encargue de hospedar las cuentas. Establecer una relación de federación con el proveedor de hospedaje permite que los usuarios con cuentas hospedadas internamente y externamente se comuniquen entre ellos.

Para federarse con un proveedor de hospedaje de terceros, deberá crear y habilitar un nuevo proveedor de hospedaje. (Además, el proveedor de terceros deberá crear una relación de federación con usted). Si más tarde decide finalizar esta relación, puede utilizar el cmdlet Remove-CsHostingProvider para eliminar el proveedor de hospedaje. Al eliminar un proveedor de hospedaje, se quita de su lista de socios federados; en ese punto, el único modo de restablecer la relación es volver a crear el proveedor. Si desea suspender temporalmente una relación, use en su lugar el cmdlet Disable-CsHostingProvider. Cuando se un proveedor de hospedaje se deshabilita, no se elimina de la lista de socios federados, simplemente se marca como deshabilitado y la comunicación entre la organización y dicho proveedor se deshabilita. Para restablecer la relación, puede usar Enable-CsHostingProvider para volver a habilitar el proveedor.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsHostingProvider localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHostingProvider"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Cadena de caracteres

Identificador único del proveedor de hospedaje que se va a quitar. Identity es un valor de cadena de caracteres; por ejemplo, podría ser el nombre de dominio completo (FQDN) del proveedor de hospedaje (es decir, fabrikam.com) o quizás el nombre de la compañía que proporciona los servicios (Fabrikam, Inc.).

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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.DisplayHostingProvider. Remove-CsHostingProvider acepta instancias transferidas del objeto de proveedor de hospedaje.

Tipos de valores devueltos

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

Ejemplo

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

Remove-CsHostingProvider -Identity "Fabrikam.com"

El comando que se muestra en el Ejemplo 1 elimina el proveedor de hospedaje con la Identidad Fabrikam.com. Una vez eliminado, se terminará la federación con Fabrikam.com (y con todos los dominios asociados con Fabrikam.com).

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

Get-CsHostingProvider | Remove-CsHostingProvider

En el Ejemplo 2 se eliminan todos los proveedores de hospedaje configurados para su uso en la organización. Para ello, el comando usa primero Get-CsHostingProvider para devolver una colección de todos los proveedores de hospedaje en uso actualmente. A continuación, la colección se transfiere a Remove-CsHostingProvider, que elimina cada uno de los elementos de la colección. Al completarse este comando, dejarán de existir proveedores de hospedaje configurados para su uso.

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

Get-CsHostingProvider -Filter "*Fabrikam*" | Remove-CsHostingProvider

El comando anterior elimina todos los proveedores de hospedaje en los que el valor de cadena "Fabrikam" aparece en algún lugar de la Identidad del proveedor. Para llevar a cabo esta tarea, el comando llama primero a Get-CsHostingProvider y al parámetro Filter. El valor de filtro "*Fabrikam*" limita los datos devueltos a aquellos proveedores de hospedaje que tienen "Fabrikam" en algún lugar de Identity. Por ejemplo, este comando devuelve proveedores como Fabrikam.com, Fabrikam.net y FabrikamUsers.com. A continuación, la colección filtrada se transfiere a Remove-CsHostingProvider, que elimina todos los elementos de la colección.

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

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

En el Ejemplo 4, se eliminan todos los proveedores de hospedaje cuyo nivel de verificación está establecido en un valor diferente de AlwaysVerifiable. Esto se lleva a cabo llamando primero a Get-CsHostingProvider sin ningún parámetro adicional; este comando devuelve una colección de todos los proveedores de hospedaje configurados para su uso en la organización. A continuación, se transfiere la colección resultante al cmdlet Where-Object, que selecciona únicamente aquellos proveedores cuya propiedad VerificationLevel no es igual a AlwaysVerifiable. La colección filtrada se transfiere a continuación a Remove-CsHostingProvider, que elimina cada proveedor de la colección.

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

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

El comando anterior quita todos los proveedores de hospedaje que están actualmente inhabilitados. Para ello, el comando usa primero Get-CsHostingProvider para devolver una colección de todos los proveedores de hospedaje configurados para su uso en la organización. Esta colección se transfiere a Where-Object, que selecciona únicamente aquellos proveedores que están deshabilitados; es decir, solo aquellos proveedores cuya propiedad Enabled es igual a False. A continuación, la colección filtrada se transfiere a Remove-CsHostingProvider, que elimina todos los proveedores de hospedaje deshabilitados.