Set-CsAutodiscoverConfiguration
Dernière rubrique modifiée : 2012-04-23
Modifie une collection existante de paramètres de configuration de découverte automatique. Le service de découverte automatique 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 permettant de se joindre à une conférence rendez-vous.
Syntaxe
Set-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsAutodiscoverConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WebLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]
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 la version Lync Server pour 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 vers le pool approprié. Les applications clientes se connectent à ce service en envoyant une demande HTTP à une URL de découverte automatique. Pour que le service fonctionne, ces URL doivent être configurées par les administrateurs (ces derniers doivent en outre créer des enregistrements DNS qui correspondent aux 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.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet Set-CsAutoDiscoverConfiguration : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Identité XDS |
Identificateur unique de la collection des paramètres de configuration de découverte automatique à modifier. Pour modifier la collection globale, utilisez cette syntaxe : -Identity global Pour modifier une collection configurée au niveau de l’étendue Site, utilisez une syntaxe semblable à ceci : -Identity "site:Redmond" Si ce paramètre n’est pas spécifié, Set-CsAutoDiscoverConfiguration modifie automatiquement les paramètres globaux. |
Instance |
Facultatif |
Objet AutoDiscoverConfiguration |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
WebLinks |
Facultatif |
Modificateur de liste PS |
Collection d’URL de découverte automatique. Ces URL doivent être créées à l’aide de la cmdlet New-CsWebLink. |
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. |
Types d’entrées
Set-CsAutoDiscoverConfiguration accepte les données transmises via le pipeline de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Types de retours
Aucun. Set-CsAutoDiscoverConfiguration modifie les instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
$Link1 = New-CsWebLink -Token "Fabrikam" -Href "http://LyncDiscover.fabrikam.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Add=$Link1}
Les commandes présentées dans 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 cela, 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 appelée $Link1. Dans la deuxième commande, Set-CsAutoDiscoverConfiguration permet d’ajouter l’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 = Get-CsAutoDiscoverConfiguration -Identity "site:Redmond" | Select-Object -ExpandProperty WebLinks | Where-Object {$_.Token -eq "Fabrikam"}
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Remove=$Link1}
Les commandes précédentes expliquent comment supprimer une URL d’une collection de paramètres de configuration de découverte automatique. Pour cela, la première commande de la collection extrait une référence d’objet de l’URL à supprimer (une URL avec un Token égal à « Fabrikam »). Pour ce faire, il faut d’abord appeler la cmdlet Get-CsAutoDiscoverConfiguration qui extrait les paramètres de découverte automatique du site de Redmond. Cette collection est ensuite redirigée vers la cmdlet Select-Object, qui utilise le paramètre ExpandProperty pour « développer » la propriété WebLinks (lorsqu’une propriété est développée, Get-CsAutoDiscoverConfiguration peut accéder aux objets individuels qui y sont stockés). Ces objets WebLinks sont ensuite redirigés vers la cmdlet Where-Object, qui sélectionne l’objet dont la propriété Token est égale à « Fabrikam ». L’objet WebLinks est ensuite stocké dans une variable appelée $Link1.
Ensuite, la deuxième commande de l’exemple utilise Set-CsAutoDiscoverConfiguration pour supprimer l’objet stocké dans $Link1. Pour ce faire, la commande utilise le paramètre WebLinks et la valeur de paramètre @{Remove=$Link1}.
-------------------------- Exemple 3 --------------------------
$Link2 = New-CsWebLink -Token "Contoso" -Href "http://LyncDiscover.contoso.com"
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks @{Replace=$Link2}
L’exemple 3 explique comment remplacer une collection d’URL de découverte automatique par, dans notre cas, une URL unique. Pour ce faire, la première commande de l’exemple utilise la cmdlet New-CsWebLink pour créer une URL de découverte automatique pour http://LyncDiscover.contoso.com. L’URL qui en résulte est stockée dans une variable appelée $Link2. La deuxième commande utilise ensuite Set-CsAutoDiscoverConfiguration et le paramètre WebLinks pour supprimer les URL précédemment affectées au site de Redmond et les remplace par l’URL http://LyncDiscover.contoso.com. Pour cela, la commande utilise la méthode Replace, et non la méthode Add ou Remove.
-------------------------- Exemple 4 --------------------------
Set-CsAutoDiscoverConfiguration -Identity "site:Redmond" -WebLinks $Null
La commande illustrée dans l’exemple 4 supprime tous les paramètres de découverte automatique assignés au site de Redmond. Pour ce faire, la commande définit la propriété WebLinks sur une valeur nulle, ce qui supprime les URL précédemment assignées à cette propriété.