Freigeben über

  • Artikel

Remove-CsClientVersionPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt die angegebene Clientversionsrichtlinie. Mit Clientversionsrichtlinien können Sie festlegen, welche Clients (z. B. Microsoft Office Communicator 2007 R2) sich bei Ihrem Microsoft Lync Server 2010-System anmelden können.

Syntax

Remove-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Clientversionsrichtlinien repräsentieren eine Sammlung von Clientversionsregeln, mit deren Hilfe ermittelt wird, welche Clientanwendungen sich bei 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 im SIP-Header werden mit einer Auflistung von Clientversionsregeln verglichen, um herauszufinden, ob für diese spezielle Anwendung Regeln gelten. Ist eine solche Regel vorhanden, führt Lync Server 2010 die in der Regel angegebene Aktion aus. Die Regel kann Lync Server 2010 beispielsweise anweisen, die Anmeldung zuzulassen, die Anmeldung zu blockieren oder die Anmeldung zuzulassen, aber anschließend ein unbeaufsichtigtes Upgrade der Clientanwendung auf die neueste Version durchzuführen (beispielsweise ein Upgrade von Communicator 2007 R2 auf Microsoft Lync 2010).

Clientversionsrichtlinien – die global, auf Standortebene, auf Dienstebene (nur Registrierungsdienst) oder für individuelle Benutzer angewendet werden können – bieten Flexibilität bei der Bestimmung, welche Clientanwendungen für den Zugriff auf das System verwendet werden können. Sie könnten z. B. generell festlegen, dass Benutzer sich nicht mit Communicator 2007 R2 bei Lync Server 2010 anmelden, da Communicator 2007 R2 nicht dieselben Funktionen unterstützt wie Lync 2010. Es könnte jedoch möglich sein, dass verschiedene Benutzer aufgrund von Hardware- oder Softwarekonflikten kein Upgrade auf Lync 2010 ausführen können. In diesem Fall können Sie eine separate Regel sowie eine separate Clientversionsrichtlinie erstellen, die es diesen Benutzern ermöglicht, sich über Communicator 2007 R2 anzumelden.

Mit dem Cmdlet New-CsClientVersionPolicy können Sie neue Richtlinien erstellen. Diese benutzerdefinierten Richtlinien können später mit dem Cmdlet Remove-CsClientVersionPolicy entfernt werden. Wenn Sie eine Clientversionsrichtlinie entfernen, erben Benutzer, für die zuvor diese Richtlinie angewendet wurde, automatisch die nächste Richtlinie in der Verwaltungshierarchie. Wenn Sie z. B. eine benutzerbasierte Richtlinie löschen, gilt für die Benutzer automatisch die entsprechende Dienstrichtlinie. Wenn keine Dienstrichtlinie vorhanden ist, wird die entsprechende Standortrichtlinie auf die Benutzer angewendet. Wenn keine Standortrichtlinie vorhanden ist, gilt die globale Richtlinie.

Beachten Sie, dass immer eine globale Richtlinie vorhanden ist und daher immer eine Clientversionsrichtlinie auf die Benutzer angewendet wird. Wenngleich Remove-CsClientVersionPolicy für die globale Richtlinie ausgeführt werden kann, wird die Richtlinie nicht wirklich gelöscht. Stattdessen werden alle Richtlinienregeln auf ihre Standardwerte zurückgesetzt.

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-CsClientVersionPolicy 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-CsClientVersionPolicy\b"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu löschende Richtlinie. Verwenden Sie eine Syntax wie die folgende, um eine auf Standortebene konfigurierte Richtlinie zu entfernen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um eine auf Dienstebene konfigurierte Richtlinie zu entfernen: -Identity "Registrar:atl-cs-001.litwareinc.com". Der Registrierungsdienst ist der einzige Dienst, der eine Clientversionsrichtlinie hosten kann.

Richtlinien können auch für individuelle Benutzer entfernt werden. Verwenden Sie eine Syntax wie die folgende, um benutzerbasierte Richtlinien zu entfernen: -Identity "SalesDepartmentPolicy".

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.ClientVersionPolicy-Objekt. Remove-CsClientVersionPolicy akzeptiert weitergeleitete Instanzen des Objekts für Clientversionsrichtlinien.

Rückgabetypen

Mit Remove-CsClientVersionPolicy werden vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy" gelöscht.

Beispiel

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

Remove-CsClientVersionPolicy -Identity site:Redmond

Der Befehl in Beispiel 1 löscht die Clientversionsrichtlinie für den Standort "Redmond".

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

Get-CsClientVersionPolicy -Filter tag:* | Remove-CsClientVersionPolicy

In Beispiel 2 werden alle Clientversionsrichtlinien gelöscht, die auf Benutzerbasis konfiguriert wurden. Hierzu ruft der Befehl zunächst Get-CsClientVersionPolicy mit dem Parameter "Filter" auf. Der Filterwert "tag:*" schränkt die zurückgegebenen Daten auf Richtlinien ein, die auf Benutzerebene konfiguriert wurden. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsClientVersionPolicy weitergeleitet, das alle Elemente in der Auflistung löscht.