Set-CsPushNotificationConfiguration

 

Ultima modifica dell'argomento: 2012-04-23

Modifica una raccolta esistente di impostazioni di configurazione di notifiche 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

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>]]

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 inoltre essere modificate utilizzando il cmdlet Set-CsPushNotificationConfiguration.

Per le impostazioni di configurazione di notifica Push, gli amministratori devono gestire due soli valori di proprietà: EnableApplePushNotificationService, che determina se le notifiche Push vengono inviate agli utenti con telefoni iPhone, e EnableMicrosoftPushNotificationService, che determina se le notifiche Push vengono inviate agli utenti con telefoni Windows Phone. Si noti che queste proprietà non devono necessariamente essere impostate sullo stesso valore. È ad esempio possibile abilitare le notifiche Push per gli utenti con telefoni Windows Phone, impostando EnableMicrosoftPushNotificationService su True, e, nello stesso tempo, disabilitare le notifiche per gli utenti con telefoni iPhone, impostando EnableApplePushNotificationService su False.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsPushNotificationConfiguration i membri dei gruppi seguenti: RTCUniversalServerAdmins.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Facoltativo	XdsIdentity	Indica l'identità delle impostazioni di configurazione di notifica Push da modificare. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global Per far riferimento alle impostazioni 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.
EnableApplePushNotificationService	Facoltativo	Booleano	Quando questo parametro è impostato su True, gli utenti con telefoni iPhone ricevono notifiche Push dal servizio notifica Push Apple. Quando è impostato su False, gli utenti con telefoni iPhone non ricevono tali notifiche. Il valore predefinito è False.
EnableMicrosoftPushNotificationService	Facoltativo	Booleano	Quando questo parametro è impostato su True, gli utenti con telefoni Windows Phone ricevono notifiche Push dal servizio notifica Push Microsoft Lync Server 2010. Quando è impostato su False, gli utenti con telefoni Windows Phone non ricevono tali notifiche. Il valore predefinito è False.
Instance	Facoltativo	Oggetto configurazione Push	Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.
Tenant	Facoltativo	GUID	Questo parametro è riservato per l'utilizzo con Microsoft Office 365.
Force	Facoltativo	Parametro opzionale	Consente di evitare la visualizzazione di qualunque messaggio di errore non irreversibile che potrebbe verificarsi durante l'esecuzione del comando.
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. Set-CsPushNotificationConfiguration accetta istanze dell'oggetto PushNotificationConfiguration inviate tramite pipeline.

Tipi restituiti

Nessuno. Set-CsPushNotificationConfiguration modifica invece le istanze esistenti dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Esempio

-------------------------- Esempio 1 --------------------------

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

Il comando illustrato nell'esempio 1 consente di disabilitare le notifiche Push del servizio notifica Push Apple per il sito Redmond.

-------------------------- Esempio 2 --------------------------

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

Il comando precedente consente di disabilitare le notifiche Push del servizio notifica Push Apple per tutti i siti che attualmente ospitano impostazioni di notifica Push. A tale scopo, nel comando vengono innanzitutto utilizzati Get-CsPushNotificationConfiguration e il parametro Filter per restituire tutte le impostazioni di notifica Push configurate nell'ambito del sito. Il valore di filtro "site:*" consente di limitare le impostazioni restituite a quelle con un parametro Identity che inizia con il valore stringa "site:". La raccolta di impostazioni viene quindi inviata tramite pipe al cmdlet Set-CsPushNotificationConfiguration, che prende ogni elemento della raccolta e imposta la proprietà EnableApplePushNotificationService su False.

-------------------------- Esempio 3 --------------------------

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

Nell'esempio 3 viene illustrato come individuare tutte le impostazioni di notifica Push in cui le notifiche Push del servizio notifica Push Microsoft Lync Server 2010 sono disabilitate, quindi disabilitare anche le notifiche Push del servizio notifica Push Apple per ognuna di tali impostazioni. A tale scopo, nel comando viene innanzitutto utilizzato 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 seleziona solo le impostazioni in cui la proprietà EnableMicrosoftPushNotificationService è uguale a (-eq) False. Tale raccolta filtrata viene quindi inviata tramite pipe a Set-CsPushNotificationConfiguration, che prende ogni elemento di tale raccolta e imposta la proprietà EnableApplePushNotificationService su False.