New-CsMcxConfiguration

 

Dernière rubrique modifiée : 2012-04-23

Crée une collection de paramètres de configuration Microsoft Lync Server 2010 Mobility Service au niveau de l’étendue Site ou Service. Le service Mobility Service permet aux utilisateurs de téléphones mobiles, comme les iPhones et les Windows Phones, d’échanger des messages instantanés et des informations de présence, de stocker et d’extraire des messages vocaux en interne sans passer par leur opérateur de téléphonie mobile et de bénéficier de fonctionnalités Microsoft Lync Server 2010 telles que l’Appel via le bureau et les conférences d’appels sortants, par exemple.

Syntaxe

New-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Microsoft Lync Server 2010 Mobility Service étend de nombreuses fonctionnalités de Microsoft Lync 2010 aux appareils mobiles tels que les iPhones Apple, les téléphones Windows Phone, Android et Nokia. Les utilisateurs peuvent notamment utiliser ces téléphones pour échanger des messages instantanés et des informations de présence et pour recevoir des notifications de nouveaux messages vocaux. Le service de notification push (service de notification push d’Apple et service de notification push de Microsoft Lync Server 2010) permet aux utilisateurs d’iPhones ou de téléphones Windows Phone de recevoir ces notifications même lorsque Lync 2010 fonctionne en arrière-plan. Le service Mobility Service permet également aux organisations d’activer la fonction Appel via le bureau, qui permet aux utilisateurs de passer un appel depuis leur téléphone mobile et de l’afficher comme provenant de leur téléphone professionnel. Les systèmes d’identification de l’appelant, par exemple, affichent le numéro de téléphone professionnel de la personne qui appelle et non son numéro de téléphone mobile.

Le service Mobility Service est géré par les paramètres de configuration Mobility Service, qui peuvent être appliqués à l’étendue globale, à l’étendue Site ou à l’étendue Service (uniquement pour le service de serveur Web). Ces paramètres contrôlent, par exemple, la durée maximale d’une session Mobility Service, si le service de découverte automatique Microsoft Lync Server 2010 (qui dirige les utilisateurs Mobility Service vers le pool de serveurs d’inscriptions approprié) est accessible à tous les utilisateurs connectés à l’extérieur du pare-feu de l’organisation et l’emplacement du fournisseur de services de notification push.

Lorsque vous installez Lync Server 2010, une collection unique de paramètres de configuration Mobility Service est créée au niveau de l’étendue globale. Les administrateurs peuvent cependant utiliser la cmdlet New-CsMcxConfiguration pour créer des paramètres de configuration personnalisés au niveau de l’étendue Site ou Service.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet New-CsMcxConfiguration : RTCUniversalServerAdmins.

Paramètres

Paramètre	Obligatoire	Type	Description
Identity	Obligatoire	XdsIdentity	Identificateur unique de la collection de paramètres de configuration Mobility Service à créer. Pour créer les paramètres au niveau de l’étendue Site, utilisez le préfixe "site:" suivi du nom de site. Par exemple : -Identity "site:Redmond" Pour créer des paramètres configurés au niveau de l’étendue Service, utilisez une syntaxe comparable à celle-ci : -Identity service:WebServer:atl-cs-001.litwareinc.com
ExposedWebURL	Facultatif	Objet ExposedWebURL	Indique si l’URL utilisée par le service de découverte automatique est accessible à tous les utilisateurs dans le pare-feu de l’organisation et en dehors (externe) ou uniquement aux utilisateurs dans le pare-feu (interne). Les valeurs autorisées sont les suivantes : Internal ou External. La valeur par défaut est External.
PushNotificationProxyUri	Facultatif	Chaîne	URI d’un fournisseur de service qui peut transférer des demandes de notification push au service de notification push d’Apple et au service de notification push Microsoft Lync Server 2010. L’URI PushNotificationProxyUri doit être spécifié sous la forme d’une adresse SIP ; par exemple : -PushNotificationProxyUri "sip:push@push.lync.com"
SessionExpirationInterval	Facultatif	Entier	Durée en secondes d’une session mobile pour les utilisateurs d’iPhone ou de téléphone Windows Phone. Si Lync 2010 fonctionne en arrière-plan, les utilisateurs reçoivent des notifications push tant que l’intervalle d’expiration de session n’a pas expiré. L’appareil mobile doit envoyer une notification au serveur avant le délai d’expiration de la session pour indiquer qu’il est toujours actif. S’il ne le fait pas, il est répertorié comme inactif et l’utilisateur doit se reconnecter au système. Cette propriété peut être définie sur un entier de 120 à 4 294 967 295, inclus. La valeur par défaut est 259 200 secondes (3 jours). Notez que la valeur de la propriété SessionExpirationInterval doit être supérieure à celle de la propriété SessionShortExpirationInterval.
SessionShortExpirationInterval	Facultatif	Entier	Durée, en secondes, d’une session mobile pour les utilisateurs de téléphone Android ou Nokia. L’appareil mobile doit envoyer une notification au serveur avant le délai d’expiration de la session pour indiquer qu’il est toujours actif. S’il ne le fait pas, il est répertorié comme inactif et l’utilisateur doit se reconnecter au système. Cette propriété peut être définie sur un entier de 120 à 4 294 967 295, inclus. La valeur par défaut est 259 200 secondes (3 jours). Notez que la valeur de la propriété SessionExpirationInterval doit être supérieure à celle de la propriété SessionShortExpirationInterval.
InMemory	Facultatif	SwitchParameter	Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie d’une commande 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	SwitchParameter	Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.
WhatIf	Facultatif	SwitchParameter	Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.
Confirm	Facultatif	SwitchParameter	Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Aucun. New-CsMcxConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Crée des instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.

Exemple

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

New-CsMcxConfiguration -Identity "site:Redmond" -ExposedWebURL Internal -SessionShortExpirationInterval 7200

Dans l’exemple 1, une collection de paramètres de configuration Mobility Service est créée pour le site de Redmond (et lui est automatiquement affectée). Dans cet exemple, deux modifications sont apportées aux paramètres de configuration par défaut Mobility Service : la propriété ExposedWebURL a la valeur Internal et la propriété SessionShortExpirationInterval est définie sur 7 200 secondes.

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

Get-CsService -WebServer | ForEach-Object {New-CsMcxConfiguration -Identity $_.Identity -ExposedWebURL Internal -SessionShortExpirationInterval 7200}

Dans l’exemple 2, un groupe de paramètres de configuration Mobility Service identiques est créé pour chaque serveur Web en cours d’utilisation dans une organisation. Pour exécuter cette tâche, la cmdlet Get-CsService est utilisée, avec le paramètre WebServer, pour retourner une collection de tous les serveurs Web existants. Cette collection est ensuite redirigée vers la cmdlet objet For-Each. ForEach-Object prend ensuite chaque élément de la collection et exécute la cmdlet New-CsMcxConfiguration pour créer de nouveaux paramètres de configuration Mobility Service sur ce serveur.

-------------------------- Exemple 3 --------------------------

$x = New-CsMcxConfiguration -Identity "site:Redmond" -InMemory
$x.ExposedWebURL = "Internal"
$x.SessionShortExpirationInterval = 7200
Set-CsMcxConfiguration -Instance $x

L’exemple précédent montre comment le paramètre InMemory permet de créer une collection de paramètres de configuration Mobility Service en mémoire, d’en modifier les valeurs de propriété, puis de l’enregistrer dans Lync Server. Pour ce faire, la première commande de la collection crée une collection de paramètres de configuration Mobility Service avec Identity site:Redmond. Cependant, au lieu d’être automatiquement créés et affectés au site Redmond, ces paramètres sont créés en mémoire uniquement (avec le paramètre InMemory) et sont ensuite stockés dans une variable appelée $x.

Les commandes 2 et 3 de l’exemple indiquent comment modifier les valeurs de propriété de cette collection de configuration Mobility Service virtuelle. Après avoir modifié les valeurs de propriété, vous pouvez utiliser la cmdlet Set-CsMcxConfiguration, et le paramètre Instance, pour changer les paramètres virtuels en une collection réelle de paramètres de configuration Mobility Service affectés au site Redmond. Notez que si vous n’appelez pas Set-CsMcxConfiguration, aucun paramètre ne sera affecté au site Redmond et votre collection virtuelle disparaîtra lorsque vous fermerez votre session Windows PowerShell ou que vous supprimerez la variable $x.