Partager via

  • Article

Get-CsHostingProvider

 

Dernière rubrique modifiée : 2012-03-23

Retourne des informations sur les fournisseurs d’hébergement configurés pour être utilisés dans votre organisation. Un fournisseur d’hébergement est une organisation tierce qui offre des fonctionnalités de services de messagerie instantanée et de présence, ainsi que d’autres services pour un domaine avec lequel vous souhaitez établir une fédération. Les fournisseurs d’hébergement, tels que Microsoft Lync Online 2010, diffèrent des fournisseurs publics (tels que Yahoo!, MSN et AOL) dans la mesure où leurs services ne sont pas accessibles au grand public.

Syntaxe

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

Get-CsHostingProvider [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

La fédération est un moyen par lequel deux organisations peuvent fonder une relation afin de faciliter la communication entre leurs groupes. Lorsqu’une fédération a été établie, les utilisateurs des deux organisations peuvent échanger des messages instantanés, souscrire à des notifications de présence et communiquer entre eux à l’aide d’applications SIP comme Lync 2010. Microsoft Lync Server 2010 autorise trois types de fédération : 1) fédération directe entre votre organisation et une autre ; 2) fédération entre votre organisation et un fournisseur public, et 3) fédération entre votre organisation et un fournisseur d’hébergement tiers.

Un fournisseur d’hébergement est une organisation qui fournit des services de communication SIP aux autres organisations, par exemple, Fabrikam, Inc., qui pourra héberger les utilisateurs de Contoso, NorthWind Traders et Wingtip Toys. Quand vous établissez une relation de fédération avec un fournisseur d’hébergement, vous établissez effectivement une fédération avec toute l’organisation hébergée par ce fournisseur. Par exemple, si vous établissez une fédération avec Fabrikam, les utilisateurs pourront échanger des messages instantanés et des informations de présence avec les utilisateurs de Contoso, Northwind Traders et Wingtip Toys.

Les fournisseurs d’hébergement sont également utilisés dans des scénarios de domaine fractionné. Dans un scénario de domaine fractionné, les comptes de certains utilisateurs de Lync Server 2010 sont hébergés sur site (c’est-à-dire, dans votre implémentation locale de Lync Server). Les comptes d’autres utilisateurs sont hébergés hors site par le fournisseur d’hébergement tiers. La fédération avec le fournisseur d’hébergement permet à vos utilisateurs sur site et hors site de communiquer les uns avec les autres.

La cmdlet Get-CsHostingProvider vous permet de retourner des informations sur tous les fournisseurs d’hébergement qui ont été configurés pour être utilisés dans votre organisation.

Notez que vous ne pouvez pas vous fédérer à un fournisseur d’hébergement si vous disposez de plusieurs ou d’un seul serveurs Edge configuré pour utiliser le mode de routage par défaut et non le routage de serveur DNS (Domain Name System).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsHostingProvider : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique du fournisseur d’hébergement à retourner. L’identité peut être le nom de domaine complet (FQDN) du fournisseur d’hébergement (par exemple, fabrikam.com) ou éventuellement le nom de la société fournissant les services (Fabrikam, Inc.).

Si ce paramètre n’est pas spécifié, la cmdlet Get-CsHostingProvider retourne une collection de tous les fournisseurs d’hébergement configurés pour être utilisés dans votre organisation.

Filter

Facultatif

Chaîne

Permet d’utiliser des valeurs à caractères génériques pour retourner un ou plusieurs fournisseurs d’hébergement. Par exemple, pour retourner tous les fournisseurs d’hébergement dont l’identité se termine par la valeur de chaîne « .com », utilisez la syntaxe suivante : -Filter "*.com". Pour retourner tous les fournisseurs d’hébergement dont l’identité commence par la chaîne « Fabri », utilisez la syntaxe suivante : -Filter "Fabri*".

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de fournisseur d’hébergement à partir du réplica local du magasin central de gestion et non depuis le magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsHostingProvider n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider.

Exemple

-------------------------- Exemple 1 ------------------------

Get-CsHostingProvider

La commande ci-dessus retourne une collection de tous les fournisseurs d’hébergement configurés pour être utilisés dans l’organisation. Lorsque vous appelez la cmdlet Get-CsHostingProvider sans aucun paramètre supplémentaire, une collection complète de fournisseurs d’hébergement est retournée.

-------------------------- Exemple 2 ------------------------

Get-CsHostingProvider -Identity Fabrikam.com

L’exemple 2 retourne le fournisseur d’hébergement comportant l’identité (Identity) Fabrikam.com. Parce que les identités doivent être uniques entre les fournisseurs d’hébergement, cette commande ne retourne jamais plus d’un seul élément.

-------------------------- Exemple 3 ------------------------

Get-CsHostingProvider -Filter *.org

La commande présentée dans l’exemple 3 retourne une collection de tous les fournisseurs d’hébergement dont l’identité se termine par la valeur de chaîne « .org » (par exemple, fabrikam.org, contoso.org, etc.).

-------------------------- Exemple 4 ------------------------

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

Dans l’exemple 4, tous les fournisseurs d’hébergement actuellement activés sont retournés. Pour ce faire, la cmdlet Get-CsHostingProvider est d’abord appelée afin de retourner une collection de tous les fournisseurs d’hébergement actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les fournisseurs dont la propriété Enabled est égale à True.

-------------------------- Exemple 5 ------------------------

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

La commande ci-dessus retourne tous les fournisseurs d’hébergement qui partagent un espace d’adressage et hébergent les utilisateurs Lync Server 2010. Par définition, cela signifie que la commande retourne tous les fournisseurs d’hébergement appartenant à une configuration de type « domaine fractionné » (le terme de domaine fractionné signifie simplement que certains comptes Lync Server sont conservés sur site alors que d’autres sont gérés par un fournisseur d’hébergement). Pour exécuter cette tâche, la commande appelle d’abord Get-CsHostingProvider pour retourner une collection de tous les fournisseurs d’hébergement actuellement configurés. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les fournisseurs répondant à deux critères : 1) La propriété Enabled est égale à True ; et 2) la propriété EnabledSharedAddressSpace est égale à True.

-------------------------- Exemple 6 ------------------------

Get-CsHostingProvider | Select-Object *

La commande présentée dans l’exemple 6 affiche toutes les valeurs des propriétés de tous les fournisseurs d’hébergement configurés pour être utilisés dans votre organisation. Par défaut, les valeurs des propriétés EnabledSharedAddressSpace et HostsOCSUsers ne s’affichent pas lorsque vous exécutez la cmdlet Get-CsHostingProvider. Pour afficher les valeurs de ces propriétés, les informations retournées par Get-CsHostingProvider sont redirigées vers la cmdlet Select-Object. La syntaxe « Select-Object * » donne pour consigne à la cmdlet Get-CsHostingProvider d’afficher toutes les valeurs de propriétés pour les éléments retournés.