Remove-CsPresencePolicy
Letztes Änderungsdatum des Themas: 2012-03-26
Entfernt die angegebene Anwesenheitsrichtlinie.
Syntax
Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Anwesenheitsinformationen (mit denen Sie unter anderem erfahren, ob ein Kontakt für Instant Messaging-Unterhaltungen verfügbar ist) sind sehr hilfreich. Gleichzeitig sind mit Anwesenheitsinformationen auch Nachteile verbunden: Je mehr Anwesenheitsabonnements Sie haben, desto mehr Netzwerkbandbreite muss zum Aktualisieren von Anwesenheitsinformationen bereitgestellt werden. Wenn die Netzwerkbandbreite ein Problem darstellt, können Sie die Anzahl von Anwesenheitsabonnements für beliebigen Benutzer einschränken.
Mit den CsPresencePolicy-Cmdlets können Sie zwei wichtige Aspekte von Anwesenheitsabonnements verwalten: Abonnentenaufforderungen und Kategorieabonnements. Wenn Sie zur Microsoft Lync 2010-Kontaktliste einer anderen Person hinzugefügt werden, werden Sie standardmäßig mithilfe einer Popupbenachrichtigung darüber informiert. Jede Benachrichtigung gilt als eine Abonnentenaufforderung, bis Sie das angezeigte Popupfenster verwerfen. Mit der Eigenschaft "MaxPromptedSubscriber" der Anwesenheitsrichtlinie können Sie die maximale Anzahl nicht bestätigter Benachrichtigungsdialogfelder pro Benutzer festlegen. (Wenn der Benutzer die maximale Anzahl erreicht, empfängt der Benutzer erst wieder neue Kontaktbenachrichtigungen, nachdem einige Dialogfelder verworfen wurden.)
Kategorieabonnements sind eine Anforderung für eine spezifische Informationskategorie, z. B. eine Anwendung, die Kalenderdaten anfordert. Mit der Eigenschaft "MaxCategorySubscription" können Administratoren die maximale Anzahl zulässiger Kategorieabonnements pro Benutzer einschränken.
In Versionen vor Microsoft Lync Server 2010 wurden Abonnentenaufforderungen und Kategorieabonnements global verwaltet. Mit den CsPresencePolicy-Cmdlets können Sie jetzt diese Anwesenheitsabonnements auf globaler Ebene, auf Standortebene und auf Benutzerebene verwalten. So kann der Bandbreitenverbrauch gesteuert werden, während gleichzeitig sichergestellt wird, dass Benutzer Zugriff auf die Anwesenheitsinformationen haben, die sie zum Ausführen ihrer Aufgaben benötigen.
Auf Standort- oder Benutzerebene erstellte Richtlinien können jederzeit durch Ausführen des Cmdlets Remove-CsPresencePolicy entfernt werden. Dieses Cmdlet kann auch für die globale Richtlinie ausgeführt werden; in diesem Fall wird die globale Richtlinie jedoch nicht wirklich entfernt. (Lync Server 2010 gestattet nicht das Entfernen globaler Richtlinien. Stattdessen werden die beiden Eigenschaften der globalen Richtlinie – "MaxPromptedSubscriber" und "MaxCategorySubscription" – auf die Standardwerte zurückgesetzt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsPresencePolicy lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPresencePolicy"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eindeutige ID für die zu entfernende Anwesenheitsrichtlinie. Verwenden Sie eine Syntax wie die folgende, um eine auf Standortebene konfigurierte Richtlinie zu entfernen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um eine auf Benutzerebene konfigurierte Richtlinie zu entfernen: -Identity "RedmondPresencePolicy". Remove-CsPresencePolicy kann auch für die globale Richtlinie ausgeführt werden; verwenden Sie hierzu die folgende Syntax: -Identity global. Beachten Sie, dass die globale Richtlinie jedoch nicht wirklich entfernt wird. Stattdessen werden die Eigenschaften der Richtlinie auf die Standardwerte zurückgesetzt. |
Force |
Optional |
Switch-Parameter |
Veranlasst, dass Remove-CsPresencePolicy die benutzerbasierte Richtlinie auch dann löscht, wenn die Richtlinie derzeit mindestens einem Benutzer zugewiesen ist. Ist dieser Parameter nicht vorhanden, müssen Sie die Löschanforderung zunächst bestätigen, bevor eine Richtlinie entfernt wird, die derzeit noch verwendet wird. |
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.WritableConfig.Policy.Presence.PresencePolicy-Objekt. Remove-CsPresencePolicy akzeptiert eine weitergeleitete Eingabe von Anwesenheitsrichtlinienobjekten.
Rückgabetypen
Keine. Stattdessen werden mit Remove-CsPresencePolicy Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy" gelöscht.
Beispiel
-------------------------- Beispiel 1 ------------------------
Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"
Mit dem vorstehenden Befehl wird die Anwesenheitsrichtlinie auf Benutzerebene mit dem Identitätswert "RedmondPresencePolicy" gelöscht.
-------------------------- Beispiel 2 ------------------------
Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy
Der Befehl in Beispiel 2 entfernt alle Anwesenheitsrichtlinien, die auf Benutzerebene konfiguriert wurden. (Der Identitätswert dieser Richtlinien beginnt mit dem Präfix "tag:".) Hierzu verwendet der Befehl zunächst Get-CsPresencePolicy mit dem Parameter "Filter", um alle Anwesenheitsrichtlinien auf Benutzerebene zurückzugeben. Der Filterwert "tag:*" beschränkt die zurückgegebenen Daten auf Richtlinien, deren Identitätswert mit der Zeichenfolge "tag:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsPresencePolicy weitergeleitet, das jede Richtlinie in der Auflistung löscht.
-------------------------- Beispiel 3 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy
In Beispiel 3 werden alle Anwesenheitsrichtlinien gelöscht, die mehr als 500 Abonnentenaufforderungen zulassen. Hierzu ruft der Befehl zunächst Get-CsPresencePolicy ohne Parameter auf. Damit wird eine Auflistung aller Anwesenheitsrichtlinien zurückgegeben, die für die Verwendung in der Organisation konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Richtlinien herausfiltert, bei denen die Eigenschaft "MaxPromptedSubscriber" größer ist als 500. Diese gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsPresencePolicy weitergeleitet, das alle Anwesenheitsrichtlinien löscht, die mehr als 500 Abonnentenaufforderungen zulassen.
Siehe auch
Weitere Ressourcen
Get-CsPresencePolicy
Grant-CsPresencePolicy
New-CsPresencePolicy
Set-CsPresencePolicy