Freigeben über

  • Artikel

Get-CsClientVersionConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Lädt Informationen über die angegebene Auflistung der Konfigurationseinstellungen für die Clientversion, die in Ihrer Organisation verwendet werden. Konfigurationseinstellungen für die Clientversion legen fest, ob Microsoft Lync Server 2010 die Versionsnummer der einzelnen Clientanwendungen prüft, die sich beim System anmelden. Wenn die Clientversionsfilterung aktiviert ist, hängt der Zugriff der jeweiligen Clientanwendung auf das System von den Einstellungen ab, die in der entsprechenden Clientversionsrichtlinie konfiguriert sind.

Syntax

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

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

Detaillierte Beschreibung

Lync Server 2010 räumt Administratoren einen beträchtlichen Spielraum in Bezug auf die Angabe der Clientsoftware (und ebenso auf die Versionsnummer der jeweiligen Software) ein, mit der Benutzer sich beim System anmelden können. Beispielsweise gibt es keinen technischen Grund dafür, dass Benutzer sich über Microsoft Lync 2010 bei Lync Server 2010 anmelden müssen. Es gelten keine technischen Einschränkungen, die einen Benutzer an der Anmeldung über Microsoft Office Communicator 2007 R2 hindern.

Es kann jedoch nicht technische Gründe dafür geben, dass Benutzer sich nicht über Office Communicator 2007 R2 anmelden sollten. Beispielsweise unterstützt Office Communicator 2007 R2 nicht alle Funktionen und Möglichkeiten von Lync 2010. Demzufolge verwenden Benutzer, die sich über Office Communicator 2007 R2 anmelden, die Anwendung anders als Benutzer, die sich über Lync 2010 anmelden. Dieser Umstand kann sowohl für Ihre Benutzer zu Schwierigkeiten führen als auch für das Helpdeskpersonal, das Support für eine Reihe verschiedener Clientanwendungen leisten muss.

Wenn dies für Ihre Organisation ein Problem darstellen könnte, können Sie die Clientversionsfilterung einsetzen und angeben, welche Clientanwendungen für die Anmeldung bei Lync Server 2010 verwendet werden können. Bei der Installation von Lync Server 2010 wird ein globaler Satz mit Konfigurationseinstellungen für Clientversionen installiert und aktiviert. Anhand dieser Einstellungen wird festgelegt, ob die Clientversionsfilterung aktiviert wird. Zusätzlich zu den globalen Einstellungen können Konfigurationseinstellungen für Clientversionen auch auf Standortebene angewendet werden. In diesen Instanzen haben die standortbasierten Einstellungen Vorrang vor den globalen Einstellungen.

Mit dem Cmdlet Get-CsClientVersionConfiguration können Sie Informationen zu den Konfigurationseinstellungen für die Clientversion abrufen, die derzeit in Ihrer Organisation verwendet werden. Beachten Sie, dass dieses Cmdlet keine Informationen darüber zurückgibt, welche Clientanwendungen zulässig sind und welche nicht. Zum Abrufen dieser Informationen verwenden Sie Get-CsClientVersionPolicy.

Beachten Sie zudem, dass die Clientversionskonfiguration keine Sicherheitsfunktion darstellt. Die Technologie verlässt sich auf die Selbstauskunft der Clientanwendungen und versucht nicht sicherzustellen, dass es sich bei einer Anwendung tatsächlich um die Anwendung und die Versionsnummer handelt, die sie vorgibt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Gibt die eindeutige ID für die Auflistung der zurückzugebenden Konfigurationseinstellungen für die Clientversion an. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf eine Auflistung zu verweisen, die auf Standortebene konfiguriert ist: -Identity site:Redmond. Sie können beim Angeben eines Identitätswerts keine Platzhalter verwenden. Wenn Platzhalter nötig sind, verwenden Sie stattdessen den Parameter "Filter".

Wenn dieser Parameter nicht angegeben ist, gibt Get-CsClientVersionConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Konfigurationseinstellungen für die Clientversion zurück.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen, um eine Auflistung (oder mehrere Auflistungen) von Konfigurationseinstellungen für die Clientversion zurückzugeben. Verwenden Sie folgende Syntax, um eine Auflistung aller auf Standortebene konfigurierten Einstellungen zurückzugeben: -Filter site:*. Verwenden Sie folgende Syntax, um eine Auflistung aller Einstellungen, deren Identitätswert (die einzige Eigenschaft, nach der gefiltert werden kann) den Zeichenfolgenwert "EMEA" aufweist, zurückzugeben: -Filter *EMEA*.

LocalStore

Optional

Switch-Parameter

Ruft die Konfigurationsdaten für Clientversionsrichtlinien aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsClientVersionConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsClientVersionConfiguration werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration" zurückgegeben.

Beispiel

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

Get-CsClientVersionConfiguration

Im ersten Beispiel wird Get-CsClientVersionConfiguration ohne zusätzliche Parameter aufgerufen. Get-CsClientVersionConfiguration gibt eine Auflistung aller Konfigurationseinstellungen für die Clientversion zurück, die derzeit in Ihrer Organisation verwendet werden.

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

Get-CsClientVersionConfiguration -Identity site:Redmond

Im vorstehenden Beispiel gibt Get-CsClientVersionConfiguration alle Konfigurationseinstellungen für die Clientversion zurück, die den Identitätswert "site:Redmond" aufweisen. Da Identitätswerte eindeutig sein müssen, gibt dieser Befehl immer nur ein Element zurück.

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

Get-CsClientVersionConfiguration -Filter "site:*"

In Beispiel 3 werden alle Konfigurationseinstellungen für die Clientversion zurückgegeben, die auf Standortebene angewendet wurden. Hierzu werden der Parameter "Filter" und der Filterwert "site:*" verwendet. Dieser Filterwert weist Get-CsClientVersionConfiguration an, nur die Einstellungen zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt.

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

Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False}

Im vorstehenden Beispiel werden alle Konfigurationseinstellungen für die Clientversion zurückgegeben, die derzeit deaktiviert sind. Zu diesem Zweck ruft der Befehl zunächst Get-CsClientVersionConfiguration auf, um eine Auflistung aller Clientversionseinstellungen zurückzugeben, die zur Verwendung innerhalb der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Auflistung mithilfe eines Filters auf die Einstellungen beschränkt, deren Eigenschaft "Enabled" den Wert "False" aufweist.