Freigeben über

  • Artikel

Set-CsClientVersionConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert die angegebene Auflistung von Konfigurationseinstellungen für Clientversionen. 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

Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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.

Auf der anderen Seite könnte es 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 Fällen haben die standortbasierten Einstellungen Vorrang vor den globalen Einstellungen.

Mit dem Cmdlet Set-CsClientVersionConfiguration können Sie eine vorhandene Auflistung von Konfigurationseinstellungen für Clientversionen ändern.

Beachten Sie, 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 Set-CsClientVersionConfiguration 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-CsClientVersionConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Konfigurationseinstellungen für Clientversionen, die geändert werden sollen. Verwenden Sie eine Syntax wie die folgende, um die globalen Einstellungen zu ändern: -Identity global. Verwenden Sie eine Syntax wie die folgende, um die auf Standortebene zugewiesenen Einstellungen zu ändern: "site:Redmond".

Wenn dieser Parameter nicht enthalten ist, werden mit Set-CsClientVersionConfiguration automatisch die globalen Einstellungen konfiguriert.

Instance

Optional

ClientVersionPolicy-Objekt

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

DefaultAction

Optional

Zeichenfolge

Gibt die auszuführende Aktion beim Versuch eines Benutzers an, sich über eine Clientanwendung anzumelden, deren Versionsnummer nicht in der entsprechenden Clientversionsrichtlinie ermittelt werden kann. "DefaultAction" muss auf einen der folgenden Werte festgelegt werden:

Allow. Die Clientanwendung kann sich anmelden.

AllowWithUrl. Die Clientanwendung kann sich anmelden. Zusätzlich wird dem Benutzer ein Meldungsfenster angezeigt, in dem die URL einer Webseite aufgeführt ist, von der der Benutzer eine genehmigte Clientanwendung herunterladen kann. Die URL für diese Webseite sollte als Wert für die Eigenschaft "DefaultUrl" angegeben werden.

Block. Die Clientanwendung kann sich nicht anmelden.

BlockWithUrl. Die Clientanwendung kann sich nicht anmelden. Allerdings enthält das Meldungsfenster "Access denied", das dem Benutzer angezeigt wird, die URL einer Webseite, von der der Benutzer eine genehmigte Clientanwendung herunterladen kann. Die URL für diese Webseite sollte als Wert für die Eigenschaft "DefaultUrl" angegeben werden.

Diese Eigenschaft wird ignoriert, wenn die Eigenschaft "Enabled" auf "False" festgelegt ist. Wenn die Eigenschaft "Enabled" auf "False" gesetzt wird, werden keine Clientversionsfilter angewendet.

DefaultUrl

Optional

Zeichenfolge

Gibt die URL der Webseite an, von der Benutzer eine genehmigte Clientanwendung herunterladen können. Wird dieser Wert angegeben und "DefaultAction" auf "BlockWithURL" gesetzt, erscheint diese URL im Meldungsfenster "Access denied", das jedes Mal angezeigt wird, wenn der Benutzer versucht, sich über eine nicht unterstützte Anwendung anzumelden.

Enabled

Optional

Boolescher Wert

Gibt an, ob die Clientversionsfilterung aktiviert ist. Wenn die Eigenschaft "Enabled" auf "True" festgelegt ist, überprüft der Server die Versionsnummer jeder Clientanwendung, die zum Anmelden verwendet wird. Der Zugriff wird anschließend basierend auf der entsprechenden Clientversionsrichtlinie zugelassen oder verweigert. Weist die Eigenschaft "Enabled" den Wert "False" auf, kann sich jede anmeldefähige Clientanwendung anmelden.

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

Boolescher Wert

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

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration-Objekt. Set-CsClientVersionConfiguration akzeptiert weitergeleitete Instanzen des Konfigurationsobjekts für Clientversionen.

Rückgabetypen

Set-CsClientVersionConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration" konfiguriert.

Beispiel

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

Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False

In Beispiel 1 wird Set-CsClientVersionConfiguration zum Ändern der Auflistung von Einstellungen mit der Identität "site:Redmond" verwendet. In diesem Fall wird der Parameter "Enabled" auf "False" festgelegt, um die Konfigurationseinstellungen für Clientversionen zu deaktivieren.

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

Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"

Im vorstehenden Beispiel wird die Eigenschaft "DefaultUrl" für alle gegenwärtig in der Organisation verwendeten Konfigurationseinstellungen für Clientversionen geändert. Hierzu ruft der Befehl zunächst Get-CsClientVersionConfiguration ohne zusätzliche Parameter auf, um sämtliche Konfigurationseinstellungen für Clientversionen zurückzugeben. Diese Informationen werden an das Cmdlet Set-CsClientVersionConfiguration weitergeleitet, das den Wert von "DefaultUrl" für jede Konfigurationsauflistung auf "https://litwareinc.com/csclients" setzt.

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

Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"

In Beispiel 3 werden alle Konfigurationseinstellungen für Clientversionen geändert, deren Eigenschaft "DefaultAction" gegenwärtig auf "Block" festgelegt ist. Dazu ruft der Befehl zunächst Get-CsClientVersionConfiguration auf, um eine Auflistung aller derzeit verwendeten Konfigurationseinstellungen für Clientversionen zurückzugeben. Diese Informationen werden an das Cmdlet Where-Object weitergeleitet, das die Einträge herausfiltert, bei denen die Eigenschaft "DefaultAction" den Wert "Block" aufweist. Diese gefilterte Auflistung wiederum wird an das Cmdlet Set-CsClientVersionConfiguration weitergeleitet, das für jedes Element in der Auflistung zwei Aktionen ausführt: 1) Festlegen von "DefaultAction" auf "BlockWithUrl" und 2) Festlegen von "DefaultUrl" auf "https://litwareinc.com/csclients".