Freigeben über

  • Artikel

Remove-CsClientVersionConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt 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

Remove-CsClientVersionConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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. Zusätzlich zu den globalen Einstellungen können Konfigurationseinstellungen für die Clientversion auch auf Standortebene angewendet werden.

Sämtliche der erstellten standortbasierten Einstellungen können später mit dem Cmdlet Remove-CsClientVersionConfiguration wieder gelöscht werden. Beachten Sie, dass Sie das Cmdlet Remove-CsClientVersionConfiguration auch für die globalen Einstellungen ausführen können. In diesem Fall werden die globalen Einstellungen nicht entfernt. Stattdessen werden die globalen Eigenschaften auf ihre Standardwerte zurückgesetzt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsClientVersionConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID der Auflistung von zu entfernenden Konfigurationseinstellungen für Clientversionen. Verwenden Sie folgende Syntax, um die globale Auflistung zu entfernen: -Identity global. (Beachten Sie, dass die globalen Einstellungen nicht wirklich entfernt werden. Stattdessen werden die globalen Eigenschaften auf ihre Standardwerte zurückgesetzt.) Verwenden Sie eine Syntax wie die folgende, um eine Standortauflistung zu entfernen: -Identity site:Redmond. Beachten Sie, dass beim Angeben des Identitätswerts keine Platzhalterzeichen verwendet werden können.

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.ClientVersionConfiguration-Objekt. Remove-CsClientVersionConfiguration akzeptiert weitergeleitete Instanzen des Konfigurationsobjekts für die Clientversion.

Rückgabetypen

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

Beispiel

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

Remove-CsClientVersionConfiguration -Identity site:Redmond

Der Befehl in Beispiel 1 löscht die Konfigurationseinstellungen für Clientversionen mit dem Identitätswert "site:Redmond".

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

Get-CsClientVersionConfiguration -Filter site:* | Remove-CsClientVersionConfiguration

In Beispiel 2 werden alle Konfigurationseinstellungen für Clientversionen gelöscht, die auf Standortebene zugewiesen wurden. Hierzu ruft der Befehl zunächst Get-CsClientVersionConfiguration mit dem Parameter "Filter" auf. Mit dem Filterwert "site:*" wird sichergestellt, dass nur die Konfigurationseinstellungen für Clientversionen ausgewählt werden, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsClientVersionConfiguration weitergeleitet, um sämtliche Elemente in der Auflistung zu löschen.

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

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

Im vorstehenden Befehl werden alle Konfigurationseinstellungen für Clientversionen gelöscht, die derzeit deaktiviert sind. Hierzu gibt der Befehl zunächst mit Get-CsClientVersionConfiguration eine Auflistung aller derzeit in der Organisation verwendeten Konfigurationseinstellungen für Clientversionen zurück. Nachdem die Daten zurückgegeben wurden, wird die Auflistung an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an Remove-CsClientVersionConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.