Set-CsHostingProvider
Dernière rubrique modifiée : 2012-03-26
Modifie le fournisseur de l’hébergement utilisé actuellement 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
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>]]
Description détaillée
La fédération est un moyen par lequel deux organisations peuvent configurer une relation d’approbation destinée à simplifier la communication entre elles. 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. Lorsque vous créez une relation de fédération avec un fournisseur d’hébergement, vous établissez en fait une fédération avec toutes les organisations hébergées 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.
Afin de vous fédérer à un fournisseur d’hébergement tiers, vous devez créer et activer un nouveau fournisseur d’hébergement. (De plus, le fournisseur tiers devra créer une relation de fédération avec vous.) Une fois que le fournisseur d’hébergement a été créé, vous pouvez utiliser la cmdlet Set-CsHostingProvider pour modifier les propriétés de ce fournisseur. Par exemple, vous pouvez utiliser cette cmdlet pour modifier le nom complet du serveur proxy du fournisseur ou utiliser une cmdlet pour modifier le niveau de vérification de ce fournisseur.
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 Set-CsHostingProvider : 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 "Set-CsHostingProvider"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
Chaîne |
Identificateur unique du fournisseur d’hébergement à modifier. L’identité peut être le nom de domaine complet du fournisseur d’hébergement (par exemple, fabrikam.com) ou éventuellement le nom de la société fournissant les services (Fabrikam, Inc.). |
Instance |
Facultatif |
Objet DisplayHostingProvider |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
AutoDiscoverUrl |
Facultatif |
Chaîne |
URL du service de découverte automatique utilisé par un fournisseur d’hébergement de comptes Lync Server. Le service de découverte automatique permet aux applications clientes telles que Microsoft Lync Mobile de déterminer comment accéder aux ressources telles que le pool d’accueil de l’utilisateur. |
Enabled |
Facultatif |
Booléen |
Indique si la connexion réseau entre votre domaine et le fournisseur d’hébergement est activée. Les messages ne peuvent pas être échangés entre les deux organisations tant que cette valeur n’est pas définie sur True. La valeur par défaut est False. |
EnabledSharedAddressSpace |
Facultatif |
Booléen |
Si la valeur est True, cela indique que le fournisseur d’hébergement est utilisé dans un scénario de domaine partagé. La valeur par défaut est False. |
HostsOCSUsers |
Facultatif |
Booléen |
Si la valeur est True, cela indique que le fournisseur d’hébergement est utilisé pour héberger les comptes Lync Server 2010. Si la valeur est False, cela indique que le fournisseur héberge d’autres types de comptes, comme les comptes Microsoft Exchange Server. La valeur par défaut est False. |
IsLocal |
Facultatif |
Booléen |
Si la valeur est True, cela indique que le serveur proxy utilisé par le fournisseur d’hébergement est contenu dans votre topologie Lync Server. La valeur par défaut est False. |
VerificationLevel |
Facultatif |
Chaîne |
Indique le niveau de vérification permis pour les messages envoyés au fournisseur d’hébergement et reçus de ce dernier. Le paramètre VerificationLevel doit être défini sur l’une des valeurs suivantes : AlwaysVerifiable. Indique que tous les messages envoyés à partir du fournisseur d’hébergement sont considérés vérifiables. Cela signifie qu’aucun message provenant du fournisseur d’hébergement ne sera rejeté. AlwaysUnverifiable. Indique que tous les messages envoyés à partir du fournisseur d’hébergement sont considérés non vérifiables. De ce fait, les messages ne sont passés que si l’utilisateur du fournisseur d’hébergement est aussi sur votre liste de contacts. UseSourceVerification. S’appuie sur le niveau de vérification inclus dans les messages envoyés à partir du fournisseur d’hébergement. Si ce niveau n’est pas spécifié, alors le message sera rejeté comme message non vérifiable. La valeur par défaut est AlwaysVerifiable. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider. Set-CsHostingProvider accepte les instances transmises via le pipeline de l’objet fournisseur d’hébergement.
Types de retours
Set-CsHostingProvider ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsHostingProvider -Identity "Fabrikam.com" -VerificationLevel "AlwaysUnverifiable"
La commande précédente modifie le fournisseur d’hébergement avec l’identité Fabrikam.com. Dans cet exemple, la propriété VerificationLevel property a la valeur AlwaysUnverifiable.
-------------------------- Exemple 2 --------------------------
Get-CsHostingProvider | Set-CsHostingProvider -VerificationLevel "AlwaysUnverifiable"
L’exemple 2 est une variation de la commande indiquée à l’exemple 1. Cependant, dans ce cas, le niveau de vérification de tous les fournisseurs d’hébergement est défini avec la valeur AlwaysUnverifiable. Pour ce faire, Get-CsHostingProvider est d’abord utilisé pour retourner une collection de tous les fournisseurs d’hébergement configurés pour être utilisés dans l’organisation. Cette collection est ensuite redirigée vers Set-CsHostingProvider qui modifie la propriété VerificationLevel pour chaque fournisseur dans la collection.
-------------------------- Exemple 3 --------------------------
Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.HostsOCSUsers -eq $True} | Set-CsHostingProvider -EnabledSharedAddressSpace $False -HostsOCSUsers $False
Dans l’exemple 3, tous les fournisseurs d’hébergement actuellement configurés pour être utilisés dans la configuration de domaine partagé sont modifiés de sorte qu’ils ne seront plus utilisés dans le cadre de la fédération de domaine partagé. Dans cet exemple, on appelle d’abord Get-CsHostingProvider afin de retourner une collection de tous les fournisseurs d’hébergement disponibles. 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é HostsOCSUsers est égale à True ; et, 2) la propriété EnabledSharedAddressSpace est égale à True. Cette collection filtrée est ensuite redirigée vers Set-CsHostingProvider, qui définit les deux propriétés EnabledSharedAddressSpace et HostsOCSUsers sur False. Une fois ceci effectué, les fournisseurs d’hébergement de la collection seront toujours activé pour la fédération, cependant, ils ne seront pas utilisés dans le scénario de domaine partagé.
Voir aussi
Autres ressources
Disable-CsHostingProvider
Enable-CsHostingProvider
Get-CsHostingProvider
New-CsHostingProvider
Remove-CsHostingProvider