Compartir a través de

  • Artículo

Set-CsHostingProvider

 

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

Modifica un proveedor de hospedaje que se usa 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

Set-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsHostingProvider [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-Instance <PSObject>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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 una situación de dominio dividido, algunos de los usuarios de Lync Server 2010 tienen cuentas hospedadas de forma interna (es decir, en la implementación local de Lync Server). 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). Tras crear un proveedor de hospedaje, puede usar el cmdlet Set-CsHostingProvider para modificar las propiedades del proveedor. Por ejemplo, puede usar este cmdlet para cambiar el nombre de dominio completo (FQDN) del servidor proxy del proveedor, o bien usar el cmdlet para cambiar el nivel de verificación de ese proveedor.

Tenga en cuenta que no podrá federarse con un proveedor de hospedaje si los Servidores perimetrales están configurados para usar el enrutamiento predeterminado en lugar del enrutamiento de servidor de Sistema de nombres de dominio (DNS).

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-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 "Set-CsHostingProvider"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único del proveedor de hospedaje que se modificará. El parámetro Identity podría ser el FQDN del proveedor de hospedaje (es decir, fabrikam.com) o quizás el nombre de la compañía que proporciona los servicios (Fabrikam, Inc.).

Instance

Opcional

Objeto DisplayHostingProvider

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

AutoDiscoverUrl

Opcional

Cadena de caracteres

La URL del servicio Detección automática que tenga en uso un proveedor de hosting que hospede cuentas Lync Server. El servicio Detección automática permite que las aplicaciones cliente como Microsoft Lync Mobile determinen cómo se obtiene acceso a recursos como el grupo de servidores principales de un usuario.

Enabled

Opcional

Booleano

Indica si la conexión de red entre el dominio y el proveedor de hospedaje está habilitada. No se pueden intercambiar mensajes entre ambas organizaciones hasta que este valor se configure como True. El valor predeterminado es False.

EnabledSharedAddressSpace

Opcional

Booleano

Si es True, indica que el proveedor de hospedaje se está usando en un caso de dominio dividido. El valor predeterminado es False.

HostsOCSUsers

Opcional

Booleano

Si es True, indica que se usará el proveedor de hospedaje para hospedar las cuentas de Lync Server 2010. Si es False, indica que el proveedor hospeda otros tipos de cuenta como, por ejemplo, cuentas de Microsoft Exchange Server. El valor predeterminado es False.

IsLocal

Opcional

Booleano

Si es True, indica que el servidor proxy que usa el proveedor de hospedaje está incluido en la topología de Lync Server. El valor predeterminado es False.

VerificationLevel

Opcional

Cadena de caracteres

Indica el nivel de verificación permitido para los mensajes enviados del y al proveedor hospedado. VerificationLevel debe configurarse con uno de los siguientes valores:

AlwaysVerifiable. Indica que todos los mensajes enviados del proveedor de hospedaje se consideran verificables. Significa que no se rechazará ningún mensaje del proveedor de hospedaje.

AlwaysUnverifiable. Indica que todos los mensajes enviados del proveedor de hospedaje se consideran no verificables. Por ello, los mensajes se pasan únicamente si el usuario del proveedor de hospedaje está en la lista de contactos.

UseSourceVerification. Se basa en el nivel de verificación incluido en los mensajes enviados desde el proveedor de hospedaje. Si no se especifica el nivel, se rechazará el mensaje como no verificable.

El valor predeterminado es AlwaysVerifiable.

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. Set-CsHostingProvider acepta instancias transferidas del objeto de proveedor de hospedaje.

Tipos de valores devueltos

Set-CsHostingProvider no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider.

Ejemplo

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

Set-CsHostingProvider -Identity "Fabrikam.com" -VerificationLevel "AlwaysUnverifiable"

El comando anterior modifica el proveedor de hospedaje con Identidad Fabrikam.com. En este ejemplo, la propiedad VerificationLevel se configura como AlwaysUnverifiable.

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

Get-CsHostingProvider | Set-CsHostingProvider -VerificationLevel "AlwaysUnverifiable"

El Ejemplo 2 es una variación del comando del Ejemplo 1; sin embargo, en este caso, se configura el nivel de verificación de todos los proveedores de hospedaje como AlwaysUnverifiable. Para hacerlo, se usa primero Get-CsHostingProvider para devolver una colección de todos los proveedores de hospedaje configurados para su uso en la organización. A continuación, esta colección se transfiere a Set-CsHostingProvider, que modifica la propiedad VerificationLevel en cada proveedor de la colección.

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

Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.HostsOCSUsers -eq $True} | Set-CsHostingProvider -EnabledSharedAddressSpace $False -HostsOCSUsers $False

En el Ejemplo 3, se modifican todos los proveedores de hospedaje configurados actualmente para usar en una configuración de dominio dividido, para que dejen de usarse en la federación de dominio dividido. En este ejemplo, se llama primero a Get-CsHostingProvider para devolver una colección de todos los proveedores de hospedaje disponibles. A continuación, esta colección se transfiere al cmdlet Where-Object, que solo selecciona los proveedores que cumplen estos dos criterios: 1) la propiedad HostsOCSUsers es igual a True y 2) la propiedad EnabledSharedAddressSpace es igual a True. Después, la colección filtrada se transfiere a Set-CsHostingProvider que, a su vez, establece las propiedades EnabledSharedAddressSpace y HostsOCSUsers en False. Al realizar esta acción, los proveedores de hospedaje de la colección seguirán habilitados para la federación; sin embargo, no podrán usarse más en casos de dominio dividido.