Get-CsPushNotificationConfiguration
Dernière rubrique modifiée : 2012-04-23
Récupère des informations sur les paramètres de configuration de notification push actuellement utilisés dans votre organisation. Le service de notification push (service de notification push d’Apple et service de notification push Microsoft Lync Server 2010) permet d’envoyer des notifications sur des événements tels que de nouveaux messages instantanés ou de nouveaux messages vocaux sur des périphériques mobiles tels que les iPhones et les Windows Phones, même si l’application Microsoft Lync 2010 sur ces périphériques est interrompue ou fonctionne en arrière-plan.
Syntaxe
Get-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPushNotificationConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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 téléphone Windows Phone (par défaut, les notifications push sont désactivées pour les utilisateurs d’iPhone et de téléphone 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.
La cmdlet Get-CsPushNotificationConfiguration permet de retourner des informations concernant les paramètres de configuration de notification push actuellement utilisés dans votre organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet Get-CsPushNotificationConfiguration : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Indique l’identificateur unique de la collection de paramètres de notification push à retourner. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe semblable à celle-ci : -Identity site:Redmond Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez une identité. Si vous souhaitez utiliser des caractères génériques, vous devez ajouter le paramètre Filter. Si ce paramètre n’est pas spécifié, Get-CsPushNotificationConfiguration retourne une collection de tous les paramètres de configuration de notification push utilisés dans l’organisation. |
Tenant |
Facultatif |
GUID |
Ce paramètre est réservé pour être utilisé avec Microsoft Office 365. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques afin de retourner une ou plusieurs collections de paramètres de configuration de notification push. Pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Site, utilisez la syntaxe suivante : -Filter site:* Pour retourner une collection de tous les paramètres qui ont la valeur de chaîne « Canada » dans leur identité (la seule propriété que vous pouvez filtrer), utilisez cette syntaxe : -Filter "*Canada*" |
LocalStore |
Facultatif |
SwitchParameter |
Extrait les données de configuration de notification push du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit. |
Types d’entrées
Get-CsPushNotificationConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsPushNotificationConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsPushNotificationConfiguration
L’exemple ci-dessus retourne des informations sur tous les paramètres de notification push configurés en vue d’une utilisation au sein de votre organisation.
-------------------------- Exemple 2 --------------------------
Get-CsPushNotificationConfiguration -Identity "site:Redmond"
La commande illustrée dans l’exemple 2 retourne des informations sur une collection unique de paramètres de notification push : les paramètres configurés pour le site Redmond.
-------------------------- Exemple 3 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*"
Dans l’exemple 3, la commande retourne tous les paramètres de notification push affectés à l’étendue Site. Pour ce faire, la commande utilise le paramètre Filter et la valeur de filtre "site:*" ; cette valeur de filtre retourne uniquement les paramètres dont l’identité commence par la valeur de chaîne "site:".
-------------------------- Exemple 4 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False}
La commande précédente retourne tous les paramètres de notification push dont les notifications push des iPhones ont été désactivées. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsPushNotificationConfiguration pour retourner une collection de tous les paramètres de notification push actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui choisit uniquement les paramètres dont la propriété EnableApplePushNotificationService est égale à (-eq) False.
-------------------------- Exemple 5 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False -or $_.EnableMicrosoftPushNotificationService -eq $False}
Dans l’exemple 5, les informations sont retournées pour tous les paramètres de notification push où le service de notification push d’Apple et/ou le service de notification push Lync Server 2010 ont été désactivés. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsPushNotificationConfiguration pour retourner 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 choisit uniquement les paramètres qui répondent à l’un des critères suivants, ou au deux : 1) la propriété EnableApplePushNotificationService est égale à (-eq) False ; 2) la propriété EnableMicrosoftPushNotificationService est égale à False. L’opérateur –or indique à Where-Object de rechercher les paramètres qui répondent à l’un de ces critères. Pour limiter les données retournées aux paramètres pour lesquels les services ont été désactivés, utilisez l’opérateur –and :
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService –eq $False –and $_.EnableMicrosoftPushNotificationService –eq $False}