Set-CsMcxConfiguration
Dernière rubrique modifiée : 2012-04-23
Modifie une collection de paramètres de configuration Microsoft Lync Server 2010 Mobility 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
Set-CsMcxConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]
Set-CsMcxConfiguration [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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.
La cmdlet Set-CsMcxConfiguration permet aux administrateurs de modifier des paramètres de configuration Mobility Service.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet Set-CsMcxConfiguration : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Correspond à l’identificateur unique de la collection de paramètres de configuration Mobility Service à modifier. Pour modifier les paramètres globaux, utilisez la syntaxe suivante : -Identity global Pour modifier 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 modifier les paramètres configurés au niveau de l’étendue Service, utilisez une syntaxe semblable à ceci : -Identity service:WebServer:atl-cs-001.litwareinc.com Si vous ne définissez pas ce paramètre, Set-CsMcxConfiguration modifie les paramètres globaux. |
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. |
Instance |
Facultatif |
Objet de configuration MCX |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
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. |
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
Objet Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Set-CsMcxConfiguration accepte les instances transmises via le pipeline de l’objet McxConfiguration.
Types de retours
Aucun. Set-CsMcxConfiguration modifie les instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsMcxConfiguration -Identity site:Redmond -ExposedWebURL External
Dans l’exemple 1, la propriété ExposedWebURL des paramètres de configuration Mobility Service affectés au site Redmond a la valeur External.
-------------------------- Exemple 2 --------------------------
Get-CsMcxConfiguration | Set-CsMcxConfiguration -ExposedWebURL External
L’exemple 2 illustre comment une seule commande peut affecter la même valeur de propriété à tous les paramètres de configuration Mobility Service actuellement utilisés dans une organisation. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsMcxConfiguration sans paramètre de façon à retourner une collection de tous les paramètres de configuration Mobility Service. Cette collection est ensuite redirigée vers Set-CsMcxConfiguration, qui définit la propriété ExposedWebURL de chaque élément de la collection sur External.
-------------------------- Exemple 3 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.SessionShortExpirationInterval -gt 3600} | Set-CsMcxConfiguration -SessionShortExpirationInterval 3600
Dans l’exemple précédent, tous les paramètres de configuration Mobility Service dont la valeur de propriété SessionShortExpirationInterval est supérieure à 3 600 secondes sont passés sur la valeur 3 600 ; ainsi 3 600 secondes est la valeur maximale pour tous les paramètres de configuration Mobility Service dans l’organisation. Pour ce faire, la cmdlet Get-CsMcxConfiguration est d’abord appelée (sans paramètre) de façon à retourner une collection de tous les paramètres de configuration Mobility Service actuellement utilisés. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui prélève uniquement les paramètres dont la valeur de propriété SessionShortExpirationInterval est supérieure à (-gt) 3 600. Cette collection filtrée est ensuite redirigée vers Set-CsMcxConfiguration, qui définit la valeur de la propriété SessionShortExpirationInterval pour chaque élément de la collection sur 3 600.