• Artikel

Remove-CsDeviceUpdateRule

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine Geräteaktualisierungsrichtlinie, die für die Verwendung in Ihrer Organisation konfiguriert wurde. Geräteaktualisierungsregeln werden dazu verwendet, Firmwareupdates Geräten zuzuordnen, auf denen Microsoft Lync 2010 Phone Edition ausgeführt wird.

Syntax

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

Detaillierte Beschreibung

Microsoft Lync Server 2010 verwendet Geräteaktualisierungsregeln, um Firmwareupdates für Geräte bereitzustellen, auf denen Lync 2010 Phone Edition ausgeführt wird. Administratoren laden von Zeit zu Zeit Geräteaktualisierungsregeln nach Lync Server 2010 hoch. Nachdem diese getestet und genehmigt wurden, werden sie automatisch heruntergeladen und den entsprechenden Geräten zugewiesen, sobald diese eine Verbindung mit dem System herstellen. Geräte führen standardmäßig nach dem Einschalten und Herstellen einer Verbindung mit Lync Server eine Überprüfung auf neue Geräteaktualisierungsregeln durch. Alle 24 Stunden nach der anfänglichen Anmeldung wird ebenfalls eine Überprüfung auf neue Geräteaktualisierungsregeln durchgeführt.

Administratoren können keine eigenen Geräteaktualisierungsregeln erstellen; Aktualisierungsregeln können nur durch Herunterladen und Importieren von Regelsätzen von der Microsoft-Website erstellt werden. Dies bedeutet, dass sich wahrscheinlich im Laufe der Zeit Regeln ansammeln, die nicht mehr auf dem neuesten Stand sind oder nicht für Ihre Organisation geeignet sind. (Wenn Ihre Organisation beispielsweise keine Telefone von LG-Nortel mehr verwendet, benötigen Sie auch keine Firmwareupdates für diese Geräte.) Auch wenn diese nicht benötigten Regeln keine Probleme verursachen, können sie die Verwaltung unnötig kompliziert machen: Es kann verwirrend sein, mit dem Cmdlet Get-CsDeviceUpdateRule eine Auflistung aller Geräteaktualisierungsregeln abzurufen, nur um feststellen zu müssen, dass viele dieser Regeln nicht für Ihre Organisation geeignet sind. Das Cmdlet Remove-CsDeviceUpdateRule schafft Klarheit, da mit diesem Cmdlet alle Geräteaktualisierungsregeln (oder Regelsätze) entfernt werden können, die für die Verwendung importiert wurden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eindeutige ID für die Geräteaktualisierungsregel. Der Identitätswert einer Geräteaktualisierungsregel besteht aus zwei Teilen: der Dienstebene, auf der die Regel angewendet wurde (z. B. "service:WebServer:atl-cs-001.litwareinc.com"), und der GUID (Globally Unique Identifier), die der Regel vorab zugewiesen wurde (z. B. d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). Demnach lautet der Identitätswert einer Geräteaktualisierungsregel in etwa wie folgt: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Die Verwendung von Platzhaltern ist bei der Eingabe eines Identitätswerts nicht zulässig.

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.Settings.DeviceUpdate.DeviceUpdate.Rule-Objekt. Remove-CsDeviceUpdateRule akzeptiert weitergeleitete Instanzen des Objekts für Geräteaktualisierungsregeln.

Rückgabetypen

Remove-CsDeviceUpdateRule gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule" gelöscht.

Beispiel

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

Remove-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

Mit dem vorstehenden Befehl wird die Geräteaktualisierungsregel mit dem Identitätswert "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9" gelöscht. Nachdem die Regel gelöscht wurde, steht das entsprechende Firmwareupdate nicht länger zur Verfügung.

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

Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule

Der Befehl in Beispiel 2 entfernt alle Geräteaktualisierungsregeln, die für die Verwendung in Ihrer Organisation konfiguriert wurden. Hierzu wird zunächst Get-CsDeviceUpdateRule ohne Parameter aufgerufen, um eine Auflistung aller derzeit in der Organisation verwendeten Geräteaktualisierungsregeln zurückzugeben. Diese Auflistung wird dann an das Cmdlet Remove-CsDeviceUpdateRule weitergeleitet, das jedes Element in der Auflistung löscht.

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

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Remove-CsDeviceUpdateRule

In Beispiel 3 werden alle in den Dienst "WebServer:atl-cs-001.litwareinc.com" importierten Geräteaktualisierungsregeln entfernt. Hierzu ruft der Befehl zunächst mit Get-CsDeviceUpdateRule und dem Parameter "Filter" alle Geräteaktualisierungsregeln ab, die über einen Identitätswert verfügen, der mit dem Zeichenfolgenwert "service:WebServer:atl-cs-001.litwareinc.com" beginnt. Diese Auflistung wird dann an das Cmdlet Remove-CsDeviceUpdateRule weitergeleitet, das jede Regel in der Auflistung löscht.

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

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Remove-CsDeviceUpdateRule

Mit dem vorstehenden Befehl werden alle Geräteaktualisierungsregeln gelöscht, deren Eigenschaft "Brand" den Wert "LG-Nortel" aufweist. Hierzu ruft der Befehl zunächst das Cmdlet Get-CsDeviceUpdateRule ohne Parameter auf, um eine Auflistung aller derzeit in der Organisation verwendeten Geräteaktualisierungsregeln abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Regeln auswählt, bei denen "Brand" den Wert "LG-Nortel" aufweist. Die gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsDeviceUpdateRule weitergeleitet, das sämtliche Regeln in der Auflistung entfernt.