Compartir a través de

  • Artículo

Get-CsHostingProvider

 

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

Devuelve información sobre los proveedores de hospedaje configurados para el uso 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 a usted le gustará 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

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

Get-CsHostingProvider [-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 Lync 2010. Microsoft 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 de hospedaje es una organización que ofrece servicios de comunicación SIP a otras organizaciones. Por ejemplo, Fabrikam, Inc. podría alojar usuarios de Contoso, Northwind Traders y Wingtip Toys. Cuando usted establece una relación de federación con un proveedor de hospedaje, de hecho establece una federación con cualquier organización que esté hospedada con 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 también se usan en las situaciones de dominios divididos. 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). En el caso de otros usuarios, el proveedor de hospedaje de terceros se encarga de mantener las cuentas de forma externa. 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.

El cmdlet Get-CsHostingProvider permite recuperar información sobre los proveedores de hospedaje configurados para el uso en la organización.

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 DNS (Sistema de nombres de dominio).

Quien puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsHostingProvider de manera local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único del proveedor de hospedaje que se va a devolver. El valor de Identity puede ser un nombre de dominio completo (FQDN) del proveedor de hospedaje (por ejemplo, fabrikam.com) o el nombre de la compañía que proporciona los servicios (Fabrikam, Inc.).

Si este parámetro no se especifica, Get-CsHostingProvider devolverá una recopilación de todos los proveedores de hospedaje que estén configurados para el uso en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar valores de caracteres comodín para devolver uno o más proveedores de hospedaje. Por ejemplo, para devolver todos los proveedores de hospedaje con una identidad que acabe por el valor de cadena de caracteres ".com", use esta sintaxis: -Filter "*.com". Para devolver todos los proveedores de hospedaje con una identidad que empiece por la cadena de caracteres "Fabri", use esta sintaxis: -Filter "Fabri*".

LocalStore

Opcional

Parámetro modificador

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

Tipos de entrada

Ninguno. Get-CsHostingProvider no acepta entradas transferidas.

Tipos de valores devueltos

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

Ejemplo

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

Get-CsHostingProvider

El comando anterior devuelve una recopilación de todos los proveedores de hospedaje configurados para el uso en la organización. Al llamar a Get-CsHostingProvider sin parámetros adicionales, se devuelve la recopilación completa de proveedores de hospedaje.

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

Get-CsHostingProvider -Identity Fabrikam.com

En el ejemplo 2 se devuelve el proveedor de hospedaje que tiene l valor de Identity Fabrikam.com. Dado que las identidades deben ser únicas entre los proveedores de hospedaje, este comando nunca devolverá más de un elemento.

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

Get-CsHostingProvider -Filter *.org

El comando mostrado en el ejemplo 3 devuelve una recopilación de todos los proveedores de hospedaje que tienen un valor de Identity que acaba con el valor de cadena de caracteres ".org" (por ejemplo, fabrikam.org y contoso.org).

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

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

En el Ejemplo 4, se devuelven todos los proveedores de hospedaje que están habilitados para su uso. Para ello, primero se llama a Get-CsHostingProvider para devolver una recopilación de todos los proveedores de hospedaje configurados para su uso en la organización. Esta recopilación después se transfiere al cmdlet Where-Object, que elige solo los proveedores donde la propiedad Enabled es igual a False.

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

Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True -and $_.EnabledSharedAddressSpace -eq $True}

El comando anterior devuelve todos los proveedores de hospedaje que tengan un espacio de direcciones compartido y que hospeden a usuarios de Lync Server 2010; por definición, esto significa que el comando devuelve todos los proveedores de hospedaje que forman parte de una instalación de dominio dividido. (Dominio dividido simplemente significa que algunas de las cuentas de Lync Server se mantienen de forma local, mientras que otras las mantiene un proveedor de hospedaje.) Para llevar a cabo esta tarea, el comando primero usa Get-CsHostingProvider para devolver una recopilación de todos los proveedores de hospedaje que están configurados. A continuación, esta recopilación se transfiere al cmdlet Where-Object, que solo selecciona los proveedores que cumplen estos dos criterios: 1) la propiedad Enabled es igual a True y 2) la propiedad EnabledSharedAddressSpace es igual a True.

-------------------------- Ejemplo 6 ------------------------

Get-CsHostingProvider | Select-Object *

El comando mostrado en el ejemplo 6 muestra todos los valores de propiedad para todos los proveedores de hospedaje configurados para su uso en la organización. De forma predeterminada, los valores de propiedad para EnabledSharedAddressSpace y HostsOCSUsers no se muestran al ejecutar Get-CsHostingProvider. A fin de ver los valores para estas propiedades, la información devuelta por Get-CsHostingProvider se transfiere al cmdlet Select-Object; la sintaxis "Select-Object *" indica a Get-CsHostingProvider que muestre todas las propiedades y los valores de propiedad para los elementos devueltos.