• Artikel

Remove-CsClientPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine bestehende Clientrichtlinie. Clientrichtlinien dienen u. a. zum Bestimmen der Funktionen von Microsoft Lync 2010, die Benutzern zur Verfügung gestellt werden. Sie können beispielsweise einigen Benutzern die Berechtigung zum Übertragen von Dateien erteilen, während sie anderen diese Berechtigung verweigern.

Syntax

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

Detaillierte Beschreibung

In Lync Server 2010 ersetzen Clientrichtlinien die Gruppenrichtlinieneinstellungen, die in früheren Versionen des Produkts verwendet wurden. In Microsoft Office Communicator 2007 und Microsoft Office Communicator 2007 R2 dienten Gruppenrichtlinien zum Festlegen, welche Aufgaben Benutzer mit Communicator und anderen Clients erledigen konnten. Es gab beispielsweise Gruppenrichtlinieneinstellungen, die festlegten, ob Benutzer eine Aufzeichnung ihrer Sofortnachrichtensitzungen speichern, Informationen aus Microsoft Outlook in ihre Anwesenheitsinformationen integrieren und Emoticons oder formatierten Text in Sofortnachrichten einfügen konnten oder nicht.

Doch obwohl Gruppenrichtlinien sehr nützlich sind, weist diese Technologie bei Verwendung mit Lync Server 2010 einige Einschränkungen auf. Gruppenrichtlinien wurden zum einen für eine domänen- oder OU-basierte Nutzung konzipiert, sodass sie nur schwer einer gezielten Benutzergruppe zugewiesen werden können (z. B. allen Benutzern in einer bestimmten Abteilung oder mit einer bestimmten Position). Zum anderen gelten Gruppenrichtlinien nur für Benutzer, die sich bei der Domäne und über einen Computer anmelden. Gruppenrichtlinien gelten nicht für Benutzer, die auf Lync Server 2010 über das Internet oder ein Mobiltelefon zugreifen. Dies bedeutet, dass demselben Benutzer, abhängig davon, mit welchem Gerät und wo er sich anmeldet, eine unterschiedliche Umgebung angezeigt werden kann.

Um diese Inkonsistenzen zu beseitigen, werden in Lync Server 2010 anstelle von Gruppenrichtlinien Clientverwaltungsrichtlinien verwendet. Clientrichtlinien gelten, sobald ein Benutzer auf das System zugreift, und zwar unabhängig davon, wo oder mit welchem Gerät die Anmeldung erfolgt. Zusätzlich können Clientrichtlinien, wie andere Lync Server 2010-Richtlinien, problemlos auf ausgewählte Benutzergruppen angewendet werden. Sie können sogar benutzerdefinierte Richtlinien erstellen, die einzelnen Benutzern zugewiesen werden.

Clientrichtlinien können global, auf Standortebene und auf Benutzerebene konfiguriert werden. Auf Standortebene oder Benutzerbasis konfigurierte Richtlinien können später mit dem Cmdlet Remove-CsClientPolicy gelöscht werden. Sie können das Cmdlet Remove-CsClientPolicy auch für globale Richtlinien ausführen. In diesem Fall wird die globale Richtlinie jedoch nicht entfernt, da globale Richtlinien nicht gelöscht werden können. Vielmehr werden alle Eigenschaften in der globalen Richtlinie 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-CsClientPolicy 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-CsClientPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die zu entfernende Clientrichtlinie. Verwenden Sie die folgende Syntax, um die globale Richtlinie zu "entfernen": -Identity global. (Beachten Sie, dass die globale Richtlinie nicht wirklich entfernt werden kann. Stattdessen werden alle Eigenschaften in dieser Richtlinie auf die Standardwerte zurückgesetzt.) Verwenden Sie eine Syntax wie die folgende, um eine Standortrichtlinie zu entfernen: -Identity "site:Redmond". Verwenden Sie eine Syntax wie die folgende, um eine benutzerbasierte Richtlinie zu entfernen: -Identity "SalesDepartmentPolicy". Sie können beim Angeben einer Richtlinienidentität keine Platzhalter verwenden.

Force

Optional

Switch-Parameter

Wenn dieser Parameter angegeben wurde, wird die Richtlinie automatisch und selbst dann entfernt, wenn sie mindestens einem Benutzer zugewiesen ist. Wenn dieser Parameter nicht angegeben wurde, wird eine benutzerbasierte Richtlinie, die mindestens einem Benutzer zugewiesen ist, nicht automatisch mit Remove-CsClientPolicy entfernt. Es wird stattdessen eine Bestätigungsaufforderung angezeigt, um das Entfernen der Richtlinie zu bestätigen. Antworten Sie mit "Ja" (indem Sie auf die Taste "Y" für "Yes" drücken), um die Richtlinie zu entfernen.

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.Client.ClientPolicy-Objekt. Remove-CsClientPolicy akzeptiert weitergeleitete Instanzen von Clientrichtlinienobjekten.

Rückgabetypen

Remove-CsClientPolicy gibt keinen Wert zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy" gelöscht.

Beispiel

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

Remove-CsClientPolicy -Identity SalesPolicy

In Beispiel 1 wird mit Remove-CsClientPolicy die Clientrichtlinie mit dem Identitätswert "SalesPolicy" gelöscht.

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

Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy

In Beispiel 2 werden mit Get-CsClientPolicy und Remove-CsClientPolicy alle Clientrichtlinien gelöscht, die auf Benutzerbasis konfiguriert wurden. Der Befehl verwendet Get-CsClientPolicy und den Parameter "Filter", um eine Auflistung aller auf Benutzerbasis konfigurierten Clientrichtlinien zurückzugeben. Der Filterwert "tag:*" weist Get-CsClientPolicy an, die abgerufenen Daten auf Clientrichtlinien zu beschränken, deren Identitätswert mit der Zeichenfolge "tag:" beginnt. Die gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsClientPolicy weitergeleitet, das alle Richtlinien in der Auflistung löscht.

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

Get-CsClientPolicy | Where-Object {$_.EnableAppearOffline -eq $True} | Remove-CsClientPolicy

Mit dem vorstehenden Befehl werden alle Clientrichtlinien gelöscht, bei denen die Eigenschaft "EnableAppearOffline" den Wert "True" aufweist. Hierzu wird zunächst Get-CsClientPolicy ohne zusätzliche Parameter aufgerufen. Dadurch wird eine Auflistung aller Clientrichtlinien zurückgegeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das nur die Richtlinien herausfiltert, bei denen die Eigenschaft "EnableAppearOffline" den Wert "True" aufweist. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsClientPolicy weitergeleitet, das jede Richtlinie in der Auflistung entfernt.