Remove-CsPushNotificationConfiguration
Letztes Änderungsdatum des Themas: 2012-04-23
Löscht eine vorhandene Auflistung von Pushbenachrichtigungseinstellungen. Der Pushbenachrichtigungsdienst (Apple-Pushbenachrichtigungsdienst und Microsoft Lync Server 2010-Pushbenachrichtigungsdienst) bietet eine Möglichkeit zum Senden von Benachrichtigungen zu Ereignissen wie neuen Sofortnachrichten oder neuer Voicemail an mobile Geräte wie iPhones und Windows Phones, selbst wenn die Anwendung Microsoft Lync 2010 auf diesen Geräten gegenwärtig angehalten ist oder im Hintergrund ausgeführt wird.
Syntax
Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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.
Diese benutzerdefinierten Einstellungen können später mit dem Cmdlet Remove-CsPushNotificationConfiguration entfernt werden. Wenn Sie auf Standortebene konfigurierte Einstellungen löschen, unterliegen Benutzer an diesem Standort automatisch den globalen Pushbenachrichtigungseinstellungen.
Das Cmdlet Remove-CsPushNotificationConfiguration kann auch auf die globalen Einstellungen angewendet werden. In diesem Fall werden die globalen Einstellungen jedoch nicht wirklich entfernt; vielmehr werden alle Eigenschaften in dieser globalen Auflistung auf ihre Standardwerte zurückgesetzt. Dies führt dazu, dass Pushbenachrichtigungen sowohl für den Apple-Pushbenachrichtigungsdienst als auch für den Microsoft Lync Server 2010-Pushbenachrichtigungsdienst deaktiviert werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsPushNotificationConfiguration lokal auszuführen: RTCUniversalServerAdmins.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eindeutige ID für die zu entfernenden Konfigurationseinstellungen für die Pushbenachrichtigung. Verwenden Sie folgende Syntax, um die globale Auflistung zu entfernen: -Identity global Beachten Sie, dass Sie die globalen Einstellungen nicht wirklich entfernen können. Stattdessen können Sie nur die Eigenschaften auf ihre Standardwerte zurücksetzen. Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity site:Redmond Sie können beim Angeben einer Richtlinienidentität keine Platzhalter verwenden. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
Tenant |
Optional |
GUID |
Dieser Parameter ist für die Verwendung mit Microsoft Office 365 reserviert. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration. Remove-CsPushNotificationConfiguration akzeptiert weitergeleitete Instanzen des Objekts "PushNotificationConfiguration".
Rückgabetypen
Keine. Stattdessen werden mit Remove-CsPushNotificationConfiguration Instanzen des Objekts "Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration" gelöscht.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsPushNotificationConfiguration -Identity "site:Redmond"
Mit dem Befehl in Beispiel 1 wird die Auflistung von Pushbenachrichtigungseinstellungen gelöscht, die dem Standort "Redmond" zugewiesen sind.
-------------------------- Beispiel 2 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration
Mit diesem Befehl werden alle auf Standortebene konfigurierten Pushbenachrichtigungseinstellungen gelöscht. Hierzu wird zunächst das Cmdlet Get-CsPushNotificationConfiguration mit dem Parameter "Filter" verwendet, um eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurückzugeben. Der Filterwert "site:*" begrenzt die zurückgegebenen Einstellungen auf diejenigen, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Die Einstellungen auf Standortebene werden dann an das Cmdlet Remove-CsPushNotificationConfiguration weitergeleitet und von diesem gelöscht.
-------------------------- Beispiel 3 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration
Beispiel 3 veranschaulicht, wie alle Konfigurationseinstellungen für Pushbenachrichtigungen entfernt werden können, bei denen Pushbenachrichtigungen im Microsoft Lync Server 2010-Pushbenachrichtigungsdienst deaktiviert wurden. Hierzu wird im ersten Befehl das Cmdlet Get-CsPushNotificationConfiguration verwendet, um eine Auflistung aller derzeit aktivierten Pushbenachrichtigungseinstellungen zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, deren Eigenschaft "EnableMicrosoftPushNotificationService" gleich (-eq) "False" ist. Diese gefilterte Auflistung wird danach an das Remove-CsPushNotificationConfiguration weitergeleitet, das alle Elemente in dieser Auflistung löscht.