• Artikel

Restore-CsDeviceUpdateRule

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ermöglicht das Rückgängigmachen einer Geräteaktualisierungsregel, die für den Einsatz in der Organisation genehmigt wurde. Wenn Sie eine Geräteaktualisierungsregel wiederherstellen, wird die genehmigte Version dieser Regel zurückgesetzt, sodass wieder die Version verwendet wird, die vor Genehmigung der Regel verwendet wurde. Auf Clientgeräten, die anschließend beim System angemeldet werden, wird das neueste Update automatisch deinstalliert, und die vorherige Version wird heruntergeladen und wieder installiert.

Syntax

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

Restore-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 Satz von Geräteaktualisierungsregeln in Lync Server 2010. Nachdem diese Regeln getestet und genehmigt wurden, werden sie von den entsprechenden Geräten automatisch heruntergeladen und übernommen, sobald sich diese das nächste Mal mit dem System verbinden. Geräte führen standardmäßig nach dem Einschalten und Herstellen einer Verbindung mit Lync Server sowie alle 24 Stunden nach der anfänglichen Anmeldung eine Überprüfung auf neue Geräteaktualisierungsregeln durch.

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. Dies bietet Ihnen die Möglichkeit, die Updates zu testen, um sicherzustellen, dass keine nachteiligen Auswirkungen zu verzeichnen sind, bevor das Update allgemein zur Verfügung gestellt wird. 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.

Wenn Sie ein Update genehmigen, wird die Eigenschaft "PendingVersion" der dazugehörigen Aktualisierungsregel der Eigenschaft "ApprovedVersion" zugewiesen und die Eigenschaft "PendingVersion" gelöscht. Angenommen, die Eigenschaft "PendingVersion" einer neuen Aktualisierungsregel hat den Wert 1.0.0.1. Nach Ausführung des Cmdlets Approve-CsDeviceUpdateRule wird die Eigenschaft "PendingVersion" auf einen Nullwert und die Eigenschaft "ApprovedVersion" auf 1.0.0.1 festgelegt. Wenn ein Clientgerät das nächste Mal nach Updates sucht, werden die Updates automatisch heruntergeladen und installiert.

Darüber hinaus werden vorherige Versionen des Updates (z. B. Version 1.0.0.0) als "RestoreVersion" markiert. Diese Version des Updates verbleibt auf dem System und wird verwendet, wenn das neue Update zurückgesetzt werden muss. Sollten Probleme auftreten, können Administratoren mit dem Cmdlet Restore-CsDeviceUpdateRule ein Rollback für das Update ausführen. Wenn dies geschieht, wird das neue Update bei der nächsten Suche nach Updates durch ein Clientgerät automatisch deinstalliert (Version 1.0.0.1) und die vorherige Version (1.0.0.0) wieder installiert.

Beachten Sie, dass dies nur geschieht, wenn es eine vorherige zu installierende Version gibt. Wenn es keine derartige vorherige Version gibt, wird das Update, für das ein Rollback ausgeführt wurde, lediglich deinstalliert.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eindeutige ID der wiederherzustellenden 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-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Optional

DeviceUpdate.Rule-Objekt

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 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. Restore-CsDeviceUpdateRule akzeptiert weitergeleitete Instanzen des Objekts für Geräteaktualisierungsregeln.

Rückgabetypen

Keine. Stattdessen werden mit Restore-CsDeviceUpdateRule Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule" wiederhergestellt.

Beispiel

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

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

Der Befehl in Beispiel 1 stellt die Geräteaktualisierungsregel "d5ce3c10-2588-420a-82ac-dc2d9b1222ff9" wieder her, die für den Dienst "WebServer:atl-cs-001.litwareinc.com" gefunden wurde.

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

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

Mit dem vorstehenden Befehl werden alle Geräteaktualisierungsregeln wiederhergestellt, die für den Dienst "WebServer:atl-cs-001.litwareinc.com" konfiguriert wurden. Hierzu ruft der Befehl zuerst Get-CsDeviceUpdateRule zusammen mit dem Parameter "Filter" auf. Der Filterwert "WebServer:atl-cs-001.litwareinc.com*" stellt sicher, dass nur die Regeln mit einem Identitätswert zurückgegeben werden, der 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.) Diese gefilterte Auflistung wird dann an das Cmdlet Restore-CsDeviceUpdateRule weitergeleitet, das jede Regel in der Auflistung wiederherstellt.

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

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

Beispiel 3 veranschaulicht das Wiederherstellen aller Geräteaktualisierungsregeln für eine angegebene Marke (LG-Nortel). 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. Die gefilterte Auflistung wird dann an das Cmdlet Restore-CsDeviceUpdateRule weitergeleitet, das alle Regeln in der gefilterten Auflistung wiederherstellt.