Set-CsPushNotificationConfiguration
Última modificación del tema: 2012-04-23
Modifica una recopilación de parámetros de configuración de la notificación de inserción. El 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) proporciona una forma de enviar notificaciones sobre eventos (como pueden ser los mensajes instantáneos o el correo de voz nuevo) a los dispositivos móviles como iPhone y Windows Phone, aunque la aplicación Microsoft Lync 2010 de esos dispositivos se encuentre en ese momento suspendida o en ejecución en segundo plano.
Sintaxis
Set-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Set-CsPushNotificationConfiguration [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Apple Push Notification Service y el Servicio de notificación de inserción de Microsoft Lync Server 2010 permiten que los usuarios que tienen Lync 2010 en ejecución en el Apple iPhone o en el Windows Phone reciban notificaciones sobre eventos Lync 2010 incluso en aquellas ocasiones en que Lync 2010 esté suspendido o en ejecución en segundo plano. Por ejemplo, los usuarios pueden recibir avisos de eventos como estos:
- Invitaciones a una sesión de mensajería instantánea o a una conferencia
- Mensajes instantáneos nuevos
- Correo de voz nuevo
Sin el servicio de notificación de inserción, los usuarios recibirían estos avisos únicamente cuando Lync 2010 estuviera en primer plano y funcionando como la aplicación activa.
Los administradores tienen la capacidad de habilitar o deshabilitar las notificaciones de inserción para los usuarios de iPhone o de Windows Phone. (De forma predeterminada, están deshabilitadas para ambos usuarios.) Los administradores las pueden habilitar o deshabilitar en el ámbito global mediante el uso del cmdlet Set-CsPushNotificationConfiguration. También pueden crear parámetros de notificación de inserción personalizados en el ámbito del sitio mediante el cmdlet New-CsPushNotificationConfiguration. Dichos parámetros personalizados también se pueden modificar con el cmdlet Set-CsPushNotificationConfiguration.
Con los parámetros de configuración de la notificación de inserción solo hay dos valores de propiedad que los administradores deban gestionar: EnableApplePushNotificationService, que determina si las notificaciones de inserción se envían a los usuarios de iPhone; y EnableMicrosoftPushNotificationService, que determina si se envían a los usuarios de Windows Phone. Tenga en cuenta que no es necesario establecer estos valores de propiedad en el mismo valor. Por ejemplo, se podrían habilitar las notificaciones de inserción para los usuarios de Windows Phone (estableciendo EnableMicrosoftPushNotificationService en True) y, sin embargo, deshabilitarlas para los usuarios de iPhone estableciendo EnableApplePushNotificationService en False.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsPushNotificationConfiguration de manera local: RTCUniversalServerAdmins.
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Indica el parámetro Identity de los parámetros de configuración de la notificación de inserción que se van a modificar. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global Para hacer referencia a la configuración de un sitio, use una sintaxis similar a ésta: -Identity site:Redmond Tenga en cuenta que no se pueden utilizar comodines al especificar una Identidad. |
EnableApplePushNotificationService |
Opcional |
Booleano |
Cuando el valor establecido sea True, los usuarios de iPhone recibirán notificaciones de inserción de Apple Push Notification Service. Cuando sea False, los usuarios de iPhone no las recibirán. El valor predeterminado es False. |
EnableMicrosoftPushNotificationService |
Opcional |
Booleano |
Cuando el valor establecido sea True, los usuarios de Windows Phone recibirán las notificaciones de inserción del Servicio de notificación de inserción de Microsoft Lync Server 2010. Cuando sea False, los usuarios de Windows Phone no las recibirán. El valor predeterminado es False. |
Instance |
Opcional |
Objeto de configuración de inserción |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
Tenant |
Opcional |
Identificador único global |
Este parámetro está reservado para su uso en Microsoft Office 365. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse 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
Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration. Set-CsPushNotificationConfiguration acepta instancias transmitidas del objeto PushNotificationConfiguration.
Tipos de datos devueltos
Ninguno. En su lugar, Set-CsPushNotificationConfiguration modifica las instancias existentes del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsPushNotificationService -Identity "site:Redmond" -EnableApplePushNotificationService $False
El comando que se muestra en el Ejemplo 1 deshabilita las notificaciones de inserción de Apple Push Notification Service para el sitio Redmond.
-------------------------- Ejemplo 2 --------------------------
Get-CsPushNotificationService -Filter "site:*" | Set-CsPushNotificationService -EnableApplePushNotificationService $False
El comando anterior deshabilita las notificaciones de inserción de Apple Push Notification Service para todos los sitios que en estos momentos estén hospedando parámetros de notificación de inserción. Para ello, el comando usa Get-CsPushNotificationConfiguration y el parámetro Filter para devolver todos los parámetros de notificación de inserción configurados en el ámbito del sitio; el valor de filtro "site:*" limita los parámetros devueltos a los que tienen una identidad que comienza con el valor de cadena "site:". A continuación, dicha recopilación de parámetros se transmite al cmdlet Set-CsPushNotificationConfiguration, que recibe todos los elementos de la recopilación y establece la propiedad EnableApplePushNotificationService en False.
-------------------------- Ejemplo 3 --------------------------
Get-CsPushNotificationService | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Set-CsPushNotificationService -EnableApplePushNotificationService $False
Con el Ejemplo 3 se muestra cómo se pueden ubicar todos los comandos de notificación de inserción donde estén deshabilitadas las notificaciones de inserción del Servicio de notificación de inserción de Microsoft Lync Server 2010, y, a continuación, deshabilitar también las notificaciones de inserción de Apple Push Notification Service para cada uno de esos parámetros. Para llevar a cabo esta tarea, el comando usa en primer lugar Get-CsPushNotificationConfiguration para devolver una recopilación de los parámetros de notificación de inserción que están en uso en la actualidad en la organización. A continuación, esta recopilación se transmite al cmdlet Where-Object, que selecciona únicamente los parámetros en los que la propiedad EnableMicrosoftPushNotificationService sea igual a (-eq) False. Dicha recopilación filtrada se transmite después a Set-CsPushNotificationConfiguration, que toma cada elemento de la recopilación filtrada y establece la propiedad EnableApplePushNotificationService en False.