New-CsSimpleUrl
Dernière rubrique modifiée : 2012-10-17
Crée une URL simple, que vous pouvez ensuite ajouter à une collection de configurations d’URL simples. 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
New-CsSimpleUrl -Component <String> -Domain <String> [-ActiveUrl <String>] [-SimpleUrlEntry <PSListModifier>]
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. En outre, 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.
Pour ajouter une URL réelle à une collection d’URL simples, vous devez d’abord créer l’URL à l’aide des applets de commande New-CsSimpleUrl et New-CsSimpleUrlEntry. L’applet de commande New-CsSimpleUrlEntry crée une entrée d’URL : URL (exemple : https://meet.litwareinc.com) pouvant être utilisée comme URL simple (à des fins de réunion, d’administration ou de conférence rendez-vous). L’objet créé par New-CsSimpleUrlEntry est ajouté à la propriété SimpleUrlEntry d’une nouvelle URL simple. Vous devez utiliser une applet de commande distincte pour créer l’objet, car la propriété SimpleUrlEntry peut contenir plusieurs URL (toutefois, une seule URL de ce type peut être désignée comme URL active. L’URL active représente l’URL réelle utilisée pour les réunions, l’administration ou les conférences rendez-vous).
Après avoir créé une entrée URL simple, vous utilisez ensuite l’applet de commande New-CsSimpleUrl pour créer une instance en mémoire seule d’une URL simple, qui définit des éléments tels que le composant (type d’URL simple), le domaine, l’URL active et toutes les entrées URL simple. Après avoir créé un objet représentant l’URL simple, ce dernier peut être ajouté à une collection (nouvelle ou existante) d’URL simples. Après avoir mis à jour une collection d’URL simples, vous devez exécuter l’applet de commande Enable-CsComputer.
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande New-CsSimpleUrl : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette applet de commande 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 "New-CsSimpleUrl\b"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Component |
Obligatoire |
Chaîne |
Indique le type d’URL simple créée. Les valeurs valides sont les suivantes : Meet : URL utilisée pour la gestion des réunions. Admin : URL pointant vers le Panneau de configuration Lync Server 2010. Dialin : URL utilisée pour les conférences rendez-vous. Par exemple : -Component "Meet". |
Domain |
Obligatoire |
Chaîne |
Domaine SIP de l’URL simple. Par exemple : -Domain "litwareinc.com". |
SimpleUrlEntry |
Facultatif |
Modificateur de liste PS |
Collection d’URL pour le composant spécifié. Par exemple, les deux URL https://meet.litwareinc.com et https://litwareinc.com/meet peuvent être configurées comme des entrées d’URL pour le composant Réunion. Cependant, une seule de ces URL peut (et doit) être configurée comme URL active. Vous devez créer des entrées d’URL simple à l’aide de l’applet de commande New-CsSimpleUrlEntry. |
ActiveUrl |
Facultatif |
Chaîne |
Indique l’URL à laquelle les utilisateurs accèdent réellement. La propriété SimpleUrlEntry peut contenir plusieurs URL. Toutefois, vous ne pouvez activer qu’une seule URL à un moment donné. Une erreur se produit si vous essayez de définir ActiveUrl sur une valeur introuvable dans la propriété SimpleUrlEntry. Pour affecter une URL active, utilisez simplement l’URL proprement dite comme valeur de paramètre. Par exemple : -ActiveUrl "https://meet.litwareinc.com". |
Types d’entrées
Aucun. New-CsSimpleUrl n’accepte pas les données transmises via le pipeline.
Types de retours
New-CsSimpleUrl crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrl.
Exemple
-------------------------- Exemple 1 --------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry -ActiveUrl "https://meet.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl}
L’exemple ci-dessus explique comment ajouter une nouvelle URL à une collection existante d’URL simples. Pour commencer, la première commande de l’exemple utilise New-CsSimpleUrlEntry pour créer une entrée d’URL pointant sur https://meet.fabrikam.com. Cette entrée d’URL est stockée dans une variable appelée « $urlEntry ».
Dans la deuxième commande, l’applet de commande New-CsSimpleUrl est utilisée pour créer une instance en mémoire uniquement d’une URL simple. Dans cet exemple, le composant URL est défini sur Meet. Le domaine est défini sur fabrikam.com. La propriété ActiveUrl est définie sur https://meet.fabrikam.com et la propriété SimpleUrlEntry sur $urlEntry, $urlEntry représentant l’entrée d’URL créée dans la première commande.
Après la création de l’URL (et son stockage dans la référence d’objet $simpleUrl), la dernière commande de l’exemple ajoute la nouvelle URL à la collection d’URL simples du site Redmond. Cette opération est effectuée à l’aide de l’applet de commande Set-CsSimpleUrlConfiguration, du paramètre SimpleUrl et de la valeur de paramètre @{Add=$simpleUrl}. Cette syntaxe fait en sorte que l’URL stockée dans la référence d’objet $simpleUrl soit ajoutée à la propriété SimpleUrl.