Freigeben über

  • Artikel

Set-CsPresencePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert eine vorhandene Anwesenheitsrichtlinie.

Syntax

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-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 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.

Mit dem Cmdlet Set-CsPresencePolicy können Sie die für Ihre Organisation konfigurierten Anwesenheitsrichtlinien ändern. Diese Änderung der Anwesenheitsrichtlinie bedeutet lediglich, dass der Wert der Eigenschaft "MaxPromptedSubscriber" und/oder der Eigenschaft "MaxCategorySubscription" geändert wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Eindeutige ID der zu ändernden Anwesenheitsrichtlinie. Verwenden Sie folgende Syntax, um die globale Richtlinie zu ändern: -Identity global. Verwenden Sie eine Syntax wie die folgende, um eine Richtlinie auf Standortebene anzupassen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um eine benutzerbasierte Richtlinie zu ändern: -Identity "RedmondPresencePolicy".

Instance

Optional

Anwesenheitsrichtlinienobjekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

Description

Optional

Zeichenfolge

Ermöglicht Administratoren die Bereitstellung von zusätzlichem Text zur Anwesenheitsrichtlinie. Die Beschreibung kann z. B. Informationen zu den Benutzern enthalten, denen die Richtlinie zugewiesen werden sollte.

MaxCategorySubscription

Optional

Ganze Zahl

Die maximale Anzahl von Kategorieabonnements, die zu jedem Zeitpunkt zulässig sind. Ein Kategorieabonnement ist eine Anforderung für eine spezifische Informationskategorie, z. B. eine Anwendung, die Kalenderdaten anfordert.

"MaxCategorySubscription" kann auf einen beliebigen ganzzahligen Wert zwischen 0 und 3000 festgelegt werden. Der Standardwert lautet 1000.

MaxPromptedSubscriber

Optional

Ganze Zahl

Die maximale Anzahl von Abonnentenaufforderungen, die zu jedem Zeitpunkt für einen Benutzer vorliegen können. Jedes Mal, wenn Sie zur Kontaktliste eines anderen Benutzers hinzugefügt werden, wird standardmäßig ein Benachrichtigungsdialogfeld angezeigt, das Sie über die Aufforderung informiert. Sie haben die Möglichkeit, die Person zu Ihrer eigenen Kontaktliste hinzuzufügen oder die Person zu blockieren, damit sie Ihre Anwesenheit nicht anzeigen kann. Jede Benachrichtigung gilt als eine Abonnentenaufforderung, bis Sie eine Aktion ausführen und das Dialogfeld verwerfen.

"MaxPromptedSubscriber" kann auf einen ganzzahligen Wert zwischen 0 und 600 (einschließlich) festgelegt werden. Der Standardwert lautet 200. Wenn Sie diesen Wert auf 0 festlegen, erhalten Benutzer keine Benachrichtigung, wenn sie zur Kontaktliste anderer Benutzer hinzugefügt werden.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

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. Set-CsPresencePolicy akzeptiert eine weitergeleitete Eingabe von Anwesenheitsrichtlinienobjekten.

Rückgabetypen

Set-CsPresencePolicy gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy" geändert.

Beispiel

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

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

Der Befehl in Beispiel 1 ändert die benutzerbasierte Anwesenheitsrichtlinie "RedmondPresencePolicy". In diesem Beispiel wird der Wert der Eigenschaft "MaxPromptedSubscriber" auf 300 festgelegt.

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

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

Der Befehl in Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In diesem Fall wird die Eigenschaft "MaxPromptedSubscriber" jedoch für alle Anwesenheitsrichtlinien, die für die Verwendung in dieser Organisation konfiguriert wurden, auf 300 festgelegt. 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 Set-CsPresencePolicy weitergeleitet, das den Wert der Eigenschaft "MaxPromptedSubscriber" jeder Richtlinie in der Auflistung auf 300 festlegt.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

Beispiel 3 zeigt, wie Sie die Anwesenheitsrichtlinien in Ihrer Organisation konfigurieren können, um sicherzustellen, dass bei keiner Richtlinie mehr als 300 Abonnentenaufforderungen zulässig sind. Hierzu ruft der Befehl zunächst Get-CsPresencePolicy ohne Parameter auf, um eine Auflistung aller Anwesenheitsrichtlinien in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Richtlinien herausfiltert, bei denen der Wert der Richtlinie "MaxPromptedSubscriber" größer als 300 ist. Die gefilterte Auflistung wird dann an Set-CsPresencePolicy weitergeleitet, das die Höchstanzahl von zulässigen Abonnentenaufforderungen in jeder Richtlinie auf 300 festlegt. Das hat zur Folge, dass in keiner Richtlinie mehr als 300 Abonnentenaufforderungen zulässig sind, wobei bei einigen Richtlinien möglicherweise weniger als 300 Abonnentenaufforderungen zulässig sind.