Partager via

  • Article

Remove-CsHostingProvider

 

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

Supprime un ou plusieurs fournisseurs d’hébergement actuellement 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

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

Description détaillée

La fédération est le moyen par lequel deux organisations peuvent configurer une relation d’approbation pour faciliter 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 établissez une relation de fédération avec un fournisseur d’hébergement, vous définissez effectivement une fédération avec toute organisation fédéré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 fragmenté. Dans un scénario de domaine fragmenté, les comptes de certains de vos utilisateurs sont hébergés sur site (c’est-à-dire, sur votre implémentation locale de Lync Server 2010). 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. (Le fournisseur tiers doit également créer une relation de fédération avec vous). Si vous décidez par la suite de mettre un terme à cette relation, utilisez la cmdlet Remove-CsHostingProvider pour supprimer le fournisseur d’hébergement. Lorsque vous supprimez un fournisseur d’hébergement, celui-ci est supprimé de la liste des partenaires fédérés ; à cette étape, le seul moyen de rétablir la relation est de récréer le fournisseur. Pour suspendre provisoirement une relation, utilisez la cmdlet Disable-CsHostingProvider à la place. Lorsqu’un fournisseur d’hébergement est désactivé, il n’est pas supprimé de la liste des partenaires fédérés mais simplement marqué comme étant désactivé et toute communication entre lui et votre organisation est désactivée. Pour rétablir la relation, vous pouvez utiliser Enable-CsHostingProvider pour réactiver le fournisseur.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsHostingProvider"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Chaîne

Identificateur unique du fournisseur d’hébergement à supprimer. L’identité est une valeur de chaîne. Elle peut être le nom de domaine complet du fournisseur d’hébergement (comme fabrikam.com) ou éventuellement le nom de la société fournissant les services (comme Fabrikam, Inc.).

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. Remove-CsHostingProvider accepte les instances transmises via le pipeline de l’objet du fournisseur d’hébergement.

Types de retours

Aucun. Au lieu de cela, la cmdlet supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider.

Exemple

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

Remove-CsHostingProvider -Identity "Fabrikam.com"

La commande présentée dans l’exemple 1 supprime le fournisseur d’hébergement dont la propriété Identity est Fabrikam.com. Une fois le fournisseur d’hébergement supprimé, la fédération avec Fabrikam.com (et les domaines associés à Fabrikam.com) est terminée.

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

Get-CsHostingProvider | Remove-CsHostingProvider

L’exemple 2 supprime tous les fournisseurs d’hébergement configurés en vue d’une utilisation dans l’organisation. Pour cela, la commande utilise d’abord Get-CsHostingProvider pour retourner une collection de tous les fournisseurs d’hébergement actuellement utilisés. Cette collection est ensuite redirigée vers Remove-CsHostingProvider qui supprime chaque élément dans la collection. Une fois la commande terminée, plus aucun fournisseur d’hébergement n’est configuré pour être utilisé.

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

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

La commande ci-dessus supprime tous les fournisseurs d’hébergement dont la propriété Identity indique « Fabrikam », même partiellement. Pour cela, la commande appelle d’abord Get-CsHostingProvider et le paramètre Filter ; la valeur de filtre « *Fabrikam* » limite les données retournées aux fournisseurs d’hébergement dont la l’identité contient « Fabrikam ». Par exemple, cette commande retourne des fournisseurs tels que Fabrikam.com, Fabrikam.net et FabrikamUsers.com. Cette collection filtrée est ensuite redirigée vers Remove-CsHostingProvider qui supprime chaque élément dans la collection.

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

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

Dans l’exemple 4, tous les fournisseurs d’hébergement pour lesquels le niveau de vérification est défini sur une valeur autre que AlwaysVerifiable sont supprimés. Pour cela, la commande appelle d’abord Get-CsHostingProvider sans aucun paramètre supplémentaire ; il en résulte une collection de tous les fournisseurs d’hébergement configurés en vue d’une utilisation au sein de l’organisation. La collection obtenue est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les fournisseurs dont la propriété VerificationLevel est différente de AlwaysVerifiable. La collection filtrée est alors redirigée vers Remove-CsHostingProvider qui supprime chaque fournisseur contenu dans la collection.

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

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

La commande ci-dessus supprime tous les fournisseurs d’hébergement actuellement désactivés. Pour ce faire, la commande appelle d’abord Get-CsHostingProvider pour retourner une collection de tous les fournisseurs d’hébergement configurés pour être utilisés dans l’organisation. Cette collection est redirigée vers Where-Object qui sélectionne uniquement les fournisseurs désactivés, c’est-à-dire ceux dont la propriété Enabled est égale à False. Cette collection filtrée est ensuite redirigée vers Remove-CsHostingProvider qui supprime chaque fournisseur d’hébergement désactivé.