Remove-CsPushNotificationConfiguration
Última modificación del tema: 2012-04-23
Suprime una recopilación 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
Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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 ejecutan Lync 2010 en 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.
Esta configuración personalizada se puede suprimir más adelante usando el cmdlet Remove-CsPushNotificationConfiguration. Si suprime las opciones configuradas en el ámbito de sitio, los usuarios del sitio pasarán automáticamente a estar gestionados por la configuración de notificación de inserción global.
Tenga en cuenta que Remove-CsPushNotificationConfiguration se puede ejecutar también en la configuración global. Sin embargo, en ese caso no se quitará la configuración global, sino que las propiedades de la configuración global se restablecerán todas con los valores predeterminados. Esto querría decir que las notificaciones de inserción se deshabilitarán de Apple Push Notification Service y del Servicio de notificación de inserción Microsoft Lync Server 2010.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsPushNotificationConfiguration de manera local: RTCUniversalServerAdmins.
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de la recopilación de parámetros de configuración de notificación de inserción que se va a quitar. Para quitar la recopilación global, use esta sintaxis: -Identity global Tenga en cuenta que no es posible quitar la configuración global, sino solo restablecer los valores predeterminados de las propiedades. Para quitar una recopilación de sitios, use una sintaxis similar a esta: -Identity site:Redmond No puede usar caracteres comodín para especificar una identidad de directiva. |
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. |
Tenant |
Opcional |
Identificador único global |
Este parámetro está reservado para su uso en Microsoft Office 365. |
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. Remove-CsPushNotificationConfiguration acepta las instancias transmitidas del objeto PushNotificationConfiguration.
Tipos de datos devueltos
Ninguno. En cambio, Remove-CsPushNotificationConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsPushNotificationConfiguration -Identity "site:Redmond"
El comando que se muestra en el Ejemplo 1 elimina la recopilación de la configuración de notificación de inserción asignada en el sitio de Redmond.
-------------------------- Ejemplo 2 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration
El comando anterior suprime todas las opciones de notificación de inserción configuradas en el ámbito de sitio. Para realizar esta tarea, el cmdlet usa primero el cmdlet Get-CsPushNotificationConfiguration y el parámetro Filter para devolver una recopilación de todas las opciones configuradas en el ámbito de sitio; el valor de filtro "site:*" limita los elementos devueltos a las opciones que tengan una identidad que empiece por el valor de cadena de caracteres "site:". Después, las opciones de ámbito de sitio se transmiten al cmdlet Remove-CsPushNotificationConfiguration para que las suprima.
-------------------------- Ejemplo 3 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration
En el Ejemplo 3 se muestra cómo quitar todas las opciones de configuración de la notificación de inserción en las que las notificaciones de inserción del Servicio de notificación de inserción de Microsoft Lync Server 2010 se haya deshabilitado. Para ello, el comando primero usa Get-CsPushNotificationConfiguration para devolver una recopilación de todas las configuraciones de notificación de inserción que estén actualmente en uso. Esta recopilación se transfiere luego al cmdlet Where-Object, el cual selecciona únicamente aquellas configuraciones donde la propiedad EnableMicrosoftPushNotificationService sea igual a (-eq) False. A continuación, la colección filtrada se transfiere a Remove-CsPushNotificationConfiguration, que suprime cada uno de los elementos de la recopilación.