Freigeben über

  • Artikel

Grant-CsPresencePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Weist einem oder mehreren Benutzern eine benutzerbasierte Anwesenheitsrichtlinie zu.

Syntax

Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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 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.

Beim Erstellen einer benutzerbasierten Richtlinie wird diese nicht automatisch einem Benutzer zugewiesen. Benutzerbasierte Anwesenheitsrichtlinien müssen Benutzern (oder Benutzergruppen) explizit über das Cmdlet Grant-CsPresencePolicy zugewiesen werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Gibt die Identität des Benutzerkontos an, dem die Anwesenheitsrichtlinie zugewiesen werden soll. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Benutzeridentitäten können auch über den Active Directory-DN (Distinguished Name) des Benutzers angegeben werden.

Ferner können Sie das Sternchen (*) als Platzhalterzeichen verwenden, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Der Identitätswert "* Smith" gibt beispielsweise alle Benutzer zurück, deren Anzeigename auf den Zeichenfolgenwert "Smith" endet.

PolicyName

Erforderlich

Identität der benutzerbasierten Richtlinie, die zugewiesen werden soll. Beispiel: -PolicyName "RedmondPresencePolicy". "PolicyName" ist der Identitätswert der Richtlinie ohne das Präfix "tag:". Beispielsweise lautet die Eigenschaft "PolicyName" für eine Richtlinie mit dem Identitätswert "tag:NorthAmericaPresencePolicy" auf "NorthAmericaPresencePolicy".

DomainController

Optional

Vollqualifizierter Name (FQDN) des Domänencontrollers, der beim Zuweisen der Richtlinie kontaktiert werden soll. Beispiel: -DomainController atl-dc-001.litwareinc.com.

Wird dieser Parameter nicht angegeben, kontaktiert Grant-CsPresencePolicy beim Zuweisen der Richtlinie den nächsten verfügbaren Domänencontroller.

PassThru

Optional

Ermöglicht das Weiterleiten eines Benutzerobjekts, das den Benutzer darstellt, dem die Richtlinie zugewiesen wird. Das Cmdlet Grant-CsPresencePolicy leitet standardmäßig keine Objekte weiter.

WhatIf

Optional

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Zeichenfolge oder Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy-Objekt. Grant-CsPresencePolicy akzeptiert eine weitergeleitete Eingabe von Zeichenfolgenwerten, die den Identitätswert eines Benutzerkontos repräsentieren. Das Cmdlet akzeptiert auch eine weitergeleitete Eingabe von Benutzerobjekten.

Rückgabetypen

Grant-CsPresencePolicy gibt keine Objekte oder Werte zurück. Wenn Sie jedoch den Parameter "PassThru" einschließen, gibt das Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact" zurück.

Beispiel

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

Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"

Mit dem Befehl in Beispiel 1 wird die benutzerbasierte Anwesenheitsrichtlinie "RedmondPresencePolicy" einem einzelnen Benutzer zugewiesen: dem Benutzer mit der Identität "Ken Myer".

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

In Beispiel 2 wird die Anwesenheitsrichtlinie "RedmondPresencePolicy" allen Benutzern mit Konten in der Organisationseinheit "Redmond" in Active Directory-Domänendienste (AD DS) zugewiesen. Hierzu gibt der Befehl zunächst mithilfe von Get-CsUser und dem Parameter "OU" eine Auflistung aller Benutzerkonten in der Organisationseinheit "Redmond" (OU=Redmond,dc=litwareinc,dc=com) zurück. Diese Auflistung wird dann an das Cmdlet Grant-CsPresencePolicy weitergeleitet, das die Richtlinie "RedmondPresencePolicy" jedem Benutzer in der Auflistung zuweist.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

Über den vorstehenden Befehl wird die Richtlinie "RedmondPresencePolicy" allen Benutzern in der Stadt Redmond zugewiesen. Hierzu verwendet der Befehl zunächst Get-CsUser und den Parameter "LDAPFilter", um eine Auflistung aller Benutzer zurückzugeben, die in Redmond arbeiten. Der Filterwert "l=Redmond" schränkt die zurückgegebenen Daten auf Benutzer in Redmond ein. (In der LDAP-Abfragesprache ist "l", ein kleines L, die Kurzform von "locality", d. h. des Orts.) Die abgerufene Auflistung wird dann an das Cmdlet Grant-CsPresencePolicy weitergeleitet, das die Richtlinie "RedmondPresencePolicy" jedem Benutzer in der Auflistung zuweist.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null

Über den Befehl in Beispiel 4 wird die Zuweisung aller benutzerbasierten Anwesenheitsrichtlinien für Benutzer aufgehoben, die in Redmond arbeiten. Durch den Aufruf von Grant-CsPresencePolicy mit einem Nullwert für den Parameter "PolicyName" werden sämtliche benutzerbasierten Anwesenheitsrichtlinien von Benutzern, die von diesem Befehl betroffen sind, entfernt.