New-CsPushNotificationConfiguration

 

Ultima modifica dell'argomento: 2012-04-23

Crea una raccolta esistente di impostazioni di configurazione di notifica Push nell'ambito del sito. 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

New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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. In questo modo, gli amministratori possono fornire notifiche Push agli utenti in alcuni siti (ad esempio Redmond) limitando nel contempo l'utilizzo di tali notifiche in altri siti.

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

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Obbligatorio	XdsIdentity	Le impostazioni di notifica Push possono essere create solo nell'ambito del sito. Per specificare una nuova raccolta di impostazioni per un sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond" Si noti che questo comando avrà esito negativo se il sito Redmond ospita già una raccolta di impostazioni di notifica Push.
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.
Tenant	Facoltativo	GUID	Questo parametro è riservato per l'utilizzo con Microsoft Office 365.
InMemory	Facoltativo	Parametro opzionale	Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output di un comando chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.
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

Nessuno. New-CsPushNotificationConfiguration non accetta input inviato tramite pipeline.

Tipi restituiti

New-CsPushNotificationConfiguration crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Esempio

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

New-CsPushNotificationConfiguration -Identity "site:Redmond" -EnableApplePushNotificationService $True -EnableMicrosoftPushNotificationService -$True

Il comando illustrato nell'esempio 1 consente di creare una nuova raccolta di impostazioni di notifica Push per il sito Redmond e di abilitare le notifiche Push sia per il servizio notifica Push Apple che per il servizio notifica Push Microsoft Lync Server 2010. Quest'ultima operazione viene eseguita impostando entrambe le proprietà EnableApplePushNotificationService e EnableMicrosoftPushNotificationService su True.

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

Get-CsSite | ForEach-Object {New-CsPushConfigurationNotification -Identity $_.Identity}

Nell'esempio 2 viene illustrato come creare un insieme di impostazioni di configurazione di notifica Push per ognuno dei siti di Lync Server. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsSite per restituire una raccolta di tutti i siti di Lync Server. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che prende ogni sito della raccolta, chiama New-CsPushNotificationConfiguration e crea un nuovo insieme di impostazioni di configurazione di notifica Push per il sito. Si noti che questa comando avrà esito negativo per qualsiasi sito che ospita già una raccolta di impostazioni di notifica Push.

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

$x = New-CsPushNotificationConfiguration -Identity "site:Redmond" -InMemory
$x.EnableApplePushNotificationService = $True 
$x.EnableMicrosoftPushNotificationService = $True
Set-CsPushNotificationConfiguration -Instance $x

Nell'esempio precedente viene illustrato l'utilizzo del parametro InMemory per creare una raccolta di impostazioni di configurazione di notifica Push inizialmente presenti solo in memoria. A tale scopo, nell'esempio viene creata una nuova raccolta di impostazioni (con Identity site:Redmond) e questa raccolta viene archiviata in una variabile denominata $x. Si noti che, dopo l'esecuzione del primo comando, la raccolta è presente solo in memoria. Se si esegue il comando Get-CsPushNotificationConfiguration, non sarà possibile vedere alcuna voce per site:Redmond.

Nei due comandi successivi entrambe le proprietà EnableApplePushNotificationService e EnableMicrosoftPushNotificationService per la raccolta virtuale di impostazioni vengono impostate su True, per abilitare le notifiche Push sia per il servizio notifica Push Apple che per il servizio notifica Push Microsoft Lync Server 2010. Nell'ultimo comando viene infine utilizzato Set-CsPushNotificationConfiguration per trasformare le impostazioni di notifica Push virtuali in una raccolta effettiva di impostazioni applicate al sito Redmond. Se non si chiama Set-CsPushNotificationConfiguration, le impostazioni rimangono solo in memoria e vengono eliminate al termine della sessione di Windows PowerShell o quando viene eliminata la variabile $x.