Get-CsSimpleUrlConfiguration
Dernière rubrique modifiée : 2012-03-23
Renvoie des informations sur les URL simples configurées et utilisées dans une organisation. Les URL simples permettent aux utilisateurs de rejoindre plus facilement des réunions et des conférences, et aux administrateurs de se connecter plus aisément au Panneau de configuration Microsoft Lync Server 2010.
Syntaxe
Get-CsSimpleUrlConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsSimpleUrlConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Description détaillée
Dans Microsoft Office Communications Server 2007 R2, les URL des réunions étaient similaires à ce qui suit :
De telles URL n’étaient toutefois pas vraiment intuitives et plutôt difficiles à transmettre. Les URL simples introduites dans Lync Server 2010 remédient à ces problèmes en fournissant aux utilisateurs des URL qui ressemblent davantage à ceci :
https://meet.litwareinc.com/kenmyer/071200
Les URL simples ont donc été nettement améliorées par rapport à celles utilisées dans Office Communications Server. Toutefois, les URL simples ne sont pas créées automatiquement pour vous ; vous devez en effet les configurer vous-même. (Vous devrez également créer des enregistrements DNS (Domain Name System) pour chaque URL, configurer des règles de proxy inverse pour l’accès externe, ajouter des URL simples à vos certificats du serveur frontal, etc.)
Lync Server vous permet de créer trois URL simples différentes :
Meet : utilisée pour les réunions. Il vous faut au moins une URL Meet par domaine SIP.
Admin : utilisée pour orienter les administrateurs vers le Panneau de configuration Lync Server 2010.
Dialin : utilisée pour la page Web des conférences rendez-vous.
Les URL simples sont stockées dans les collections de configuration d’URL simples. Lorsque vous installez Lync Server, une collection globale est créée pour vous, que vous pouvez utiliser pour créer des collections personnalisées au niveau de l’étendue Site. Cela vous permet d’utiliser différentes URL simples sur chacun de vos sites.
La cmdlet Get-CsSimpleUrlConfiguration permet de récupérer des informations sur les collections de configuration d’URL simples utilisées actuellement dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsSimpleUrlConfiguration : RTCUniversalUserAdmins, 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 "Get-CsSimpleUrlConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique pour la collection d’URL simples à retourner. Pour retourner la collection globale, utilisez la syntaxe : -Identity global. Pour retourner une collection à partir de l’étendue du site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond." Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez une identité. Si vous avez besoin d’utiliser des caractères génériques, mieux vaut inclure le paramètre Filter. Le fait d’appeler Get-CsSimpleUrlConfiguration sans paramètres retourne toutes les URL simples configurées pour être utilisées dans votre organisation. |
Filter |
Facultatif |
Chaîne |
Vous permet d’utiliser des caractères génériques pour spécifier la ou les collections d’URL simples à retourner. Par exemple, la syntaxe suivante retourne toutes les collections d’URL simples configurées au niveau de l’étendue Site : -Filter "site:*". Notez que vous ne pouvez pas utiliser les paramètres Filter et Identity dans la même commande. |
Tenant |
Facultatif |
GUID |
Ce paramètre n’est pas utilisé pour la version sur site de Lync Server 2010. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données de configuration d’URL simples depuis le réplica local du magasin central de gestion et non du magasin central de gestion proprement dit. |
Types d’entrées
Aucun.
Types de retours
Get-CsSimpleUrlConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsSimpleUrlConfiguration
La commande précédente retourne les informations de toutes les collections de configuration d’URL simples utilisées actuellement dans votre organisation. Cela est possible en appelant Get-CsSimpleUrlConfiguration sans paramètres supplémentaires.
-------------------------- Exemple 2 --------------------------
Get-CsSimpleUrlConfiguration -Identity "site:Redmond"
Dans l’exemple 2, les informations sont renvoyées pour une seule collection de configuration d’URL simple : la configuration avec l’identité site:Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsSimpleUrlConfiguration -Filter "site:*"
L’exemple 3 retourne les informations pour les collections de configuration d’URL simples qui ont été assignées à l’étendue du site. Pour ce faire, on appelle Get-CsSimpleUrlConfiguration et le paramètre Filter. La valeur de filtre « site:* » limite les données retournées aux collections ayant une identité qui commence par la valeur de chaîne « site: ».
-------------------------- Exemple 4 --------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl
À l’exemple 4, les informations détaillées sont affichées pour chaque URL simple configurée pour votre organisation. Pour effectuer cette tâche, la commande appelle d’abord Get-CsSimpleUrlConfiguration pour retourner un ensemble complet d’informations relatives aux URL simples. Ces données sont ensuite acheminées vers la cmdlet Select-Object, qui utilise le paramètre ExpandProperty pour « développer » la valeur de la propriété SimpleUrl. Le fait de développer une valeur de propriété affiche toutes les données enregistrées dans cette propriété au format de lecture facile.
-------------------------- Exemple 5 ------------------------
Get-CsSimpleUrlConfiguration | Select-Object -ExpandProperty SimpleUrl | Where-Object {$_.Component -eq "Meet"}
La commande illustrée à l’exemple 5 retourne toutes les URL simples de gestion de réunion utilisées actuellement dans votre organisation. Pour ce faire, la commande appelle d’abord Get-CsSimpleUrlConfiguration sans paramètres supplémentaires, ce qui permet de retourner un ensemble complet d’informations concernant les URL simples. Ces données sont ensuite acheminées vers la cmdlet Select-Object, qui utilise le paramètre ExpandProperty pour développer la valeur de la propriété SimpleUrl. La collection filtrée est ensuite acheminée vers la cmdlet Where-Object qui sélectionne uniquement les URL simples pour lesquelles la propriété Component est égale à Meet.
Voir aussi
Autres ressources
New-CsSimpleUrlConfiguration
Remove-CsSimpleUrlConfiguration
Set-CsSimpleUrlConfiguration