Freigeben über

  • Artikel

Get-CsPresencePolicy

 

Letztes Änderungsdatum des Themas: 2012-05-21

Gibt Informationen zu den Anwesenheitsrichtlinien zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind.

Syntax

Get-CsPresencePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPresencePolicy [-Filter <String>] [-LocalStore <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 bestätigt 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.

Das Cmdlet Get-CsPresencePolicy bietet die Möglichkeit, Informationen zu allen Anwesenheitsrichtlinien zurückzugeben, die in Ihrer Organisation konfiguriert sind.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsPresencePolicy lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsPresencePolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID der abzurufenden Anwesenheitsrichtlinie. Verwenden Sie folgende Syntax, um die globale Richtlinie zurückzugeben: -Identity global. Verwenden Sie eine Syntax wie die folgende, um eine auf Standortebene konfigurierte Richtlinie zurückzugeben: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um eine auf Benutzerebene konfigurierte Richtlinie zurückzugeben: -Identity "RedmondPresencePolicy". Sie können beim Angeben eines Identitätswerts keine Platzhalterzeichen verwenden.

Wenn weder der Parameter "Identity" noch der Parameter "Filter" angegeben wurde, werden mit Get-CsPresencePolicy alle für die Organisation konfigurierten Anwesenheitsrichtlinien zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Richtlinien. Mit dieser Syntax werden beispielsweise alle auf Standortebene konfigurierten Anwesenheitsrichtlinien zurückgegeben: -Filter "site:*".

Die Parameter "Filter" und "Identity" können nicht innerhalb desselben Befehls verwendet werden.

LocalStore

Optional

Switch-Parameter

Ruft die Daten zur Anwesenheitsrichtlinie aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsPresencePolicy akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit dem Cmdlet Get-CsPresencePolicy werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy" zurückgegeben.

Beispiel

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

Get-CsPresencePolicy

Der Befehl in Beispiel 1 gibt Informationen zu allen Anwesenheitsrichtlinien zurück, die für die Nutzung in Ihrer Organisation konfiguriert wurden. Hierzu wird Get-CsPresencePolicy ohne Parameter aufgerufen.

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

Get-CsPresencePolicy -Identity "RedmondPresencePolicy"

In Beispiel 2 wird eine einzelne benutzerbezogene Anwesenheitsrichtlinie zurückgegeben, nämlich die Richtlinie mit dem Identitätswert "RedmondPresencePolicy".

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

Get-CsPresencePolicy -Filter "site:*"

Mit dem vorstehenden Befehl werden alle auf Standortebene konfigurierten Anwesenheitsrichtlinien zurückgegeben. Hierzu wird der Befehl mit dem Parameter "Filter" und dem Filterwert "site:*" aufgerufen. Dieser Filterwert beschränkt die zurückgegebenen Daten auf alle Anwesenheitsrichtlinien, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt.

-------------------------- Beispiel 4 ------------------------

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}

In Beispiel 4 werden Informationen zu allen Anwesenheitsrichtlinien zurückgegeben, welche die Höchstanzahl der Abonnentenaufforderungen auf maximal 100 begrenzen. 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" kleiner gleich 100 ist.