Partager via

  • Article

Set-CsSimpleUrlConfiguration

 

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

Modifie une collection existante 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

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

Set-CsSimpleUrlConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 la version précédente d’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 diriger 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. Une fois les collections créées, l’applet de commande Set-CsSimpleUrlConfiguration vous donne également la possibilité de modifier les URL stockées dans ces collections.

L’ajout d’une URL simple à une collection est raisonnablement aisé. Dans un premier temps, vous devez utiliser les applets de commande New-CsSimpleUrl and New-CsSimpleUrlEntry pour créer une URL en mémoire uniquement. Vous utilisez ensuite la commande Add pour ajouter la nouvelle URL à la collection existante. Vous pouvez également recourir à la méthode Replace pour remplacer toutes les URL existantes par la nouvelle.

La suppression d’une URL d’une collection est une opération un peu plus délicate ; en effet, vous devez tout d’abord créer une nouvelle référence d’objet à cette URL (qui imite l’URL existante), puis utiliser cette référence d’objet et la méthode Remove pour supprimer l’URL.

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 Set-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 "Set-CsSimpleUrlConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique pour la collection d’URL simples à modifier. Pour modifier la collection globale, utilisez cette syntaxe : -Identity global. Pour modifier une collection au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond."

Si ce paramètre n’est pas spécifié, la collection globale sera modifiée.

Instance

Facultatif

Objet SimpleUrlConfiguration

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

SimpleUrl

Facultatif

Modificateur de liste PS

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

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 2010.

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

Objet Microsoft.Rtc.Management.WritableConfig.Settings.SimpleUrl.SimpleUrlConfiguration. Set-CsSimpleUrlConfiguration accepte les instances transmises via le pipeline de l’objet de configuration d’URL simples.

Types de retours

Aucun.

Exemple

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl $Null

La commande présentée dans l’exemple 1 supprime toutes les URL simples du site Redmond mais ne supprime pas la collection d’URL simples proprement dite. (La collection existera toujours, mais elle ne contiendra plus aucune URL). Pour ce faire, la commande utilise le paramètre SimpleUrl et définit la valeur du paramètre sur Null ($Null). Ceci supprime toutes les URL simples de la collection.

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

$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é SimpleUrl 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 3 ------------------------

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

Set-CsSimpleUrlConfiguration -Identity "site:Redmond" -SimpleUrl @{Remove=$simpleUrl}

Les commandes présentées dans l’exemple 3 expliquent comment supprimer une URL unique d’une collection d’URL simples. Parce que l’applet de commande Set-CsSimpleUrlConfiguration doit travailler avec des objets URL, l’exemple commence par créer un nouvel objet qui contient les mêmes valeurs de propriété que l’URL à supprimer. Pour cela, la première commande 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 nommée $urlEntry.

Une fois l’entrée d’URL créée, la deuxième commande utilise l’applet de commande New-CsSimpleUrl 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é SimpleUrl sur $urlEntry, $urlEntry représentant l’entrée d’URL créée dans la première commande. Cette opération crée une URL en mémoire ($simpleUrl) dotée des mêmes valeurs de propriété que l’URL à supprimer.

La dernière commande de l’exemple supprime ensuite l’URL de la collection d’URL simples pour le 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 @{Remove=$simpleUrl}. Cette syntaxe indique simplement que l’URL stockée dans la référence d’objet $simpleUrl doit être supprimée de la propriété SimpleUrl.