Partager via

  • Article

New-CsPublicProvider

 

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

Crée une relation de fédération avec un nouveau fournisseur public. 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

New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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 Set-CsPublicProvider vous permet de modifier les valeurs de propriété d’un des fournisseurs publics qui ont été configurés pour être utilisés dans votre organisation.

Notez que vous ne pouvez pas établir de fédération avec un fournisseur public si vos serveurs Edge sont configurés pour utiliser le routage par défaut et non le routage de serveur DNS.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Chaîne

Identificateur unique du fournisseur public à créer. L’identité est généralement le nom du site Web fournissant les services (par exemple Yahoo!, AOL ou MSN).

Les identités doivent être non seulement uniques parmi les fournisseurs publics, mais également parmi les fournisseurs d’hébergement. Supposons que vous essayiez de créer un nouveau fournisseur public comportant l’identité Fabrikam. Votre commande échouera si un fournisseur public ou un fournisseur d’hébergement comportant cette identité existe déjà.

ProxyFqdn

Obligatoire

FQDN

Spécifie le nom de domaine complet (FQDN) (par exemple, proxyserver.fabrikam.com) du serveur proxy utilisé par le fournisseur public.

Les noms de domaines complets du proxy doivent être non seulement uniques parmi les fournisseurs publics, mais également parmi les fournisseurs d’hébergement. Par exemple, supposons que vous essayiez de créer un nouveau fournisseur public avec le nom de domaine complet de proxy proxyserver.fabrikam.com. Cette commande échouera si un fournisseur public ou un fournisseur d’hébergement portant ce nom de domaine complet de proxy existe déjà.

Enabled

Obligatoire

Booléen

Indique si la relation de fédération entre votre organisation et le fournisseur public est activée. Si le paramètre est défini sur True, les utilisateurs de votre organisation pourront échanger des messages instantanés et des informations de présence avec des utilisateurs disposant de comptes hébergés sur le fournisseur public. S’il est défini sur False, les utilisateurs de votre organisation ne pourront pas échanger de messages instantanés ni d’informations de présence avec des utilisateurs dont les comptes sont hébergés sur le fournisseur public. Vous pouvez activer et désactiver à tout moment des relations de fédération à l’aide des cmdlets Enable-CsPublicProvider et Disable-CsPublicProvider, respectivement.

VerificationLevel

Chaîne

Indique comment (ou si) des messages envoyés par un fournisseur public sont vérifiés pour s’assurer qu’ils proviennent bien de ce fournisseur. Le paramètre VerificationLevel doit être défini sur l’une des valeurs suivantes :

AlwaysVerifiable. Tous les messages qui seraient envoyés par ce fournisseur seront acceptés. Si un en-tête de vérification est introuvable dans le message, il est ajouté par Lync Server 2010. Il s’agit de la valeur par défaut.

AlwaysUnverifiable. Tous les messages supposément envoyés par un fournisseur public sont considérés comme non vérifiés. Ils seront remis uniquement s’ils ont été envoyés par une personne figurant dans la liste de contacts du destinataire. Par exemple, si votre liste de contacts inclut l’utilisateur Ken Myer, vous pourrez recevoir des messages de ce dernier. En revanche, si Pilar Ackerman ne figure pas dans votre liste de contacts, vous ne pourrez pas recevoir ses messages.

UseSourceVerification. Utilise l’en-tête de vérification ajouté au message par le fournisseur public. Si les informations de vérification sont manquantes, le message sera rejeté.

Force

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.

InMemory

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

WhatIf

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

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

Types de retours

Crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.

Exemple

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

New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

La commande illustrée dans l’exemple 1 crée une nouvelle relation de fédération avec un fournisseur public comportant l’identité Fabrikam. En plus du paramètre Identity, vous devez définir les deux autres valeurs de propriété (et les paramètres correspondants) : ProxyFqdn (défini sur proxyserver.fabrikam.com) et Enabled (qui, dans ce cas, est défini sur True).

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

$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x

L’exemple 2 illustre comment créer un nouveau fournisseur public en mémoire uniquement, modifier ses propriétés et convertir ce fournisseur virtuel en fournisseur réel afin de l’utiliser dans votre organisation. Pour ce faire, la première commande de l’exemple crée un fournisseur public comportant l’identité Fabrikam. En plus des paramètres requis (Identity, ProxyFQDN et Enabled), la commande ajoute le paramètre InMemory, qui crée une instance du fournisseur uniquement existante en mémoire. Cette dernière est ensuite stockée dans une variable appelée $x.

Une fois l’instance en mémoire du fournisseur créée, la deuxième commande de l’exemple modifie la propriété VerificationLevel du fournisseur virtuel. La dernière commande utilise ensuite Set-CsPublicProvider pour convertir le fournisseur virtuel (stocké dans $x) en fournisseur public. Si vous n’appelez pas la cmdlet Set-CsPublicProvider, le fournisseur réel ne sera pas créé. Aussi, le fournisseur virtuel disparaît dès que vous mettez fin à la session Windows PowerShell ou supprimez la variable $x.