Set-CsPublicProvider
Dernière rubrique modifiée : 2012-03-25
Modifie un fournisseur public actuellement configuré pour être utilisé 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
Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<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 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, les utilisateurs pourront échanger des messages instantanés et des informations de présence avec toute personne disposant d’un compte de messagerie instantanée MSN (en fonction du mode de configuration de votre système).
Pour établir une fédération avec un fournisseur public, vous devrez créer et activer un nouveau fournisseur public (en outre, le fournisseur public devra créer une relation de fédération avec vous). Lync Server inclut trois fournisseurs publics (Yahoo!, AOL et Windows Live) qui sont préconfigurés pour vous. Lorsque des fournisseurs publics supplémentaires deviennent disponibles, vous pouvez créer des relations de fédération avec ces derniers à l’aide de la cmdlet New-CsPublicProvider. Une fois les relations fédérées établies, vous pouvez ensuite utiliser la cmdlet Set-CsPublicProvider pour modifier les valeurs de deux propriétés importantes (Enabled et VerificationLevel) pour ces relations.
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-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 "Set-CsPublicProvider"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
Chaîne |
Identificateur unique du fournisseur public à modifier. L’identité est généralement le nom du site Web fournissant les services (par exemple, Yahoo!, AOL, MSN, etc.). |
Instance |
Facultatif |
Objet DisplayPublicProvider |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
Enabled |
Facultatif |
Paramètre de commutateur |
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. |
VerificationLevel |
Facultatif |
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. Ce niveau de vérification doit être paramétré 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 |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
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.DisplayPublicProvider. Set-CsPublicProvider accepte les instances transmises via le pipeline de l’objet de fournisseur public.
Types de retours
Set-CsPublicProvider ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"
La commande ci-dessus définit le paramètre VerificationLevel pour le fournisseur public dont l’identité est MSN. Pour cette opération, le paramètre VerificationLevel et le paramètre UseSourceVerification sont inclus.
-------------------------- Exemple 2 ------------------------
Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"
Dans l’exemple 2, le niveau de vérification est modifié pour tous les fournisseurs publics actuellement utilisés dans l’organisation. Pour cela, la commande appelle d’abord Get-CsPublicProvider (sans aucun paramètre) pour retourner une collection de tous les fournisseurs publics actuellement configurés en vue d’une utilisation. Cette collection est ensuite redirigée vers la cmdlet Set-CsPublicProvider qui sélectionne chaque fournisseur de la collection et redéfinit la valeur de la propriété VerificationLevel sur UseSourceVerification.
-------------------------- Exemple 3
Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"
La commande présentée dans l’exemple 3 modifie le niveau de vérification de tous les fournisseurs publics pour lequel ce niveau est actuellement défini sur 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 la cmdlet Where-Object qui sélectionne uniquement les fournisseurs dont la propriété VerificationLevel est égale à AlwaysVerifiable. Cette collection filtrée est ensuite redirigé vers Set-CsPublicProvider qui redéfinit la propriété VerificationLevel pour chaque fournisseur de la collection sur UseSourceVerification.
Voir aussi
Autres ressources
Disable-CsPublicProvider
Enable-CsPublicProvider
Get-CsPublicProvider
New-CsPublicProvider
Remove-CsPublicProvider