Freigeben über

  • Artikel

New-CsClientVersionConfiguration

 

Letztes Änderungsdatum des Themas: 2012-05-21

Erstellt eine neue 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

New-CsClientVersionConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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.

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.

Neben den globalen Einstellungen können Sie mit dem Cmdlet New-CsClientVersionConfiguration Konfigurationseinstellungen für Clientversionen auf Standortebene erstellen. Auf Standortebene angewendete Konfigurationseinstellungen für Clientversionen haben Vorrang vor den globalen Einstellungen. Nehmen Sie beispielsweise an, Sie haben Clientversionsfilter auf globaler Ebene aktiviert und erstellen dann eine separate Auflistung von Einstellungen für den Standort Redmond, bei der Clientversionsfilter deaktiviert sind. In diesem Fall sind Clientversionsfilter für alle Benutzer deaktiviert, die über ein Konto am Standort Redmond verfügen.

Beachten Sie jedoch, dass für anonyme Benutzer nur globale Einstellungen gelten, denn anonyme Benutzer sind keinem Standort zugeordnet.

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 New-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 "New-CsClientVersionConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Stellt die eindeutige ID dar, die der neuen Auflistung von Konfigurationseinstellungen für Clientversionen zugewiesen werden soll. Da Sie neue Auflistungen nur auf Standortebene erstellen können, weist der Identitätswert immer das Präfix "site:" auf, gefolgt vom Standortnamen, z. B. "site:Redmond". Beachten Sie, dass bei dem vorstehenden Befehl ein Fehler auftritt, wenn bereits eine Auflistung von Einstellungen mit dem Identitätswert "site:Redmond" vorhanden ist.

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. Darüber hinaus wird eine Meldung angezeigt, die die URL einer Webseite enthält, 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" festgelegt 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" festgelegt, wird diese URL im Meldungsfenster "Access denied" angezeigt, das jedes Mal geöffnet 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" den Wert "True" aufweist, überprüft der Server die Versionsnummer jeder Clientanwendung, die einen Anmeldeversuch unternimmt. Auf der Grundlage der entsprechenden Clientversionsrichtlinie erlaubt oder verweigert der Server dann den Zugriff. Weist die Eigenschaft "Enabled" den Wert "False" auf, kann sich jede anmeldefähige Clientanwendung anmelden.

Der Standardwert lautet "True".

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

WhatIf

Optional

Switch-Parameter

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

Confirm

Optional

Switch-Parameter

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

Eingabetypen

Keine. New-CsClientVersionConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration".

Beispiel

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

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

Der Befehl in Beispiel 1 erstellt eine neue Auflistung von Konfigurationseinstellungen für Clientversionen für den Standort Redmond. In diesem Befehl wird der Parameter "Enabled" auf "False" festgelegt, d. h., Clientfilter werden für den Standort "Redmond" deaktiviert.

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

$x = New-CsClientVersionConfiguration -Identity site:Redmond -InMemory
$x.DefaultAction = "Block" 
Set-CsClientVersionConfiguration -Instance $x

Beispiel 2 zeigt, wie Sie eine neue Auflistung von Konfigurationseinstellungen für Clientversionen im Arbeitsspeicher erstellen und ändern können und diese virtuellen Einstellungen dann in eine tatsächliche Auflistung von Einstellungen für den Standort Redmond umwandeln. Dazu verwendet der erste Befehl New-CsClientVersionConfiguration und den Parameter "InMemory", um eine Auflistung von Einstellungen mit dem Identitätswert "site:Redmond" zu erstellen, die nur im Arbeitsspeicher vorhanden ist. Diese Auflistung wird in der Variablen "$x" gespeichert und ist nur im Arbeitsspeicher vorhanden. Wenn Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen, gehen diese Konfigurationseinstellungen für Clientversionen verloren und werden niemals auf den Standort "Redmond" angewendet.

In Befehl 2 wird der Wert der Eigenschaft "DefaultAction" für die virtuellen Einstellungen auf "Block" festgelegt. In Befehl 3 werden die virtuellen Einstellungen dann mit dem Cmdlet Set-CsClientVersionConfiguration in eine tatsächliche Auflistung von Konfigurationseinstellungen für Clientversionen umgewandelt, die auf den Standort "Redmond" angewendet werden.