Partager via

  • Article

Get-CsPublicProvider

 

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

Renvoie des informations sur les fournisseurs publics configurés pour être utilisés dans votre organisation. Un fournisseur public est une organisation qui met à la disposition du grand public des services de messagerie instantanée, des services de présence et des services annexes. Microsoft Lync Server 2010 est fourni avec trois fournisseurs publics configurés mais non activés : Yahoo!, AOL et MSN.

Syntaxe

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

Get-CsPublicProvider [-Filter <String>] [-LocalStore <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 Microsoft Lync 2010. 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 public est une organisation qui met à la disposition du grand public des services de communication SIP. Lorsque vous établissez une relation de fédération avec un fournisseur public, vous établissez en fait une fédération avec tout utilisateur disposant d’un compte hébergé par ce fournisseur. Par exemple, si vous établissez une fédération avec MSN, vos utilisateurs pourront échanger des messages instantanés et des informations de présence avec toutes les personnes qui disposent d'un compte de messagerie instantanée MSN.

Afin d’établir une fédération avec un fournisseur public, vous devez préalablement créer et activer ce dernier (le fournisseur public doit également créer une relation de fédération avec vous). La cmdlet Get-CsPublicProvider vous permet de renvoyer des informations sur les fournisseurs publics qui ont été configurés pour être utilisés dans votre organisation.

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-CsPublicProvider : 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-CsPublicProvider"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Chaîne

Identificateur unique du fournisseur public à renvoyer. Cette identité est généralement le nom du site web fournissant les services (par exemple Yahoo!, AOL, MSN, etc.).

Vous ne pouvez pas utiliser de caractères génériques lors de la spécification de l’identité. Afin d'utiliser des caractères génériques pour renvoyer un ou plusieurs fournisseurs publics, utilisez le paramètre Filter.

Filter

Facultatif

Chaîne

Permet d'utiliser des valeurs de caractère générique afin de renvoyer un ou plusieurs fournisseurs publics. Par exemple, pour retourner une collection de tous les fournisseurs publics dont l'identité commence par la lettre Y, utilisez cette syntaxe : -Filter "Y*". Pour retourner une collection de tous les fournisseurs publics qui contiennent la valeur de chaîne « Windows » dans leur identité, utilisez cette syntaxe : -Filter "*Windows*".

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données du fournisseur public à partir du réplica local du magasin central de gestion, plutôt que du magasin central de gestion lui-même.

Types d’entrées

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

Types de retours

Renvoie des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Exemple

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

Get-CsPublicProvider

La commande présentée dans l’exemple 1 retourne une collection de tous les fournisseurs publics configurés pour être utilisés dans l’organisation. Si vous appelez Get-CsPublicProvider sans paramètres supplémentaires, le système renvoie toujours la collection complète de fournisseurs publics.

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

Get-CsPublicProvider -Identity "MSN"

Dans l'exemple 2, tous les fournisseurs publics ayant l'identité MSN sont renvoyés. Puisque les identités doivent être uniques parmi les fournisseurs publics (et parmi les fournisseurs d’hébergement), cette commande renverra au maximum un seul élément.

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

Get-CsPublicProvider -Filter W*

La commande précédente renvoie tous les fournisseurs publics dont l'identité commence par la lettre W. Pour ce faire, vous devez inclure le paramètre Filter et la valeur de filtre « W* ».

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

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

La commande présentée dans l’exemple 4 retourne une collection de tous les fournisseurs publics actuellement désactivés. Pour ce faire, la commande appelle d'abord Get-CsPublicProvider pour retourner une collection de tous les fournisseurs publics configurés pour être utilisés dans l'organisation. Cette collection est redirigée vers la cmdlet Where-Object qui sélectionne uniquement les fournisseurs dont la propriété Enabled est égale à False.

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

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

La commande précédente renvoie tous les fournisseurs publics dont la propriété VerificationLevel est définie sur AlwaysUnverifiable ou UseSourceVerification. (Les niveaux de vérification peuvent être définis sur AlwaysUnverifiable, UseSourceVerification ou AlwaysVerifiable.) Pour effectuer cette tâche, la commande appelle d'abord Get-CsPublicProvider pour retourner une collection de tous les fournisseurs publics configurés pour être utilisés dans l'organisation. Cette collection est ensuite redirigée vers Where-Object qui sélectionne uniquement les fournisseurs dont la propriété VerificationLevel n'est pas égale à AlwaysVerifiable. Résultat : seuls les fournisseurs dont la propriété VerificationLevel est définie sur AlwaysUnverifiable ou UseSourceVerification sont sélectionnés.