• Artikel

Reset-CsDeviceUpdateRule

 

Letztes Änderungsdatum des Themas: 2012-03-25

Lehnt eine in das System importierte Geräteaktualisierungsregel ab.

Syntax

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

Reset-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 regelmäßig einen neuen Satz von Geräteaktualisierungsregeln nach Lync Server 2010 hoch. Nachdem diese Regeln getestet und genehmigt wurden, werden sie automatisch heruntergeladen und auf die entsprechenden Geräte angewendet, 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.

Eine neue dem System hinzugefügte Geräteaktualisierungsregel wird als "Ausstehend" markiert. Dies bedeutet, dass das Update von den entsprechenden Testgeräten heruntergeladen und installiert wird. Es wird jedoch nicht von allen Clientgeräten heruntergeladen und installiert. Damit haben Sie Gelegenheit, die Updates zu testen und sicherzustellen, dass sie keine unerwünschten Nebeneffekte nach sich ziehen, bevor Sie sie allgemein zur Verfügung stellen. Sobald Sie sich davon überzeugt haben, dass das Update alle erforderlichen Tests bestanden hat und in Ihrer Organisation eingesetzt werden kann, können Sie das Update mit Approve-CsDeviceUpdateRule genehmigen.

Administratoren können allerdings auch zu dem Schluss kommen, dass ein bestimmtes Update nicht in der Organisation verwendet werden soll (z. B. wenn es zu Konflikten mit interner Software führt). In diesem Fall können Administratoren das Update mit dem Cmdlet Reset-CsDeviceUpdateRule ablehnen. Daraufhin wird für die Eigenschaft "PendingVersion" ein Nullwert festgelegt. Dies bedeutet, dass Testgeräte, die sich am System anmelden, das Update deinstallieren und erneut die genehmigte Version dieses Updates installieren. Und da das Update nie genehmigt wurde, wird das Update nur von den Testgeräten installiert. Demzufolge gibt es keinerlei Auswirkung auf die allgemeinen Benutzer.

Das Cmdlet Reset-CsDeviceUpdateRule kann nur für Geräteaktualisierungsregeln mit dem Status "Ausstehend" verwendet werden. Wenn eine Regel bereits genehmigt wurde, müssen sie mithilfe des Cmdlets Restore-CsDeviceUpdateRule ein Rollback der Bereitstellung des Geräteupdates ausführen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Reset-CsDeviceUpdateRule lokal auszufü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 "Reset-CsDeviceUpdateRule"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eindeutige ID für die zurückzusetzende Geräteaktualisierungsregel. Der Identitätswert einer Geräteaktualisierungsregel besteht aus zwei Teilen: dem Dienst, dem die Geräteaktualisierungsregel zugewiesen wurde (z. B. "service:WebServer:atl-cs-001.litwareinc.com"), und einer GUID (Globally Unique Identifier). Demnach hat eine für den Standort "Redmond" konfigurierte Geräteaktualisierungsregel einen Identitätswert wie den folgenden: "service:WebServer:atl-cs-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Instance

Optional

DeviceUpdate.Rule

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Bestätigungsaufforderungen oder Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Cmdlets 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. Reset-CsDeviceUpdateRule akzeptiert weitergeleitete Instanzen des Objekts für Geräteaktualisierungsregeln.

Rückgabetypen

Keine. Stattdessen werden mit Reset-CsDeviceUpdateRule Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule" zurückgesetzt.

Beispiel

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

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

Der Befehl in Beispiel 1 setzt die für Dienst "WebServer:atl-cs-001.litwareinc.com" gefundene Geräteaktualisierungsregel d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 zurück.

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

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

Der vorstehende Befehl setzt alle für den Dienst "WebServer:atl-cs-001.litwareinc.com" konfigurierten Geräteaktualisierungsregeln zurück. Dazu wird zunächst Get-CsDeviceUpdateRule mit dem Parameter "Filter" aufgerufen. Der Filterwert "WebServer:atl-cs-001.litwareinc.com*" stellt sicher, dass nur Regeln zurückgegeben werden, deren Identitätswert mit der Zeichenfolge "WebServer:atl-cs-001.litwareinc.com" beginnt. (Dies sind laut Definition alle Geräteaktualisierungsregeln, die dem Dienst "WebServer:atl-cs-001.litwareinc.com" zugewiesen wurden.) Die gefilterte Auflistung wird dann an das Cmdlet Reset-CsDeviceUpdateRule weitergeleitet, das jede Regel in der Auflistung zurücksetzt.

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

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

Der Befehl in Beispiel 3 setzt alle Geräteaktualisierungsregeln für die Marke LG-Nortel zurück. Hierzu ruft der Befehl zunächst Get-CsDeviceUpdateRule ohne Parameter auf, um eine Auflistung aller derzeit in der Organisation verwendeten Geräteaktualisierungsregeln zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Regeln herausfiltert, bei denen die Eigenschaft "Brand" den Wert "LG-Nortel" aufweist. Diese gefilterte Auflistung wird anschließend an das Cmdlet Reset-CsDeviceUpdateRule weitergeleitet, das alle Regeln in der gefilterten Auflistung zurücksetzt.