Freigeben über

  • Artikel

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.