Remove-CsPushNotificationConfiguration
Dernière rubrique modifiée : 2012-04-23
Supprime une collection existante de paramètres de notification push. Le service de notification push (service de notification push d’Apple et service de notification push de Microsoft Lync Server 2010) permet d’envoyer les notifications relatives aux événements tels que les nouveaux messages instantanés ou les nouveaux messages vocaux vers les appareils mobiles tels que les iPhone et les Windows Phone, même si l’application Microsoft Lync 2010 de ces appareils est interrompue ou en cours d’exécution en arrière-plan.
Syntaxe
Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le service de notification push d’Apple et le service de notification push de Microsoft Lync Server 2010 permettent aux utilisateurs qui exécutent Lync 2010 sur leur iPhone Apple ou sur leur téléphone Windows Phone de recevoir des notifications concernant les événements Lync 2010 même lorsque Lync 2010 est interrompu ou fonctionne en arrière-plan. Par exemple, les utilisateurs peuvent être prévenus d’événements tels que les suivants :
- Invitations à une nouvelle session de messagerie instantanée ou à une nouvelle conférence
- Nouveaux messages instantanés
- Nouveau message vocal
Sans le service de notification push, les utilisateurs recevraient ces notifications uniquement lorsque Lync 2010 fonctionne au premier-plan et comme application active.
Les administrateurs peuvent activer ou désactiver les notifications push pour les utilisateurs d’iPhone et/ou de Windows Phone. (Par défaut, les notifications push sont désactivées pour les utilisateurs d’iPhone et de Windows Phone.) Ils peuvent activer ou désactiver les notifications push au niveau de l’étendue globale à l’aide de la cmdlet Set-CsPushNotificationConfiguration. Ils peuvent également définir des paramètres de notification push personnalisés au niveau de l’étendue Site à l’aide de la cmdlet New-CsPushNotificationConfiguration.
Ces paramètres personnalisés peuvent ensuite être supprimés à l’aide de la cmdlet Remove-CsPushNotificationConfiguration. Si vous supprimez des paramètres configurés au niveau de l’étendue Site, les utilisateurs de ce site sont automatiquement gérés par les paramètres de notification push globaux.
Notez que Remove-CsPushNotificationConfiguration peut également être exécutée par rapport aux paramètres globaux. Cependant, si vous choisissez d’effectuer cette action, les paramètres globaux ne sont pas supprimés. En revanche, les propriétés des paramètres globaux sont toutes réinitialisées à leurs valeurs par défaut. Dans ce cas, cela signifie que les notifications push sont désactivées du service de notification push d’Apple et du service de notification push de Microsoft Lync Server 2010.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet Remove-CsPushNotificationConfiguration : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de la collection des paramètres de configuration de notification push à supprimer. Pour supprimer la collection globale, utilisez cette syntaxe : -Identity global Notez que vous ne pouvez pas supprimer véritablement les paramètres globaux ; au lieu de cela, vous pouvez uniquement réinitialiser les propriétés à leurs valeurs par défaut. Pour supprimer une collection de sites, utilisez une syntaxe semblable à ceci : -Identity site:Redmond Vous ne pouvez pas utiliser de caractères génériques pour spécifier une identité de stratégie. |
Force |
Facultatif |
SwitchParameter |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
Tenant |
Facultatif |
GUID |
Ce paramètre est réservé pour être utilisé avec Microsoft Office 365. |
WhatIf |
Facultatif |
SwitchParameter |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
SwitchParameter |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration. Remove-CsPushNotificationConfiguration accepte les instances redirigées de l’objet PushNotificationConfiguration.
Types de retours
Aucun. En fait, Remove-CsPushNotificationConfiguration supprime les instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Remove-CsPushNotificationConfiguration -Identity "site:Redmond"
La commande illustrée à l’exemple 1 supprime les paramètres de notification push affectés au site Redmond.
-------------------------- Exemple 2 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration
La commande précédente supprime tous les paramètres de notification push configurés au niveau de l’étendue Site. Pour effectuer cette tâche, la cmdlet utilise d’abord la cmdlet Get-CsPushNotificationConfiguration et le paramètre Filter pour renvoyer une collection de tous les paramètres configurés au niveau de l’étendue Site ; la valeur de filtre « site:* » restreint les éléments renvoyés aux paramètres dont l’identité commence par la valeur de chaîne « site: ». Les paramètres au niveau de l’étendue Site sont ensuite redirigés vers la cmdlet Remove-CsPushNotificationConfiguration et supprimés par cette dernière.
-------------------------- Exemple 3 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration
L’exemple 3 montre comment vous pouvez supprimer tous les paramètres de configuration de notification push pour lesquels les notifications push du service de notification push de Microsoft Lync Server 2010 ont été désactivées. Pour ce faire, la commande utilise d’abord Get-CsPushNotificationConfiguration pour renvoyer une collection de tous les paramètres de notification push actuellement utilisés. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres pour lesquels la propriété EnableMicrosoftPushNotificationService a une valeur égale à (-eq) False. Cette collection filtrée est ensuite redirigée vers Remove-CsPushNotificationConfiguration qui, à son tour, supprime chaque élément de la collection.