New-CsPushNotificationConfiguration
Última modificación del tema: 2012-04-23
Crea una recopilación de parámetros de configuración de la notificación de inserción en el ámbito de sitio. 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
New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 ejecuten Lync 2010 en su Apple iPhone o Windows Phone reciban notificaciones sobre eventos Lync 2010 aunque Lync 2010 esté suspendido o en ejecución en segundo plano. Por ejemplo, los usuarios pueden recibir avisos de 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. Eso proporciona a los administradores la capacidad de ofrecen notificaciones de inserción a los usuarios en algunos sitios (por ejemplo, Redmond) a la vez que restringen el uso de dichas notificaciones en otros sitios.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsPushNotificationConfiguration de manera local: RTCUniversalServerAdmins.
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Requerido |
Identidad Xds |
La configuración de la notificación de inserción solo se puede crear en el ámbito de sitio. Para especificar una recopilación de configuraciones de un sitio, use una sintaxis similar a la siguiente: -Identity "site:Redmond" Tenga en cuenta que este comando dará error si la ubicación Redmond ya alberga una recopilación de opciones de notificación de inserción. |
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 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. |
Tenant |
Opcional |
Identificador único global |
Este parámetro está reservado para su uso en Microsoft Office 365. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia a un objeto sin realmente hacer que sea un cambio permanente. Si asigna el resultado de un comando llamado con este parámetro a una variable, podrá realizar cambios en las propiedades de la referencia al objeto y, a continuación, confirmar dichos cambios llamando al cmdlet Set- que coincida con dicho cmdlet. |
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
Ninguno. New-CsPushNotificationConfiguration no acepta entradas transferidas.
Tipos de datos devueltos
New-CsPushNotificationConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsPushNotificationConfiguration -Identity "site:Redmond" -EnableApplePushNotificationService $True -EnableMicrosoftPushNotificationService -$True
El comando que se muestra en el Ejemplo 1 crea una recopilación nueva de opciones de notificación de inserción y habilita las notificaciones de inserción de Apple Push Notification Service y del Servicio de notificación de inserción de Microsoft Lync Server 2010. Este último se realiza estableciendo las propiedades EnableApplePushNotificationService y EnableMicrosoftPushNotificationService en True.
-------------------------- Ejemplo 2 --------------------------
Get-CsSite | ForEach-Object {New-CsPushConfigurationNotification -Identity $_.Identity}
En el Ejemplo 2 se muestra cómo crear un conjunto de opciones de configuración de notificación de inserción para cada uno de los sitios Lync Server. Para hacerlo, el comando primero usa Get-CsSite para devolver una recopilación de todos sus sitios Lync Server. Dicha recopilación después se transmite al cmdlet ForEach-Object, que toma cada sitio de la recopilación, llama a New-CsPushNotificationConfiguration y crea un conjunto nuevo de opciones de configuración de notificación de inserción para ese sitio. Tenga en cuenta que este comando fallará para cualquier sitio que ya hospede una recopilación de opciones de configuración de notificación de inserción.
-------------------------- Ejemplo 3 --------------------------
$x = New-CsPushNotificationConfiguration -Identity "site:Redmond" -InMemory
$x.EnableApplePushNotificationService = $True
$x.EnableMicrosoftPushNotificationService = $True
Set-CsPushNotificationConfiguration -Instance $x
El ejemplo anterior demuestra el uso del parámetro InMemory para crear una recopilación de opciones de configuración de notificación de inserción que, en principio, solo existe en la memoria. Para hacerlo, el ejemplo crea una nueva recopilación de configuraciones (con la Identidad site:Redmond) y almacena esta recopilación en una variable denominada $x. Observe que, después de que este primer comando se ejecuta, la recopilación solo existe en la memoria; si ejecuta el comando Get-CsPushNotificationConfiguration, no verá una entrada para site:Redmond.
En los dos comandos siguientes, tanto la propiedad EnableApplePushNotificationService como EnableMicrosoftPushNotificationService de esta recopilación virtual de configuraciones están establecidas en True, lo cual habilita las notificaciones de inserción de Apple Push Notification Service y del Servicio de notificación de inserción de Microsoft Lync Server 2010. Finalmente, el último comando usa Set-CsPushNotificationConfiguration para transformar la configuración de notificación de inserción en una recopilación de configuraciones aplicadas al sitio de Redmond. Si no llama a Set-CsPushNotificationConfiguration, estas configuraciones permanecerán solo en la memoria y desaparecerán cuando finalice la sesión de Windows PowerShell o se elimine la variable $x.