New-CsClientPolicyEntry

Syntax

New-CsClientPolicyEntry -Name <String> -Value <String>

Detaillierte Beschreibung

Clientrichtlinien dienen für Lync Server 2010 als primärer Mechanismus zum Verwalten von Clientsoftware wie Microsoft Lync 2010. Beim Erstellen oder Konfigurieren einer Clientrichtlinie stehen Ihnen zahlreiche Optionen zur Verfügung. Sie können beispielsweise angeben, ob Fotos in Lync 2010 verwendet werden sollen, ob Emoticons in Sofortnachrichten zulässig sind und ob Lync 2010 automatisch Aufzeichnungen von Instant Messaging-Sitzungen speichert. Diese Optionen decken viele der clientbezogenen Einstellungen ab, die von Administratoren verwaltet werden müssen.

Einige der zu verwaltenden Clienteinstellungen können jedoch fehlen. Um die Verwaltung noch flexibler und umfassender zu gestalten, ist in Clientrichtlinien eine Eigenschaft namens "PolicyEntry" enthalten. Diese mehrwertige Eigenschaft ermöglicht es Administratoren, neue Verwaltungsoptionen hinzuzufügen, die in Clientrichtlinien nicht explizit aufgerufen werden. Vor der Veröffentlichung von Lync Server war es Beta-Testern beispielsweise möglich, Lync 2010 eine Feedbackoption hinzuzufügen. Diese Option wurde als neuer Richtlinieneintrag hinzugefügt und mit New-CsClientPolicyEntry erstellt.

Beachten Sie, dass Sie nicht willkürlich neue Richtlinieneinträge erstellen können, um Lync 2010 oder andere Clientanwendungen zu verwalten. Stattdessen müssen Sie auf eine offizielle Benachrichtigung von Microsoft hinsichtlich der Namen und Werte warten, die zum Erstellen neuer Clientrichtlinieneinträge verwendet werden können.

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

Parameter

Eingabetypen

Keine. New-CsClientPolicyEntry akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsClientPolicyEntry werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Client.PolicyEntryType" erstellt.

Beispiel

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

$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"

$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.Add($x)

Set-CsClientPolicy -Instance $y

Die Befehle in Beispiel 1 zeigen, wie der globalen Clientrichtlinie ein neuer Richtlinieneintrag hinzugefügt werden kann. In dem Beispiel wird Lync 2010 eine neue Feedbackoption hinzugefügt. Dieses Beispiel dient ausschließlich zu Demonstrationszwecken. Sie sollten nicht erwarten, dass Sie diese Befehle ausführen und Ihrer Version von Lync 2010 eine ähnliche Feedbackoption hinzufügen können.

Um den neuen Richtlinieneintrag hinzuzufügen, wird mit dem ersten Befehl im Beispiel mit New-CsClientPolicyEntry ein Eintrag mit dem Namen "OnlineFeedbackURL" und dem Wert "http://www.litwareinc.com/feedback" erstellt. Das resultierende Richtlinieneintragsobjekt wird in der Variablen "$x" gespeichert.

Im zweiten Befehl wird mit Get-CsClientPolicy ein Objektverweis ($y) auf die globale Clientrichtlinie erstellt. Nachdem der Objektverweis erstellt wurde, wird der neue Richtlinieneintrag mit der Add-Methode der Eigenschaft "PolicyEntry" hinzugefügt. Falls "PolicyEntry" bereits einen oder mehrere Einträge hat, wird der neue Wert einfach an das Ende dieser Auflistung angehängt.

Anschließend schreibt der letzte Befehl die Änderungen mit Set-CsClientPolicy in die eigentliche globale Richtlinie. Wenn Sie Set-CsClientPolicy nicht aufrufen, sind die Änderungen nur im Arbeitsspeicher vorhanden und gehen verloren, sobald Sie Windows PowerShell beenden oder die Variable "$x" löschen.

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

$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
Set-CsClientPolicy -Identity global -PolicyEntry $x

Beispiel 2 ist eine Variante der Befehle in Beispiel 1. In diesem Fall werden jedoch alle Einträge, die derzeit in der Eigenschaft "PolicyEntry" der globalen Richtlinie vorhanden sind, durch den neuen Richtlinieneintrag ersetzt. Hierzu wird mit dem ersten Befehl im Beispiel ein neuer Richtlinieneintrag erstellt, der in der Variablen "$x" gespeichert wird. Der zweite Befehl legt dann den Wert der Eigenschaft "PolicyEntry" mit Set-CsClientPolicy auf "$x" fest. Nachdem der Befehl ausgeführt wurde, ist der neue Eintrag der einzige Eintrag in der Eigenschaft "PolicyEntry". Alle Elemente, die sich vor dem Aufrufen von Set-CsClientPolicy in dieser Eigenschaft befanden, wurden durch den neuen Eintrag ersetzt.

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

$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.RemoveAt(0)

Set-CsClientPolicy -Instance $y 

Beispiel 3 zeigt, wie Sie einen Clientrichtlinieneintrag aus der globalen Richtlinie entfernen können. Hierzu wird mit dem ersten Befehl im Beispiel die globale Clientrichtlinie abgerufen, und diese Informationen werden in der Variablen "$y" gespeichert.

Sobald die globale Richtlinie abgerufen wurde, verwendet der zweite Befehl im Beispiel die RemoveAt()-Methode, um den ersten Richtlinieneintrag in dieser Richtlinie zu löschen. Der zu entfernende Richtlinieneintrag wird durch eine Indexnummer gekennzeichnet: Der erste Richtlinieneintrag weist die Indexnummer 0 auf, der zweite Eintrag hat die Indexnummer 1 usw. Eine Syntax der folgenden Art gibt an, dass der erste Richtlinieneintrag entfernt wird: RemoveAt(0).

Sobald der Richtlinieneintrag aus der arbeitsspeicherinternen Instanz der globalen Richtlinie entfernt wurde, wird das Cmdlet Set-CsClientPolicy aufgerufen, um diese Änderungen in die tatsächliche Instanz der globalen Clientrichtlinie zu schreiben.

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

Set-CsClientPolicy -Identity global -PolicyEntry $Null

Der Befehl in Beispiel 4 entfernt alle Clientrichtlinieneinträge, die für die globale Richtlinie konfiguriert wurden. Hierzu wird der Parameter "PolicyEntry" verwendet, dessen Parameterwert auf Null ($Null) festgelegt wird.

Siehe auch

Weitere Ressourcen

New-CsClientPolicy
Set-CsClientPolicy