Remove-CsPushNotificationConfiguration
Ultima modifica dell'argomento: 2012-04-23
Elimina una raccolta esistente di impostazioni di notifica Push. Il servizio notifica Push (servizio notifica Push Apple e servizio notifica Push Microsoft Lync Server 2010) consente di inviare notifiche sugli eventi, come nuovi messaggi istantanei o nuovi messaggi in segreteria telefonica, a dispositivi mobili come iPhone e Windows Phone, anche se l'applicazione Microsoft Lync 2010 in tali dispositivi è attualmente sospesa o in esecuzione in background.
Sintassi
Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il servizio notifica Push Apple e il servizio notifica Push Microsoft Lync Server 2010 consentono agli utenti con telefoni Apple iPhone o Windows Phone in cui è in esecuzione Lync 2010 di ricevere notifiche relative agli eventi di Lync 2010 quando Lync 2010 è sospeso o in esecuzione in background. Gli utenti possono ad esempio ricevere notifiche per eventi come i seguenti:
- Inviti a una nuova sessione di messaggistica istantanea o conferenza
- Nuovi messaggi istantanei
- Nuovi messaggi in segreteria telefonica
Senza il servizio notifica Push, gli utenti riceverebbero queste notifiche solo quando Lync 2010 è in esecuzione come applicazione attiva e non è in background.
Gli amministratori possono abilitare e disabilitare le notifiche Push per gli utenti con telefoni iPhone e/o Windows Phone. Per impostazione predefinita, le notifiche Push sono disabilitate sia per gli utenti con telefoni iPhone che Windows Phone. Gli amministratori possono quindi abilitare o disabilitare le notifiche Push nell'ambito globale utilizzando il cmdlet Set-CsPushNotificationConfiguration. Possono inoltre creare impostazioni di notifica Push personalizzate nell'ambito del sito utilizzando il cmdlet New-CsPushNotificationConfiguration.
Tali impostazioni personalizzate possono successivamente essere eliminate utilizzando il cmdlet Remove-CsPushNotificationConfiguration. Se si eliminano le impostazioni configurate nell'ambito del sito, gli utenti di tale sito verranno automaticamente gestiti dalle impostazioni di notifica Push globali.
Si noti che è anche possibile eseguire Remove-CsPushNotificationConfiguration sulle impostazioni globali. In tal caso, tuttavia, le impostazioni globali non verranno rimosse, ma verranno ripristinati i relativi valori predefiniti. Ciò significa che le notifiche Push verranno disabilitate sia per il servizio notifica Push Apple che per il servizio notifica Push Microsoft Lync Server 2010.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsPushNotificationConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco della raccolta di impostazioni di configurazione di notifica Push. Per rimuovere la raccolta globale, utilizzare la sintassi seguente: -Identity global Si noti che non è possibile rimuovere realmente le impostazioni globali, ma solo ripristinare i valori predefiniti delle proprietà. Per rimuovere la raccolta di un sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond Non è possibile utilizzare caratteri jolly quando si specifica l'identità di un criterio. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non irreversibile che potrebbe verificarsi durante l'esecuzione del comando. |
Tenant |
Facoltativo |
GUID |
Questo parametro è riservato per l'utilizzo con Microsoft Office 365. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Consente di visualizzare una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration. Remove-CsPushNotificationConfiguration accetta istanze dell'oggetto PushNotificationConfiguration inviate tramite pipeline.
Tipi restituiti
Nessuno. Remove-CsPushNotificationConfiguration elimina invece le istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsPushNotificationConfiguration -Identity "site:Redmond"
Il comando illustrato nell'esempio 1 consente di eliminare la raccolta di impostazioni di notifica Push assegnate al sito Redmond.
-------------------------- Esempio 2 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration
Il comando precedente consente di eliminare tutte le impostazioni di notifica Push configurate nell'ambito del sito. A tale scopo, vengono innanzitutto utilizzati il cmdlet Get-CsPushNotificationConfiguration e il parametro Filter per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito. Il valore di filtro "site:*" limita gli elementi restituiti alle impostazioni con un parametro Identity che inizia con il valore stringa "site:". Le impostazioni nell'ambito del sito vengono quindi inviate tramite pipe al cmdlet Remove-CsPushNotificationConfiguration, che provvede alla loro eliminazione.
-------------------------- Esempio 3 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration
Nell'esempio 3 viene illustrato come rimuovere tutte le impostazioni di configurazione di notifica Push in cui sono state disabilitate le notifiche del servizio notifica Push Microsoft Lync Server 2010. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsPushNotificationConfiguration per restituire una raccolta di tutte le impostazioni di notifica Push attualmente in uso. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni in cui la proprietà EnableMicrosoftPushNotificationService è uguale a (-eq) False. La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsPushNotificationConfiguration che, a sua volta, elimina ogni elemento della raccolta.