New-CsWebLink
Dernière rubrique modifiée : 2012-04-23
Crée un lien Web qui pointe vers le service de découverte automatique. Ce service permet aux applications clientes telles que Lync Web Access ou Microsoft Lync Mobile de localiser des ressources essentielles, par exemple le pool d’accueil d’un utilisateur ou l’URL qui permet de se joindre à une conférence rendez-vous.
Syntaxe
New-CsWebLink -Href <String> -Token <String>
Description détaillée
Pour que les applications clientes utilisent au mieux Microsoft Lync Server 2010, elles doivent connaître l’emplacement des principaux composants Lync Server 2010. Par exemple, les utilisateurs authentifiés doivent pouvoir localiser leur pool d’accueil, car c’est le seul moyen qui permet de les authentifier. De même, les utilisateurs non authentifiés doivent pouvoir localiser l’URL utilisée pour se joindre à une conférence.
Si tous vos utilisateurs se sont connectés derrière le pare-feu de l’organisation, localiser ces emplacements est assez simple. Cependant, cette tâche se complique lorsqu’ils accèdent au système par l’extérieur via Microsoft Lync Mobile ou Lync Web Access.
C’est notamment le cas dans les scénarios de domaine fractionné, où certains utilisateurs d’une organisation ont des comptes sur la version sur site de Lync Server et d’autres sur Microsoft Office 365. Dans ce cas, les comptes d’utilisateurs peuvent être situés dans différentes forêts Active Directory, ce qui peut être problématique : par exemple, si un utilisateur basé aux États-Unis se connecte d’Europe, le système doit pouvoir le reconnaître dans sa forêt et soumettre la demande de connexion au pool approprié.
Le service de découverte automatique a été introduit en novembre 2011 dans Lync Server de façon à résoudre ces problèmes. Lorsqu’une application cliente tente d’accéder à Lync Server, le service de découverte automatique analyse l’adresse SIP du client et redirige la demande au pool approprié. Les applications clientes se connectent au service de découverte automatique en envoyant une demande HTTP à une URL de découverte automatique. Ces dernières doivent être configurées par les administrateurs pour que le service de découverte automatique fonctionne (ils doivent également créer les enregistrements DNS qui correspondent à ces URL).
Les URL de découverte automatique sont attribuées à des paramètres de configuration de découverte automatique, qui peuvent être appliqués à l’étendue globale ou à l’étendue Site. Lorsque vous installez Lync Server, une collection globale de paramètres est créée (mais aucune URL de découverte automatique ne lui est affectée). Si une collection unique de paramètres de découverte automatique ne répond pas à vos besoins, vous pouvez utiliser la cmdlet New-CsAutoDiscoverConfiguration pour créer d’autres paramètres de configuration au niveau de l’étendue Site.
La gestion des paramètres de configuration de découverte automatique implique l’ajout d’URL de découverte automatique. Ces URL doivent être créées avec la cmdlet New-CsWebLink, et l’URL qui en résulte doit être stockée dans une variable, puis ajoutée à une collection de paramètres de configuration de découverte automatique. Les URL de découverte automatique sont basées sur les domaines SIP utilisés dans votre organisation. Les administrateurs créent en général une URL pour les utilisateurs qui sont à l’extérieur du pare-feu de l’organisation (par exemple, http://LyncDiscover.litwareinc.com) et une autre (par exemple, http://LyncDiscoverInternal.litwareinc.com) pour ceux qui se trouvent à l’intérieur.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet New-CsWebLink : RTCUniversalServerAdmins.
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Href |
Obligatoire |
Chaîne |
URL pour le service de découverte automatique, par exemple : –Href "http://LyncDiscover.fabrikam.com" |
Token |
Obligatoire |
Chaîne |
Nom unique à donner à l’URL. Par exemple : -Token "Fabrikam" |
Types d’entrées
Aucun. New-CsWebLink n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée des instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.WebLink.WebLink.
Exemple
-------------------------- Exemple 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
Les commandes de l’exemple 1 ajoutent une URL de découverte automatique (http://LyncDiscover.fabrikam.com) aux paramètres de configuration de découverte automatique affectés au site de Redmond. Pour ce faire, la première commande de l’exemple utilise la cmdlet New-CsWebLink pour créer une URL de découverte automatique, qui est stockée dans une variable nommée $Link1. Ensuite, Set-CsAutoDiscoverConfiguration permet d’ajouter la nouvelle URL à toute URL déjà affectée à ces paramètres. Cette opération est effectuée à l’aide du paramètre WebLinks et de la valeur de paramètre @{Add=$Link1}.
-------------------------- Exemple 2 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
$Link2 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscoverInternal.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1,$Link2}
Les commandes précédentes affectent deux URL de découverte automatique (http://LyncDiscover.fabrikam.com et http://LyncDiscoverInternal.fabrikam.com) aux paramètres de configuration de découverte automatique affectés au site de Redmond. Pour ce faire, les deux premières commandes utilisent la cmdlet New-CsWebLink pour créer les deux URL de découverte automatique, qui sont ensuite stockées dans des variables nommées $Link1 et $Link2. Lorsque les deux URL sont créées, la troisième commande utilise Set-CsAutoDiscoverConfiguration pour les affecter au site de Redmond. Pour ce faire, le paramètre WebLinks est inclus avec la valeur de paramètre @{Add=$Link1,$Link2}. Cette syntaxe permet aux valeurs stockées dans les variables $Link1 et $Link2 d’être ajoutées à la propriété WebLinks des paramètres.