Partager via


New-CsSimpleUrlConfiguration

 

Dernière rubrique modifiée : 2012-10-17

Crée une collection de configuration d’URL simples. Les URL simples permettent aux utilisateurs de rejoindre plus facilement les réunions et les conférences. En outre, elles permettent aux administrateurs de se connecter plus aisément au Panneau de configuration Microsoft Lync Server 2010.

Syntaxe

New-CsSimpleUrlConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SimpleUrl <PSListModifier>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Dans Microsoft Office Communications Server 2007 R2, les URL des réunions étaient similaires à ce qui suit :

https://imdf.litwareinc.com/Join?uri=sip%3Akenmyer%40litwareinc.com%3Bgruu%3Bopaque%3Dapp%3Aconf%3Afocus%3Aid%3A125f95a0b0184dcea706f1a0191202a8\&key=EcznhLh5K5t

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 avoir au moins une URL Meet pour chaque 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.

Les collections de configurations d’URL simples sont créées à l’aide de l’applet de commande New-CsSimpleUrlConfiguration ; vous pouvez ensuite utiliser d’autres applets de commande (par exemple, New-CsSimpleUrl et Set-CsSimpleUrlConfiguration) pour remplir ces collections 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-CsSimpleUrlConfiguration : 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-CsSimpleUrlConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la nouvelle collection de configurations d’URL simples. Parce que les nouvelles collections ne peuvent être créées qu’au niveau de l’étendue Site, la propriété Identity doit être représentée par le préfixe « site: » suivi du nom du site. Par exemple, la syntaxe suivante crée une collection pour le site Redmond : -Identity "site:Redmond".

SimpleUrl

Facultatif

Modificateur de liste PS

URL simples ayant été configurées pour cette collection. Ces URL doivent être créées à l’aide des applets de commande New-SimpleUrl et New-SimpleUrlEntry.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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.

Tenant

Facultatif

GUID

Ce paramètre n’est pas utilisé pour la version sur site de Lync Server.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun.

Types de retours

New-CsSimpleUrlConfiguration crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration.

Exemple

-------------------------- Exemple 1 ------------------------

New-CsSimpleUrlConfiguration -Identity "site:Redmond"

La commande illustrée dans l’exemple 1 crée une collection d’URL simples pour le site Redmond. Étant donné que seul le paramètre Identity est inclus à cette commande, la nouvelle collection ne contiendra aucune URL simple. Cette commande échouera si le site Redmond héberge déjà une collection d’URL simples.

-------------------------- Exemple 2 ------------------------

$urlEntry = New-CsSimpleUrlEntry -Url "https://dialin.fabrikam.com"
$simpleUrl = New-CsSimpleUrl -Component "dialin" -Domain "*" -SimpleUrlEntry $urlEntry -ActiveUrl "https://dialin.fabrikam.com"

$urlEntry2 = New-CsSimpleUrlEntry -Url "https://meet.fabrikam.com"
$simpleUrl2 = New-CsSimpleUrl -Component "meet" -Domain "fabrikam.com" -SimpleUrlEntry $urlEntry2 

New-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Add=$simpleUrl,$simpleUrl2}

L’exemple ci-dessus illustre la création d’une collection d’URL simples incluant deux URL simples (l’une pour la gestion des réunions et l’autre pour les conférences rendez-vous). Pour cela, la première commande de l’exemple utilise New-CsSimpleUrlEntry pour créer une entrée d’URL pointant sur https://dialin.litwareinc.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 d’URL, pointant sur https://meet.fabrikam.com.

Ensuite, 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 dialin, le domaine sur un astérisque (*), ActiveUrl sur https://dialin.fabrikam.com et la propriété SimpleUrl sur $urlEntry. (La variable $urlEntry représente l’entrée d’URL créée dans la première commande.) Une commande similaire est ensuite utilisée pour créer une URL simple pour meet.fabrikam.com.

Une fois l’URL créée (et stockée dans les références d’objet $simpleUrl et $simpleUrl2), la commande finale de l’exemple crée une collection d’URL simples pour le site Redmond et ajoute les deux nouvelles URL en mémoire uniquement à cette collection. Les nouvelles URL sont ajoutées à la collection à l’aide de l’applet de commande New-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.