New-CsPushNotificationConfiguration
Dernière rubrique modifiée : 2012-04-23
Crée une collection de paramètres de configuration de notification push au niveau de l’étendue Site. 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
New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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. Cela permet aux administrateurs de fournir des notifications push aux utilisateurs sur certains sites (par exemple Redmond) tout en restreignant l’utilisation de ces notifications dans d’autres sites.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes suivants sont autorisés à exécuter localement la cmdlet New-CsPushNotificationConfiguration : RTCUniversalServerAdmins.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Les paramètres de notification push peuvent uniquement être créés au niveau de l’étendue Site. Pour spécifier une nouvelle collection de paramètres pour un site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond" Notez que cette commande échouera si le site Redmond héberge déjà une collection de paramètres de notification push. |
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. |
Tenant |
Facultatif |
GUID |
Ce paramètre est réservé pour être utilisé avec Microsoft Office 365. |
InMemory |
Facultatif |
SwitchParameter |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie d’une commande appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsPushNotificationConfiguration n’accepte pas la saisie de données redirigées.
Types de retours
New-CsPushNotificationConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsPushNotificationConfiguration -Identity "site:Redmond" -EnableApplePushNotificationService $True -EnableMicrosoftPushNotificationService -$True
La commande présentée dans l’exemple 1 crée une collection de paramètres de notification push pour le site Redmond et active les notifications push du service de notification push d’Apple et du service de notification push de Microsoft Lync Server 2010. Pour ce faire, la valeur True doit être affectée aux propriétés EnableApplePushNotificationService et EnableMicrosoftPushNotificationService.
-------------------------- Exemple 2 --------------------------
Get-CsSite | ForEach-Object {New-CsPushConfigurationNotification -Identity $_.Identity}
L’exemple 2 montre comment vous pouvez créer un ensemble de paramètres de configuration push pour chacun de vos sites Lync Server. Pour ce faire, la commande utilise d’abord Get-CsSite pour renvoyer une collection de tous vos sites Lync Server. Cette collection est ensuite redirigée vers la cmdlet ForEach-Object, qui prend chaque site de la collection, appelle New-CsPushNotificationConfiguration, puis crée un ensemble de paramètres de configuration de notification push pour le site. Notez que cette commande échouera pour les sites qui hébergent déjà une collection de paramètres de configuration de notification push.
-------------------------- Exemple 3 --------------------------
$x = New-CsPushNotificationConfiguration -Identity "site:Redmond" -InMemory
$x.EnableApplePushNotificationService = $True
$x.EnableMicrosoftPushNotificationService = $True
Set-CsPushNotificationConfiguration -Instance $x
L’exemple précédent montre comment utiliser le paramètre InMemory pour créer une collection de paramètres de configuration de notification push qui n’existait initialement qu’en mémoire. Pour ce faire, l’exemple crée une collection de paramètres (avec l’identité site:Redmond) et enregistre cette collection dans une variable appelée $x. Notez qu’une fois cette première commande exécutée, la collection n’existera qu’en mémoire. Si vous exécutez la commande Get-CsPushNotificationConfiguration, vous ne pourrez voir aucune entrée pour site:Redmond.
Dans les deux prochaines commandes, les propriétés EnableApplePushNotificationService et EnableMicrosoftPushNotificationService de cette collection virtuelle de paramètres ont la valeur True, ce qui entraîne l’activation des notifications push du service de notification push d’Apple et du service de notification push de Microsoft Lync Server 2010. Enfin, la dernière commande utilise Set-CsPushNotificationConfiguration pour transformer les paramètres de notification push virtuels en collection effective de paramètres appliqués au site Redmond. Si vous n’appelez pas Set-CsPushNotificationConfiguration, ces paramètres resteront en mémoire uniquement et disparaîtront une fois que la session Windows PowerShell sera terminée ou que la variable $x sera supprimée.