Get-CsPushNotificationConfiguration
Ultima modifica dell'argomento: 2012-04-23
Recupera le informazioni sulle impostazioni di configurazione di notifica Push attualmente in uso nell'organizzazione. 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
Get-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPushNotificationConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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.
Il cmdlet Get-CsPushNotificationConfiguration consente di restituire le informazioni sulle impostazioni di configurazione di notifica Push attualmente in uso nell'organizzazione.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsPushNotificationConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Indica l'identificatore univoco della raccolta di impostazioni di notifica Push da restituire. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global Per far riferimento a una raccolta configurata nell'ambito del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond Si noti che non è possibile utilizzare caratteri jolly quando si specifica un parametro Identity. Se tuttavia è necessario utilizzare caratteri jolly, includere il parametro Filter. Se questo parametro non è specificato, Get-CsPushNotificationConfiguration restituisce una raccolta di tutte le impostazioni di configurazione di notifica Push in uso nell'organizzazione. |
Tenant |
Facoltativo |
GUID |
Questo parametro è riservato per l'utilizzo con Microsoft Office 365. |
Filter |
Facoltativo |
Stringa |
Consente di utilizzare i caratteri jolly per restituire una o più raccolte di impostazioni di configurazione di notifica Push. Per restituire una raccolta di tutte le impostazioni configurate nell'ambito del sito, utilizzare la sintassi seguente: -Filter site:* Per restituire una raccolta di tutte le impostazioni con valore stringa "Canada" nella relativa proprietà Identity (l'unica proprietà a cui è possibile applicare un filtro), utilizzare la sintassi seguente: -Filter "*Canada*" |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera i dati di configurazione delle notifiche Push dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso. |
Tipi di input
Get-CsPushNotificationConfiguration non accetta input inviato tramite pipeline.
Tipi restituiti
Get-CsPushNotificationConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsPushNotificationConfiguration
Il comando precedente restituisce informazioni su tutte le impostazioni di notifica Push configurate per l'utilizzo nell'organizzazione.
-------------------------- Esempio 2 --------------------------
Get-CsPushNotificationConfiguration -Identity "site:Redmond"
Il comando illustrato nell'esempio 2 restituisce informazioni su una singola raccolta di impostazioni di notifica Push, ovvero le impostazioni configurate per il sito Redmond.
-------------------------- Esempio 3 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*"
Nell'esempio 3 il comando restituisce tutte le impostazioni di notifica Push assegnate all'ambito del sito. A tale scopo, nel comando vengono utilizzati il parametro Filter e il valore di filtro "site:*". Tale filtro consente di restituire solo le impostazioni con un valore Identity che inizia con il valore stringa "site:".
-------------------------- Esempio 4 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False}
Il comando precedente restituisce tutte le impostazioni di notifica Push in cui le notifiche Push per telefoni iPhone sono state disabilitate. A tale scopo, nel comando viene innanzitutto utilizzato il cmdlet Get-CsPushNotificationConfiguration per restituire una raccolta di tutte le impostazioni di notifica Push attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva solo le impostazioni in cui la proprietà EnableApplePushNotificationService è uguale a (-eq) False.
-------------------------- Esempio 5 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False -or $_.EnableMicrosoftPushNotificationService -eq $False}
Nell'esempio 5 vengono restituite le informazioni per tutte le impostazioni di notifica Push in cui il servizio notifica Push Apple e/o il servizio notifica Push Microsoft Lync Server 2010 sono stati disabilitati. A tale scopo, nel comando viene utilizzato innanzitutto il cmdlet Get-CsPushNotificationConfiguration per restituire una raccolta di tutte le impostazioni di notifica Push attualmente in uso. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che preleva solo le impostazioni che soddisfano uno dei criteri seguenti o entrambi i criteri: 1) la proprietà EnableApplePushNotificationService è uguale a (-eq) False, 2) la proprietà EnableMicrosoftPushNotificationService è uguale a False. L'operatore –or indica a Where-Object di cercare le impostazioni che soddisfano uno dei due criteri. Per limitare i dati restituiti alle impostazioni in cui entrambi i servizi sono stati disabilitati, utilizzare l'operatore –and:
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService –eq $False –and $_.EnableMicrosoftPushNotificationService –eq $False}