Freigeben über

  • Artikel

Get-CsClientVersionPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen darüber zurück, welche Clients (z. B. Microsoft Office Communicator 2007 R2) in Ihrer Microsoft Lync Server 2010-Umgebung unterstützt werden. Mit Clientversionsrichtlinien können Sie festlegen, welche Clients (z. B. Office Communicator 2007 R2) sich bei Ihrem Lync Server 2010-System anmelden können.

Syntax

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

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

Detaillierte Beschreibung

Clientversionsrichtlinien repräsentieren eine Sammlung von Clientversionsregeln, mit deren Hilfe ermittelt wird, welche Clientanwendungen sich bei Lync Server 2010 anmelden dürfen. Wenn ein Benutzer versucht, sich bei Lync Server 2010 anzumelden, sendet die zugehörige Clientanwendung einen SIP-Header an den Server. Dieser Header enthält ausführliche Informationen zur Anwendung, darunter die Hauptversion, die Nebenversion und die Buildnummer der Software. Diese Versionsinformationen im SIP-Header werden mit einer Auflistung von Clientversionsregeln verglichen, um herauszufinden, ob für diese spezielle Anwendung Regeln gelten. Ist eine solche Regel vorhanden, führt Lync Server 2010 die in der Regel angegebene Aktion aus. Die Regel kann Lync Server 2010 beispielsweise anweisen, die Anmeldung zuzulassen, die Anmeldung zu blockieren oder die Anmeldung zuzulassen, aber anschließend ein unbeaufsichtigtes Upgrade der Clientanwendung auf die neueste Version durchzuführen (beispielsweise ein Upgrade von Communicator 2007 R2 auf Lync 2010).

Clientversionsrichtlinien – die global, auf Standortebene, auf Dienstebene (nur Registrierungsdienst) oder für individuelle Benutzer angewendet werden können – bieten Flexibilität bei der Bestimmung, welche Clientanwendungen für den Zugriff auf das System verwendet werden können. Sie können beispielsweise verhindern, dass Benutzer sich mit Communicator 2007 R2 bei Lync Server 2010 anmelden, da nicht die gleichen Funktionen wie in Lync 2010 unterstützt werden. Es könnte jedoch möglich sein, dass verschiedene Benutzer aufgrund von Hardware- oder Softwarekonflikten kein Upgrade auf Lync 2010 ausführen können. In diesem Fall können Sie eine separate Regel sowie eine separate Clientversionsrichtlinie erstellen, die es diesen Benutzern ermöglicht, sich über Communicator 2007 R2 anzumelden.

Das Cmdlet Get-CsClientVersionPolicy bietet eine Möglichkeit, alle derzeit in der Organisation verwendeten Clientversionsrichtlinien abzurufen und die einzelnen Regeln anzuzeigen, aus denen sich diese Richtlinien zusammensetzen.

Beachten Sie, dass Clientversionsrichtlinien nicht für Partnerbenutzer gelten. Stattdessen sind Partnerbenutzer an die Clientversionsrichtlinien in ihrer eigenen Organisation gebunden. Beispiel: Angenommen, ein Partnerbenutzer verwendet Client A, einen von der Partnerorganisation zugelassenen Client. Solange die Partnerorganisation die Verwendung von Client A zulässt, kann der Benutzer unter Verwendung dieses Clients mit Ihrer Organisation kommunizieren. Dies gilt selbst dann, wenn Ihre Clientversionsrichtlinien die Verwendung von Client A untersagen. In Ihrer Organisation erzwungene Clientversionsrichtlinien setzen die in einer Partnerorganisation verwendeten Clientversionsrichtlinien nicht außer Kraft.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Get-CsClientVersionPolicy lokal auszufü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-CsClientVersionPolicy\b"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die zurückzugebende Richtlinie. Verwenden Sie die 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 Dienstebene konfigurierte Richtlinie zurückzugeben: -Identity "Registrar:atl-cs-001.litwareinc.com". Der Registrierungsdienst ist der einzige Dienst, der eine Clientversionsrichtlinie hosten kann.

Richtlinien können auch auf Benutzerebene konfiguriert werden. Verwenden Sie eine Syntax wie die folgende, um eine dieser Richtlinien zurückzugeben: -Identity "SalesDepartmentPolicy".

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

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhaltern beim Angeben der abzurufenden Richtlinie(n). Mit der folgenden Syntax werden beispielsweise alle auf Standortebene konfigurierten Richtlinien zurückgegeben: -Filter "site:*". Verwenden Sie folgende Syntax, um alle auf Benutzerebene konfigurierten Richtlinien zurückzugeben: -Filter "tag:*".

Sie können die Parameter "Filter" und "Identity" nicht im gleichen Befehl verwenden.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsClientVersionPolicy akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsClientVersionPolicy werden Instanzen des Richtlinienobjekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersion" zurückgegeben.

Beispiel

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

Get-CsClientVersionPolicy

Im ersten Beispiel wird Get-CsClientVersionPolicy ohne zusätzliche Parameter aufgerufen. Daraufhin gibt Get-CsClientVersionPolicy eine Auflistung aller Clientversionsrichtlinien zurück, die derzeit für die Verwendung in Ihrer Organisation konfiguriert sind.

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

Get-CsClientVersionPolicy -Identity site:Redmond

Im vorstehenden Beispiel gibt Get-CsClientVersionPolicy alle Clientversionsrichtlinien mit dem Identitätswert "site:Redmond" zurück. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur ein Element zurück.

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

Get-CsClientVersionPolicy -Filter site:*

In Beispiel 3 werden alle Clientversionsrichtlinien zurückgegeben, die auf Standortebene konfiguriert wurden. Hierzu werden der Parameter "Filter" und der Filterwert "site:*" angegeben. Mit diesem Filterwert gibt Get-CsClientVersionPolicy nur die Richtlinien zurück, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsClientVersionPolicy | Select-Object -ExpandProperty Rules

Der Befehl in Beispiel 4 zeigt ausführliche Informationen zu den einzelnen Regeln an, die für die einzelnen Clientversionsrichtlinien konfiguriert sind. Hierzu wird zunächst mit Get-CsClientVersionPolicy eine Auflistung aller Clientversionsrichtlinien abgerufen, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Select-Object weitergeleitet, das den Filter "ExpandProperty" zum Erweitern des Werts der Eigenschaft "Rules" verwendet. Wenn diese Eigenschaft erweitert wurde, werden am Bildschirm ausführliche Informationen zu jeder Richtlinie angezeigt (darunter beispielsweise Eigenschaftswerte wie Buildnummer, Hauptversion und Nebenversion).