• Artikel

Approve-CsDeviceUpdateRule

 

Letztes Änderungsdatum des Themas: 2012-03-23

Genehmigt eine in das System importierte Geräteaktualisierungsregel. Nach der Genehmigung einer Geräteaktualisierungsregel wird das entsprechende Update von den entsprechenden Clientgeräten automatisch heruntergeladen und installiert.

Syntax

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

Approve-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 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 2010 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.

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 sich ein Client das nächste Mal anmeldet, überprüft das Gerät automatisch, ob neue genehmigte Updates vorhanden sind. Falls ja, wird das Update automatisch heruntergeladen und installiert.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eindeutige ID für die zu genehmigende 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. Approve-CsDeviceUpdateRule akzeptiert weitergeleitete Instanzen des Objekts für Geräteaktualisierungsregeln.

Rückgabetypen

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

Beispiel

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

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

Der Befehl in Beispiel 1 genehmigt die Geräteaktualisierungsregel "d5ce3c10-2588-420a-82ac-dc2d9b1222ff9", 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* | Approve-CsDeviceUpdateRule

Mit dem vorstehenden Befehl werden alle Geräteaktualisierungsregeln genehmigt, die für den Dienst "WebServer:atl-cs-001.litwareinc.com" konfiguriert wurden. Hierzu ruft der Befehl zunächst Get-CsDeviceUpdateRule zusammen mit dem Parameter "Filter" auf. Der Filterwert "service:WebServer:atl-cs-001.litwareinc.com*" stellt sicher, dass nur die Regeln mit einem Identitätswert zurückgegeben werden, der mit der Zeichenfolge "service: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 Approve-CsDeviceUpdateRule weitergeleitet, das jede Regel in der Auflistung genehmigt.

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

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

Der Befehl in Beispiel 3 genehmigt alle Geräteaktualisierungsregeln für die angegebene Marke (LG-Nortel). Dazu ruft der Befehl zunächst Get-CsDeviceUpdateRule 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 Approve-CsDeviceUpdateRule weitergeleitet, das jede Regel in der Auflistung genehmigt.