• Artikel

Get-CsDeviceUpdateRule

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den Geräteaktualisierungsregeln zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. Geräteaktualisierungsregeln werden dazu verwendet, Firmwareupdates Geräten zuzuordnen, auf denen Microsoft Lync 2010 Phone Edition ausgeführt wird.

Syntax

Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <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.

Geräteaktualisierungsregeln können in die Webdienste importiert (und auf diese angewendet) werden. Mit dem Cmdlet Get-CsDeviceUpdateRule werden Informationen zu den Geräteaktualisierungsregeln zurückgegeben, die für die Verwendung in Ihrer Organisation importiert wurden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

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. Verwenden Sie den Parameter "Filter", wenn Sie bei der Angabe einer Regel Platzhalter verwenden möchten.

Filter

Optional

Zeichenfolge

Ermöglicht es Ihnen, beim Festlegen des Identitätswerts einer Geräteaktualisierungsregel oder eines Regelsatzes Platzhalter zu verwenden. Verwenden Sie beispielsweise den folgenden Filterwert, um alle Geräteaktualisierungsregeln für "WebServer:atl-cs-001.litwareinclcom" zurückzugeben: "service:WebServer:atl-cs-001.litwareinc.com*".

LocalStore

Optional

Switch-Parameter

Ruft die Daten zur Geräteaktualisierungsregel aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsDeviceUpdateRule akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit Get-CsDeviceUpdateRule werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule" zurückgegeben.

Beispiel

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

Get-CsDeviceUpdateRule

Mit dem vorstehenden Befehl werden Informationen zu allen Geräteaktualisierungsregeln zurückgegeben, die in Ihrer Organisation angewendet wurden. Beim Aufrufen von Get-CsDeviceUpdateRule ohne zusätzliche Parameter wird immer eine vollständige Auflistung von Geräteaktualisierungsregeln zurückgegeben.

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

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

Der Befehl in Beispiel 2 gibt Informationen zur Geräteaktualisierungsregel mit dem Identitätswert "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9"" zurück.

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

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

In Beispiel 3 werden Informationen zu allen Geräteaktualisierungsregeln zurückgegeben, die für den Dienst "WebServer:atl-cs-001.litwareinc.com" konfiguriert wurden. Hierzu wird der Parameter "Filter" zusammen mit dem Filterwert "WebServer:atl-cs-001.litwareinc.com *" verwendet. Mit diesem Filter werden die zurückgegebenen Daten auf die Geräteaktualisierungsregeln beschränkt, deren Identitätswert mit der Zeichenfolge "service:WebServer:atl-cs-001.litwareinc.com" beginnt.

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

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

Mit dem vorstehenden Befehl werden alle Geräteaktualisierungsregeln zurückgegeben, deren Eigenschaft "Brand" den Wert "LG-Nortel" aufweist. Hierzu wird Get-CsDeviceUpdateRule aufgerufen, um eine Auflistung aller Geräteaktualisierungsregeln in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Regeln auswählt, bei denen "Brand" den Wert "LG-Nortel" aufweist.

-------------------------- Beispiel 5 --------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

In Beispiel 5 wird eine Auflistung aller Geräteaktualisierungsregeln zurückgegeben, die nicht genehmigt wurden. Hierzu wird Get-CsDeviceUpdateRules ausgeführt, um eine Auflistung aller Regeln zurückzugeben, die dann an das Cmdlet Where-Object weitergeleitet wird. Das Cmdlet Where-Object wiederum wählt nur die Regeln aus, bei denen die Eigenschaft "Approved" einen Nullwert aufweist. Wenn die Eigenschaft "Approved" einen Nullwert aufweist, wurden diese Regeln nicht genehmigt.

-------------------------- Beispiel 6 -------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

Mit dem vorstehenden Befehl wird eine Auflistung aller Geräteaktualisierungsregeln zurückgegeben, die zwei Kriterien erfüllen: Die Regel wurde genehmigt, und die Regel bezieht sich auf LG-Nortel-Geräte. Hierzu wird Get-CsDeviceUpdateRule aufgerufen, um eine Auflistung aller Geräteaktualisierungsregeln in der Organisation zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Auflistung nach zwei Kriterien filtert: Die Eigenschaft "Approved" darf keinen Nullwert aufweisen (d. h. für diese Eigenschaft muss ein Wert festgelegt sein), und "Brand" muss den Wert "LG-Nortel" aufweisen.