Set-CsPushNotificationConfiguration

 

Dernière rubrique modifiée : 2012-04-23

Modifie une collection existante de paramètres de configuration 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

Set-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsPushNotificationConfiguration [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 également être modifiés à l’aide de la cmdlet Set-CsPushNotificationConfiguration.

Avec les paramètres de configuration de notification push, les administrateurs n’ont que deux valeurs de propriétés à gérer : EnableApplePushNotificationService, qui détermine si les notifications push sont envoyées aux utilisateurs d’iPhone et EnableMicrosoftPushNotificationService, qui détermine si les notifications push sont envoyées aux utilisateurs de Windows Phone. Notez que ces valeurs de propriétés n’ont pas besoin d’être identiques. Par exemple, vous pouvez activer les notifications push pour les utilisateurs de Windows Phone (en affectant la valeur True à EnableMicrosoftPushNotificationService) et, en même temps, désactiver les notifications pour les utilisateurs d’iPhone en affectant la valeur False à EnableApplePushNotificationService.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet Set-CsPushNotificationConfiguration : RTCUniversalServerAdmins.

Paramètres

Paramètre	Obligatoire	Type	Description
Identity	Facultatif	XdsIdentity	Indique l’identité des paramètres de configuration de notification push à modifier. Pour faire référence aux paramètres globaux, utilisez cette syntaxe : -Identity global Pour faire référence aux paramètres de site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond Notez que vous ne pouvez pas utiliser de caractères génériques lorsque vous spécifiez une identité.
EnableApplePushNotificationService	Facultatif	Booléen	Lorsque la valeur est True, les utilisateurs d’iPhone reçoivent des notifications push du service de notification push d’Apple. Lorsque la valeur est False, ils ne les reçoivent pas. La valeur par défaut est False.
EnableMicrosoftPushNotificationService	Facultatif	Booléen	Lorsque la valeur est True, les utilisateurs de Windows Phone reçoivent des notifications push du service de notification push de Microsoft Lync Server 2010. Lorsque la valeur est False, ils ne les reçoivent pas. La valeur par défaut est False.
Instance	Facultatif	Objet de configuration Push	Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.
Tenant	Facultatif	GUID	Ce paramètre est réservé pour être utilisé avec Microsoft Office 365.
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.
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. Set-CsPushNotificationConfiguration accepte les instances redirigées de l’objet PushNotificationConfiguration.

Types de retours

Aucun. En fait, Set-CsPushNotificationConfiguration modifie les instances existantes de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Exemple

-------------------------- Exemple 1 --------------------------

Set-CsPushNotificationService -Identity "site:Redmond" -EnableApplePushNotificationService $False

La commande présentée dans l’exemple 1 désactive les notifications push du service de notification push d’Apple pour le site Redmond.

-------------------------- Exemple 2 --------------------------

Get-CsPushNotificationService -Filter "site:*" | Set-CsPushNotificationService -EnableApplePushNotificationService $False

La commande précédente désactive les notifications push du service de notification push d’Apple pour l’ensemble des sites qui hébergent actuellement des paramètres de notification push. Pour ce faire, la commande utilise d’abord Get-CsPushNotificationConfiguration et le paramètre Filter pour renvoyer tous les paramètres de notification push configurés au niveau de l’étendue Site ; la valeur de filtre « site:* » restreint les paramètres renvoyés à ceux dont l’identité commence par la valeur de chaîne « site: ». Cette collection de paramètres est ensuite redirigée vers la cmdlet Set-CsPushNotificationConfiguration, qui prend chaque élément de la collection et affecte la valeur False à la propriété EnableApplePushNotificationService.

-------------------------- Exemple 3 --------------------------

Get-CsPushNotificationService | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Set-CsPushNotificationService -EnableApplePushNotificationService $False

L’exemple 3 montre comment vous pouvez localiser tous les paramètres de notification push pour lesquels les notifications push du service de notification push de Microsoft Lync Server 2010 sont désactivées, puis comment désactiver les notifications push du service de notification push d’Apple pour chacun de ces paramètres également. Pour effectuer cette tâche, la commande utilise d’abord Get-CsPushNotificationConfiguration pour renvoyer 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 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 Set-CsPushNotificationConfiguration, qui prend chaque élément de la collection filtrée et affecte la valeur False à la propriété EnableApplePushNotificationService.