New-CsSimpleUrlEntry
Dernière rubrique modifiée : 2012-10-17
Crée une entrée URL simple, un élément requis lors de la création d’une URL simple. 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-CsSimpleUrlEntry -Url <String>
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. Vous devez disposer d’au moins une URL Meet pour chacun de vos domaines 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 URL. Il ne s’agit de rien de plus qu’une URL (comme https://meet.litwareinc.com) qui peut être utilisée comme une URL simple (à des fins de réunions, d’administration ou de conférence rendez-vous). L’objet créé par New-CsSimpleUrlEntry est ensuite 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 comporter plusieurs URL. (Toutefois, une seule URL de ce type peut être désignée comme l’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-CsSimpleUrlEntry : 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-CsSimpleUrlEntry"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Url |
Obligatoire |
Chaîne |
URL à ajouter à la propriété SimpleUrlEntry d’une URL simple. Par exemple : -Url "https://meet.litwareinc.com". Les URL doit commencer par le préfixe https:. |
Types d’entrées
Aucun.
Types de retours
New-CsSimpleUrlEntry crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.SimpleUtl.SimpleUrlEntry.
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.
-------------------------- Exemple 2 ------------------------
$urlEntry = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$urlEntry2 = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrl $urlEntry -ActiveUrl "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrl $urlEntry -ActiveUrl "https://dialin.fabrikam.com"
Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl, $simpleUrl2}
Dns l’exemple 2, deux entrées URL sont ajoutées à une collection existante d’URL simples. Pour cela, 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. La deuxième commande crée ensuite une deuxième entrée URL, qui est stockée dans la variable $urlEntry2 et pointe vers l’URL https:// dialin.fabrikam.com.
Après la création des deux entrées URL, New-CsSimpleUrl permet de créer deux instances en mémoire seule d’une URL simple. Dans la première instance, le composant URL est défini sur Meet, le domaine sur fabrikam.com et la propriété ActiveUrl sur https://meet.fabrikam.com. Dans la deuxième instance, le composant est défini sur Dialin, le domaine sur un astérisque (*) et la propriété ActiveURL sur https://dialin.fabrikam.com.
Après la création des URL (et leur stockage dans les références d’objet $simpleUrl et $simpleUrl2), 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, $simpleUrl2}. Cette syntaxe fait en sorte que les URL stockées dans les références d’objet $simpleUrl et $simpleUrl2 soient ajoutées à la propriété SimpleUrl.