Set-CsMcxConfiguration

 

Última modificación del tema: 2012-04-23

Modifica una recopilación existente de opciones de configuración del servicio de movilidad de Microsoft Lync Server 2010. El servicio de movilidad permite a los usuarios de teléfonos móviles como iPhone y Windows Phone realizar acciones como intercambiar mensajes instantáneos e información de presencia; almacenar y recuperar el correo de voz de forma interna en vez de con el operador de conexiones inalámbricas; y beneficiarse de las funciones de Microsoft Lync Server 2010 como Vía trabajo y conferencias salientes.

Sintaxis

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>]]

Descripción detallada

El servicio de movilidad de Microsoft Lync Server 2010 amplía muchas de las funciones de Microsoft Lync 2010 a los dispositivos móviles; por ejemplo, a los teléfonos Apple iPhone, Windows Phone, Android y Nokia. Entre otras cosas, los usuarios pueden utilizar estos teléfonos para intercambiar mensajes instantáneos e información de presencia, y para recibir notificaciones de correos de voz nuevos. Gracias al servicio de notificación de inserción (Apple Push Notification Service y el Servicio de notificación de inserción de Microsoft Lync Server 2010), los usuarios que tengan iPhone o Windows Phone podrán recibir estas notificaciones aunque Lync 2010 esté en ejecución en segundo plano. El servicio de movilidad también ofrece la oportunidad de que las organizaciones habiliten Vía trabajo. Con Vía trabajo, los usuarios pueden realizar una llamada desde el teléfono móvil y hacer que parezca que la llamada proviene del teléfono de trabajo; por ejemplo, los sistemas con identificador del autor de la llamada mostrarán el número de trabajo del usuario en vez del número de su teléfono móvil.

El propio servicio de movilidad se gestiona usando los parámetros de configuración del servicio de movilidad que se pueden aplicar al ámbito global, del sitio o del servicio (solo para el servicio de servidor web). Estos parámetros tienen el control de cosas como la duración máxima de la sesión del servicio de movilidad; si el servicio Detección automática de Microsoft Lync Server 2010 (que dirige a los usuarios del servicio de movilidad al grupo de registrador adecuado) está disponible para los usuarios que inicien sesión fuera del firewall de la organización); y la ubicación del proveedor del servicio de notificación de inserción.

El cmdlet Set-CsMcxConfiguration proporciona una forma de que los administradores modifiquen cualquiera de los parámetros de configuración del servicio de movilidad.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsMcxConfiguration de manera local: RTCUniversalServerAdmins.

Parámetros

Parámetro	Requerido	Tipo	Descripción
Identity	Opcional	Identidad Xds	Representa el identificador único de la recopilación de parámetros de configuración del servicio de movilidad que se va a modificar. Para modificar la configuración global, use la siguiente sintaxis: -Identity global Para modificar la configuración en el ámbito de sitio, use el prefijo "site:" seguido del nombre del sitio. -Identity "site:Redmond" Para modificar configuraciones definidas en el ámbito de servicio, use una sintaxis como ésta: -Identity service:WebServer:atl-cs-001.litwareinc.com Si no se especifica este parámetro, Set-CsMcxConfiguration modificará la configuración global.
ExposedWebURL	Opcional	Objeto ExposedWebURL	Indica si la URL que el servicio Detección automática utiliza está accesible para los usuarios que estén dentro y fuera del firewall de la organización (External) o si solo está accesible para los usuarios que se encuentren dentro del firewall (Internal). Los valores permitidos son: Internal o External. El valor predeterminado es External.
Instance	Opcional	Objeto de configuración MCX	Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.
PushNotificationProxyUri	Opcional	Cadena de caracteres	URI de un proveedor de servicio que pueda reenviar solicitudes de notificación de inserción a Apple Push Notification Service y al Servicio de notificación de inserción de Microsoft Lync Server 2010. PushNotificationProxyUri debe tener forma de dirección SIP; por ejemplo: -PushNotificationProxyUri "sip:push@push.lync.com"
SessionExpirationInterval	Opcional	Entero	Duración en segundos de una sesión móvil para usuarios de iPhone y Windows Phone. Si Lync 2010 está en ejecución en segundo plano en estos teléfonos, los usuarios recibirán las notificaciones de inserción siempre y cuando el intervalo de expiración de la sesión no haya vencido. Antes de que se agote el tiempo de espera de la sesión, el dispositivo móvil debe enviar un aviso al servidor donde se indique que el dispositivo sigue activo. Si no lo envía, el dispositivo se enumerará como inactivo y el usuario tendrá que volver a iniciar sesión en el sistema. Esta propiedad se puede configurar con cualquier valor entero comprendido entre 120 y 4294967295 inclusive. El valor predeterminado es 259200 segundos (3 días). Tenga en cuenta que el valor de la propiedad SessionExpirationInterval debe ser superior al valor de la propiedad SessionShortExpirationInterval.
SessionShortExpirationInterval	Opcional	Entero	Duración en segundos de una sesión móvil para los usuarios de teléfonos Android o Nokia. Antes de que se agote el tiempo de espera de la sesión, el dispositivo móvil debe enviar un aviso al servidor donde se indique que el dispositivo sigue activo. Si no lo envía, el dispositivo se enumerará como inactivo y el usuario tendrá que volver a iniciar sesión en el sistema. Esta propiedad se puede configurar con cualquier valor entero comprendido entre 120 y 4294967295 inclusive. El valor predeterminado es 259200 segundos (3 días). Tenga en cuenta que el valor de la propiedad SessionExpirationInterval debe ser superior al valor de la propiedad SessionShortExpirationInterval.
Force	Opcional	Parámetro modificador	Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir al ejecutar el comando.
WhatIf	Opcional	Parámetro modificador	Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.
Confirm	Opcional	Parámetro modificador	Solicita confirmación antes de ejecutar el comando.

Tipos de datos entrados

Objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Set-CsMcxConfiguration acepta instancias transferidas del objeto McxConfiguration.

Tipos de datos devueltos

Ninguno. En lugar de eso, Set-CsMcxConfiguration modifica las instancias existentes del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Set-CsMcxConfiguration -Identity site:Redmond -ExposedWebURL External

En el Ejemplo 1, la propiedad ExposedWebURL de los parámetros de configuración del servicio de movilidad que están asignados al sitio de Redmond está establecida en External.

-------------------------- Ejemplo 2 --------------------------

Get-CsMcxConfiguration | Set-CsMcxConfiguration -ExposedWebURL External

En el Ejemplo 2 se muestra cómo un solo comando puede asignar el mismo valor de propiedad a todos los parámetros de configuración del servicio de movilidad que estén actualmente en uso en una organización. Para ello, el comando primero usa el cmdlet Get-CsMcxConfiguration sin ningún parámetro a fin de devolver una recopilación de todos los parámetros de configuración del servicio de movilidad existentes. Esa recopilación se transfiere después al cmdlet Set-CsMcxConfiguration, que establece la propiedad ExposedWebURL en External para cada elemento de la recopilación.

-------------------------- Ejemplo 3 --------------------------

Get-CsMcxConfiguration | Where-Object {$_.SessionShortExpirationInterval -gt 3600} | Set-CsMcxConfiguration -SessionShortExpirationInterval 3600

En el ejemplo anterior, todos los parámetros de configuración del servicio de movilidad que tengan una propiedad SessionShortExpirationInterval de más de 3600 se modifican para establecer ese valor de propiedad en 3600; eso convierte de hecho el valor 3600 segundos en el valor máximo para los parámetros de configuración del servicio de movilidad que haya en la organización. Para ello, se llama primero al cmdlet Get-CsMcxConfiguration (sin ningún parámetro) para devolver una recopilación de todos los parámetros de configuración del servicio de movilidad que estén actualmente en uso. A continuación, esa recopilación se transfiere al cmdlet Where-Object, que selecciona los parámetros en los que la propiedad SessionShortExpirationInterval es mayor que (-gt) 3600. Esta recopilación filtrada se transfiere después a Set-CsMcxConfiguration, que establece en 3600 el valor de la propiedad SessionShortExpirationInterval para cada elemento de la recopilación.