Freigeben über

  • Artikel

Get-CsClientVersionPolicyRule

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt die zur Verwendung in Ihrer Organisation konfigurierten Regeln für Clientversionsrichtlinien zurück.

Syntax

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

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

Detaillierte Beschreibung

Mithilfe von Clientversionsregeln wird festgelegt, welche Clientanwendungen sich bei Microsoft 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 werden mit einer Auflistung von Clientversionsregeln verglichen, um herauszufinden, ob Regeln für diese spezifische Anwendung gelten. Angenommen, ein Benutzer versucht, sich über Microsoft Office Communicator 2007 R2 anzumelden. Bevor sich der Benutzer bei Lync Server 2010 anmelden kann, prüft das System, ob eine Clientversionsregel für Office Communicator 2007 R2 vorliegt. Ist eine Regel vorhanden, führt Lync Server 2010 die in der Regel angegebene Aktion aus. Folgende Aktionen sind möglich:

Allow. Der Benutzer kann sich anmelden.

AllowAndUpgrade. Der Benutzer kann sich anmelden, und seine Kopie von Communicator 2007 R2 wird automatisch auf die aktuelle Version von Lync aktualisiert. Upgrades werden in Abhängigkeit von der Konfiguration Ihres Systems entweder mit Microsoft Update oder Windows Server Update Services ausgeführt.

AllowWithUrl. Der Benutzer kann sich anmelden und wird in einer Meldung auf eine URL hingewiesen, über die die aktuelle Version von Lync heruntergeladen und installiert werden kann. Die URL muss auf eine Website verweisen, die Sie selbst erstellt haben. Bei der Installation von Lync Server wird keine solche Site für Sie erstellt.

Block. Der Benutzer kann sich nicht anmelden.

BlockAndUpgrade. Der Benutzer kann sich nicht anmelden, aber seine Kopie von Communicator 2007 R2 wird automatisch auf die aktuelle Version von Lync aktualisiert. Der Benutzer kann dann versuchen, sich mit der neuen Clientanwendung anzumelden. Upgrades werden in Abhängigkeit von der Konfiguration Ihres Systems entweder mit Microsoft Update oder Windows Server Update Services ausgeführt.

BlockWithUrl. Der Benutzer kann sich nicht anmelden, wird jedoch in einer Meldung auf eine URL hingewiesen, über die die aktuelle Version von Lync heruntergeladen und installiert werden kann. Die URL muss auf eine Website verweisen, die Sie selbst erstellt haben. Bei der Installation von Lync Server wird keine solche Site für Sie erstellt.

Clientversionsregeln werden in Clientversionsrichtlinien zusammengefasst. Diese Richtlinien können global, auf Standortebene, auf Dienstebene (Registrierungsdienst) oder auf Benutzerebene konfiguriert werden. Mit dem Cmdlet Get-CsClientVersionPolicyRule können Administratoren ausführliche Informationen zu jeder zur Verwendung in ihrer Organisation konfigurierten Richtlinienregel anzeigen.

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-CsClientVersionPolicyRule 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-CsClientVersionPolicyRule"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID für die abzurufende Clientversion-Richtlinienregel. Der Identitätswert einer Clientversionsregel besteht aus dem Gültigkeitsbereich, für den die Regel konfiguriert wurde, sowie einer GUID (Globally Unique Identifier). Eine Regel hat somit etwa folgenden Identitätswert: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83. Da GUIDS schwer zu merken und zu handhaben sind, werden in diesem Hilfethema im Abschnitt "Beispiele" alternative Methoden zum Identifizieren der zurückzugebenden Regeln aufgeführt.

Wenn dieser Parameter nicht angegeben ist, werden alle zur Verwendung konfigurierten Regeln für Clientversionsrichtlinien zurückgegeben.

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Regeln für Clientversionsrichtlinien. Verwenden Sie beispielsweise folgende Syntax, um alle für den Standort "Redmond" konfigurierten Regeln zurückzugeben: -Filter "site:Redmond/*".

Sie können die Parameter "Filter" und "Identity" nicht in demselben Befehl verwenden.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsClientVersionPolicyRule akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

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

Beispiel

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

Get-CsClientVersionPolicyRule

In Beispiel 1 werden Informationen zu allen derzeit in der Organisation verwendeten Regeln für Clientversionsrichtlinien zurückgegeben.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

In Beispiel 2 werden Informationen zu einer einzelnen Regel für Clientversionsrichtlinien zurückgegeben: der Regel mit dem Identitätswert "Global/2336c611-a243-4c5d-994b-eea8a524d0e4".

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

Der vorstehende Befehl gibt alle auf der globalen Ebene konfigurierten Regeln für Clientversionsrichtlinien zurück. Dazu verwendet der Befehl den Parameter "Filter" und den Filterwert "Global/*". Mit dem Filterwert werden nur die Regeln zurückgegeben, deren Identitätswert mit dem Zeichenfolgenwert "Global/" beginnt.

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

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

Der Befehl in Beispiel 4 gibt alle derzeit deaktivierten Regeln für Clientversionsrichtlinien zurück. Hierzu ruft der Befehl zunächst Get-CsClientVersionPolicy auf, um eine Auflistung aller verfügbaren Clientrichtlinienregeln zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Regeln herausfiltert, bei denen die Eigenschaft "Enabled " den Wert "False" aufweist.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "Block"}

Der vorstehende Befehl gibt alle Regeln für Clientversionsrichtlinien zurück, die die Anmeldung einer Clientanwendung verhindern. Hierzu ruft der Befehl zunächst Get-CsClientVersionPolicy ohne Parameter auf. Damit wird eine Auflistung aller derzeit verwendeten Regeln zurückgegeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Regeln auswählt, bei denen die Eigenschaft "Action" den Wert "Block" aufweist.