Get-CsAutodiscoverConfiguration
Dernière rubrique modifiée : 2012-04-23
Retourne des informations sur les paramètres de configuration de découverte automatique utilisés dans l’organisation. 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
Get-CsAutodiscoverConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAutodiscoverConfiguration [-Filter <String>] [-LocalStore <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 assignées aux paramètres de configuration de découverte automatique, qui peuvent être ensuite appliqués à l’étendue globale ou à l’étendue de Site. La cmdlet Get-CsAutoDiscoverConfiguration permet de retourner des informations sur les paramètres (et les URL) de découverte automatique actuellement utilisés dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter la cmdlet Get-CsAutoDiscoverConfiguration localement : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Identité XDS |
Identificateur unique pour la collection de paramètres de configuration de découverte automatique à récupérer. Pour récupérer les paramètres globaux, utilisez la syntaxe suivante : -Identity global Pour récupérer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe du type : -Identity "site:Redmond" Si ce paramètre n’est pas inclus, alors Get-CsAutoDiscoverConfiguration retournera tous les paramètres de configuration de découverte automatique actuellement utilisés dans votre organisation. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques afin de spécifier l’identité des paramètres de configuration de découverte automatique à retourner. Par exemple, cette syntaxe retourne tous les paramètres configurés au niveau de l’étendue Site : -Filter "site:*" Notez que vous ne pouvez pas utiliser les paramètres Identity et Filter dans la même commande. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de configuration de découverte automatique du réplica local du magasin central de gestion et non du du magasin central de gestion proprement dit. |
Types d’entrées
Get-CsAutoDiscoverConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsAutoDiscoverConfiguration retourne les instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.AutoDiscoverConfiguration.AutoDiscoverConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsAutoDiscoverConfiguration
La commande illustrée dans l’exemple 1 retourne tous les paramètres de configuration de la découverte automatique actuellement utilisés dans l’organisation.
-------------------------- Exemple 2 --------------------------
Get-CsAutoDiscoverConfiguration -Identity "global"
Dans l’exemple 2, une seule collection de paramètres de configuration de découverte automatique est retournée : la collection globale.
-------------------------- Exemple 3 --------------------------
Get-CsAutoDiscoverConfiguration -Filter "site:*"
La commande ci-dessus retourne les paramètres de configuration de découverte automatique attribués à l’étendue Site. Pour ce faire, le paramètre Filter et la valeur de filtre "site:*" sont inclus. Cette valeur de filtre retourne uniquement les paramètres dont l’identité commence par la valeur de chaîne "site:". Par définition, tous les paramètres dont l’identité commence par la valeur de chaîne "site:" sont des paramètres configurés dans l’étendue Site.
-------------------------- Exemple 4 --------------------------
Get-CsAutoDiscoverConfiguration | Where-Object {$_.WebLinks -like "*fabrikam.com"}
La commande de l’exemple 4 retourne tous les paramètres de configuration de découverte automatique qui incluent une URL de découverte automatique pour fabrikam.com. Pour effectuer cette tâche, la commande utilise d’abord Get-CsAutoDiscoverConfiguration pour retourner une collection de tous les paramètres de découverte automatique actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres dont la propriété WebLinks inclut la valeur de chaîne "fabrikam.com".