• Artikel

Get-CsClientPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Clientrichtlinien zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. Clientrichtlinien dienen u. a. zum Bestimmen der Funktionen von Microsoft Lync 2010, die Benutzern zur Verfügung gestellt werden. Sie können beispielsweise einigen Benutzern die Berechtigung zum Übertragen von Dateien erteilen, während sie anderen diese Berechtigung verweigern.

Syntax

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

Get-CsClientPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

In Lync Server 2010 ersetzen Clientrichtlinien die Gruppenrichtlinieneinstellungen, die in früheren Versionen des Produkts verwendet wurden. In Microsoft Office Communicator 2007 und Microsoft Office Communicator 2007 R2 dienten Gruppenrichtlinien zum Festlegen, welche Aufgaben Benutzer mit Communicator und anderen Clients ausführen konnten. Es gab beispielsweise Gruppenrichtlinieneinstellungen, die festlegten, ob Benutzer eine Aufzeichnung ihrer Sofortnachrichtensitzungen speichern, Informationen aus Microsoft Outlook in ihre Anwesenheitsinformationen integrieren und Emoticons oder formatierten Text in Sofortnachrichten einfügen konnten oder nicht.

Doch obwohl Gruppenrichtlinien sehr nützlich sind, weist diese Technologie bei Verwendung mit Lync Server 2010 einige Einschränkungen auf. Gruppenrichtlinien wurden zum einen für eine domänen- oder OU-basierte Nutzung konzipiert, sodass sie nur schwer einer gezielten Benutzergruppe zugewiesen werden können (z. B. allen Benutzern in einer bestimmten Abteilung oder mit einer bestimmten Position). Zum anderen gelten Gruppenrichtlinien nur für Benutzer, die sich bei der Domäne und über einen Computer anmelden. Gruppenrichtlinien gelten nicht für Benutzer, die über das Internet oder ein Mobiltelefon auf das System zugreifen. Dies bedeutet, dass demselben Benutzer, abhängig davon, mit welchem Gerät und wo er sich anmeldet, eine unterschiedliche Umgebung angezeigt werden kann.

Um diese Inkonsistenzen in den Griff zu bekommen, verwendet Lync Server 2010 Clientverwaltungsrichtlinien anstelle von Gruppenrichtlinien. Clientrichtlinien gelten, sobald ein Benutzer auf das System zugreift, und zwar unabhängig davon, wo oder mit welchem Gerät die Anmeldung erfolgt. Zusätzlich können Clientrichtlinien, wie andere Lync Server 2010-Richtlinien, problemlos auf ausgewählte Benutzergruppen angewendet werden. Sie können sogar benutzerdefinierte Richtlinien erstellen, die einzelnen Benutzern zugewiesen werden.

Clientrichtlinien können auf globaler Ebene, auf Standortebene und für individuelle Benutzer konfiguriert werden. Das Cmdlet Get-CsClientPolicy bietet die Möglichkeit, Informationen zu allen Clientrichtlinien zurückzugeben, die für die Verwendung 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-CsClientPolicy 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-CsClientPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebende Clientrichtlinie. Verwenden Sie diese Syntax, um auf die globale Richtlinie zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Standortrichtlinie zu verweisen: -Identity site:Redmond. Verwenden Sie eine Syntax wie die folgende, um auf eine benutzerbasierte Richtlinie zu verweisen: -Identity SalesDepartmentPolicy.

Wenn dieser Parameter nicht angegeben ist, werden alle Clientrichtlinien zurückgegeben, die für die Verwendung in der Organisation konfiguriert sind.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Richtlinie(n). Verwenden Sie beispielsweise folgende Syntax, um alle auf der Standortebene konfigurierten Richtlinien zurückzugeben: -Filter "site:*". Um eine Auflistung aller benutzerbasierten Richtlinien zurückzugeben, verwenden Sie folgende Syntax: -Filter "tag:*".

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsClientPolicy akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsClientPolicy werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy" zurückgegeben.

Beispiel

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

Get-CsClientPolicy

Im vorstehenden Beispiel wird Get-CsClientPolicy ohne zusätzliche Parameter aufgerufen. Dadurch wird eine Auflistung aller Clientrichtlinien zurückgegeben, die für die Verwendung in der Organisation konfiguriert sind.

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

Get-CsClientPolicy -Identity SalesPolicy

In Beispiel 2 wird Get-CsClientPolicy verwendet, um die benutzerbasierte Richtlinie mit der Identität "SalesPolicy" zurückzugeben. Da Identitätswerte eindeutig sind, gibt dieser Befehl jeweils nur ein Element zurück.

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

Get-CsClientPolicy -Filter "tag:*"

In Beispiel 3 wird der Parameter "Filter" verwendet, um alle Clientrichtlinien zurückzugeben, die auf Benutzerebene konfiguriert wurden. Der Filterwert "tag:*" beschränkt die von Get-CsClientPolicy zurückgegebenen Richtlinien auf diejenigen, deren Identitätswert mit der Zeichenfolge "tag:" beginnt.

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

Mit dem vorstehenden Befehl wird eine Auflistung aller für die Verwendung in der Organisation konfigurierten Clientrichtlinien zurückgegeben, bei denen die Eigenschaft "DisableSavingIM" den Wert "True" aufweist. Dazu wird Get-CsClientPolicy zunächst ohne Parameter aufgerufen, um eine Auflistung aller Clientrichtlinien zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Richtlinien herausfiltert, bei denen die Eigenschaft "DisableSavingIM" den Wert "True" aufweist.

-------------------------- Beispiel 5 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

In Beispiel 5 werden nur Clientrichtlinien zurückgegeben, die die folgenden beiden Kriterien erfüllen: Die Eigenschaft "DisableSavingIM" muss den Wert "True" aufweisen, und die Eigenschaft "EnableIMAutoArchiving" muss den Wert "False" aufweisen. Dazu ruft der Befehl zunächst Get-CsClientPolicy auf, um eine Auflistung aller Clientrichtlinien zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das nur die Richtlinien auswählt, die die beiden folgenden Kriterien erfüllen: "DisableSavingIM" muss den Wert "True" aufweisen, und "EnableIMAutoArchiving" muss den Wert "False" aufweisen. Der Operator "-and" weist Where-Object an, nur Objekte auszuwählen, die alle angegebenen Kriterien erfüllen.

-------------------------- Beispiel 6 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}

Beispiel 6 ist eine Variante des Befehls in Beispiel 5. Diesmal werden jedoch Richtlinien ausgewählt, die mindestens eines der folgenden Kriterien erfüllen: Die Eigenschaft "DisableSavingIM" weist den Wert "True" auf, und/oder die Eigenschaft "EnableIMAutoArchiving" weist den Wert "False" auf. Dazu ruft der Befehl zunächst Get-CsClientPolicy auf, um eine Auflistung aller Clientrichtlinien zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Richtlinien herausfiltert, die mindestens eines der folgenden Kriterien erfüllen: "DisableSavingIM" weist den Wert "True" auf, und/oder "EnableIMAutoArchiving" weist den Wert "False" auf. Der Operator "-or" weist Where-Object an, alle Objekte auszuwählen, die mindestens eine der angegebenen Bedingungen erfüllen.