New-CsPushNotificationConfiguration

Syntax

New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Der Apple-Pushbenachrichtigungsdienst und der Microsoft Lync Server 2010-Pushbenachrichtigungsdienst ermöglichen Benutzern von Lync 2010 auf ihrem Apple iPhone oder Windows Phone den Empfang von Benachrichtigungen zu Lync 2010-Ereignissen, selbst wenn Lync 2010 angehalten ist oder im Hintergrund ausgeführt wird. Dies ist beispielsweise bei Ereignissen wie den folgenden möglich:

- Einladungen zu einer neuen Sofortnachrichtensitzung oder Konferenz

- Neue Sofortnachrichten

- Neue Voicemail

Ohne den Pushbenachrichtigungsdienst würden Benutzer diese Benachrichtigungen nur empfangen, wenn Lync 2010 im Vordergrund als aktive Anwendung ausgeführt würde.

Administratoren haben die Möglichkeit, Pushbenachrichtigungen für iPhone- und/oder Windows Phone-Benutzer zu aktivieren oder zu deaktivieren. (Pushbenachrichtigungen sind standardmäßig für sowohl iPhone- als auch Windows Phone-Benutzer deaktiviert.) Administratoren können Pushbenachrichtigungen auf globaler Ebene mit dem Cmdlet Set-CsPushNotificationConfiguration aktivieren oder deaktivieren. Mit dem Cmdlet New-CsPushNotificationConfiguration können auch benutzerdefinierte Pushbenachrichtigungseinstellungen auf Standortebene erstellt werden. Dies bietet Administratoren die Möglichkeit, Pushbenachrichtigungen für Benutzer an bestimmten Standorten (z. B. Redmond) zu aktivieren und diese Benachrichtigungen an anderen Standorten zu deaktivieren.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsPushNotificationConfiguration lokal auszuführen: RTCUniversalServerAdmins.

Parameter

Eingabetypen

Keine. New-CsPushNotificationConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsPushNotificationConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration" erstellt.

Beispiel

-------------------------- Beispiel 1 --------------------------

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

Mit dem Befehl in Beispiel 1 werden eine neue Auflistung von Pushbenachrichtigungseinstellungen für den Standort "Redmond" und Pushbenachrichtigungen über den Apple-Pushbenachrichtigungsdienst und Microsoft Lync Server 2010-Pushbenachrichtigungsdienst aktiviert. Letzteres erfolgt durch Festlegen der Eigenschaften "EnableApplePushNotificationService" und "EnableMicrosoftPushNotificationService" auf "True".

-------------------------- Beispiel 2 --------------------------

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

Beispiel 2 veranschaulicht das Erstellen einer Gruppe von Pushkonfigurationseinstellungen für alle Ihre Lync Server-Standorte. Dazu wird zunächst mit dem Cmdlet Get-CsSite eine Auflistung aller Ihrer Lync Server-Standorte zurückgegeben. Diese Auflistung wird anschließend an das Cmdlet ForEach-Object weitergeleitet, das für jeden Standort in der Auflistung das Cmdlet New-CsPushNotificationConfiguration aufruft und eine neue Gruppe von Konfigurationseinstellungen für die Pushbenachrichtigungen für die jeweiligen Standorte erstellt. Beachten Sie, dass bei diesem Befehl ein Fehler auftritt, wenn ein Standort bereits über eine Auflistung von Konfigurationseinstellungen für die Pushbenachrichtigung verfügt.

-------------------------- Beispiel 3 --------------------------

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

Im vorstehenden Beispiel wird gezeigt, wie Sie den Parameter "-InMemory" zum Erstellen einer neuen Auflistung von Konfigurationseinstellungen für die Pushbenachrichtigung verwenden können, die zunächst nur im Arbeitsspeicher vorhanden sind. Hierzu erstellt der Befehl eine neue Einstellungsauflistung (mit dem Identitätswert "site:Redmond"), die in der Variablen "$x" gespeichert wird. Beachten Sie, dass die Auflistung nach Ausführen dieses ersten Befehls nur im Arbeitsspeicher vorhanden ist. Wenn Sie den Befehl Get-CsPushNotificationConfiguration ausführen, wird kein Eintrag für "site:Redmond" angezeigt.

Bei den nächsten beiden Befehlen werden die Eigenschaften "EnableApplePushNotificationService" und "EnableMicrosoftPushNotificationService" für diese virtuelle Auflistung von Einstellungen auf "True" festgelegt, wodurch Pushbenachrichtigungen über den Apple-Pushbenachrichtigungsdienst und Microsoft Lync Server 2010-Pushbenachrichtigungsdienst aktiviert werden. Im letzten Befehl werden schließlich mithilfe des Cmdlets Set-CsPushNotificationConfiguration die virtuellen Pushbenachrichtigungseinstellungen in eine tatsächliche für den Standort "Redmond" geltende Auflistung von Einstellungen umgewandelt. Wenn Sie Set-CsPushNotificationConfiguration nicht aufrufen, verbleiben diese Einstellung nur im Arbeitsspeicher und gehen verloren, wenn Ihre Windows PowerShell-Sitzung beendet oder die Variable "$x" gelöscht wird.