Get-CsPushNotificationConfiguration
Última modificación del tema: 2012-04-23
Recupera información sobre los parámetros de configuración de la notificación de inserción que actualmente estén en uso en la organizació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
Get-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPushNotificationConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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 ejecuten Lync 2010 en Apple iPhone o Windows Phone reciban notificaciones sobre eventos de Lync 2010 aunque Lync 2010 esté suspendido o en ejecución en segundo plano. Por ejemplo, los usuarios pueden recuperar un aviso para algunos eventos como los siguientes:
- 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.
El cmdlet Get-CsPushNotificationConfiguration proporciona una vía para devolver información acerca de los parámetros de configuración de la notificación de inserción que están en uso en su organización.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsPushNotificationConfiguration de manera local: RTCUniversalServerAdmins.
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Indica el identificador único de la recopilación de configuración de la notificación de inserción que desea devolver. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global Para hacer referencia a una recopilación configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond Tenga en cuenta que no es posible usar comodines al especificar un parámetro Identity. Si necesita usar caracteres comodín, incluya el parámetro Filter. Si no se especifica este parámetro, Get-CsPushNotificationConfiguration devolverá una recopilación de todos los parámetros de configuración de la notificación de inserción que se usan en la organización. |
Tenant |
Opcional |
Identificador único global |
Este parámetro está reservado para su uso en Microsoft Office 365. |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para devolver una o varias recopilaciones de los parámetros de configuración de la notificación de inserción. Para devolver una recopilación de todos los parámetros de configuración del sitio, use esta sintaxis: -Filter site:* Para devolver una recopilación de todas las configuraciones que tengan el valor de cadena de caracteres "Canada" en cualquier ubicación del valor Identity (la única propiedad que se puede filtrar), use esta sintaxis: -Filter "*Canada*" |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de configuración de la notificación de inserción de la réplica local del Almacén de administración central, en lugar del Almacén de administración central en sí. |
Tipos de datos entrados
Get-CsPushNotificationConfiguration no acepta entradas transferidas.
Tipos de datos devueltos
Get-CsPushNotificationConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsPushNotificationConfiguration
El comando anterior devuelve información acerca de todos los parámetros de notificación de inserción configurados en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsPushNotificationConfiguration -Identity "site:Redmond"
El comando que se muestra en el Ejemplo 2 devuelve información sobre una sola recopilación de parámetros de notificación de inserción: los configurados para el sitio de Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*"
En el Ejemplo 3, el comando devuelve todos los parámetros de notificación de inserción asignados al ámbito de sitio. Para hacerlo, el comando usa el parámetro Filter y el valor de filtro "site:*"; ese valor de filtro solo devuelve las configuraciones cuya identidad comience por el valor de cadena de caracteres "site:"
-------------------------- Ejemplo 4 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False}
El comando anterior devuelve todas las configuraciones de notificación de inserción en las que las notificaciones de inserción de los iPhone se hayan deshabilitado. Para ello, el comando usa primero el cmdlet Get-CsPushNotificationConfiguration para devolver una recopilación de todos los parámetros de configuración de la notificación de inserción que actualmente se usen en la organización. A continuación, esta recopilación se transfiere al cmdlet Where-Object, que selecciona solo los parámetros en los que la propiedad EnableApplePushNotificationService es igual a (-eq) False.
-------------------------- Ejemplo 5 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False -or $_.EnableMicrosoftPushNotificationService -eq $False}
En el Ejemplo 5, se devuelve información para todos los parámetros de la notificación de inserción en los que Apple Push Notification Service o el Servicio de notificación de inserción Lync Server 2010 se haya deshabilitado. Para llevar a cabo esta tarea, en primer lugar el comando usa el cmdlet Get-CsPushNotificationConfiguration para devolver una recopilación de todas las configuraciones de notificación de inserción en uso actualmente. A continuación, esta recopilación se transfiere al cmdlet Where-Object, que selecciona los parámetros que cumplen uno de los criterios siguientes (o ambos): 1) la propiedad EnableApplePushNotificationService es igual a (-eq) False; 2) la propiedad EnableMicrosoftPushNotificationService es igual a False. El operador –or le indica a Where-Object que busque los parámetros que cumplan cualquiera de los dos criterios. Para restringir los datos que se devuelven a los parámetros en los que se hayan deshabilitado ambos servicios, use el operador –and:
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService –eq $False –and $_.EnableMicrosoftPushNotificationService –eq $False}