Freigeben über

  • Artikel

Remove-CsClientVersionPolicyRule

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine oder mehrere Regeln für Clientversionsrichtlinien, die zur Verwendung in Ihrer Organisation konfiguriert sind.

Syntax

Remove-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 anmelden kann, prüft das System, ob eine Clientversionsregel für Office Communicator 2007 R2 vorliegt. Ist eine solche 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 gesammelt, die global, auf Standortebene, auf Dienstebene (Registrierungsdienst) oder auf Benutzerebene konfiguriert werden können. Mit dem Cmdlet Remove-CsClientVersionPolicyRule können einzelne oder mehrere Clientrichtlinienregeln entfernt werden, die zur Verwendung in der Organisation konfiguriert sind. Diese Regeln können aus sämtlichen Clientversionsrichtlinien (einschließlich der globalen Richtlinie) entfernt werden.

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 dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsClientVersionPolicyRule 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 "Remove-CsClientVersionPolicyRule"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernende Regel für Clientversionsrichtlinien. 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.

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

Switch-Parameter

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

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule-Objekt. Remove-CsClientVersionPolicyRule akzeptiert weitergeleitete Instanzen des Objekts für Clientversionsregeln.

Rückgabetypen

Keine. Stattdessen werden mit dem Cmdlet Remove-CsClientVersionPolicyRule Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule" gelöscht.

Beispiel

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

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

Mit dem Befehl in Beispiel 1 wird die Regel für Clientversionsrichtlinien mit dem Identitätswert "site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820" gelöscht. Da Identitätswerte eindeutig sein müssen, wird mit diesen Befehl maximal eine Regel gelöscht.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

Im vorstehenden Befehl werden alle für den Standort "Redmond" konfigurierten Regeln für Clientversionsrichtlinien gelöscht. Hierzu ruft der Befehl zunächst Get-CsClientVersionPolicyRule zusammen mit dem Parameter "Filter" auf. Der Filterwert "site:Redmond/*" beschränkt die zurückgegebenen Daten auf Richtlinienregeln, deren Identität mit dem Zeichenfolgenwert "site:Redmond/" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsClientVersionPolicyRule weitergeleitet, das jedes Element in der Auflistung löscht.

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

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

In Beispiel 3 werden alle gegenwärtig deaktivierten Regeln für Clientversionsrichtlinien gelöscht. Hierzu ruft der Befehl zunächst Get-CsClientVersionPolicyRule ohne Parameter auf, um eine Auflistung aller derzeit in der Organisation verwendeten Richtlinienregeln 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. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsClientVersionPolicyRule weitergeleitet, das jedes Element in der Auflistung löscht.