• Artikel

Get-CsDeviceUpdateConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den gegenwärtig in Ihrer Organisation verwendeten Konfigurationseinstellungen für Geräteaktualisierungen zurück. Mit diesen Einstellungen können Sie den Geräteaktualisierungswebdienst verwalten. Dabei handelt es sich um eine Microsoft Lync Server 2010-Komponente, mit der Administratoren Firmwareupdates für Telefone und andere Geräte bereitstellen können, auf denen Microsoft Lync 2010 Phone Edition ausgeführt wird.

Syntax

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

Get-CsDeviceUpdateConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Der Geräteaktualisierungswebdienst bietet Administratoren die Möglichkeit, 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 in Lync Server 2010 hoch. Nachdem diese Regeln getestet und genehmigt wurden, können sie auf die entsprechenden Geräte angewendet werden, sobald diese eine Verbindung mit dem System herstellen. Geräte führen beim ersten Einschalten sowie nach einer Benutzeranmeldung eine Überprüfung auf Updates durch. Anschließend prüfen die Geräte alle 24 Stunden auf Updates.

Der Geräteaktualisierungswebdienst wird mithilfe der Gerätekonfigurationseinstellungen verwaltet. Diese Einstellungen können auf globaler Ebene oder Standortebene angewendet werden. Mit dem Cmdlet Get-CsDeviceUpdateConfiguration können Sie Informationen zu den Konfigurationseinstellungen für Geräteaktualisierungen zurückgeben, die derzeit in Ihrer Organisation verwendet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Gibt den Identitätswert der abzurufenden Konfigurationseinstellungen für Geräteaktualisierungen an. Verwenden Sie folgende Syntax, um auf die globalen Einstellungen zu verweisen: -Identity global. Verwenden Sie eine Syntax wie die folgende, um auf Standorteinstellungen zu verweisen: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. Wenn Platzhalter nötig sind, verwenden Sie den Parameter "Filter".

Filter

Optional

XdsIdentity-Filter

Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben von Konfigurationseinstellungen für Geräteaktualisierungen. Verwenden Sie beispielsweise folgende Syntax, um eine Auflistung aller auf Standortebene angewendeten Konfigurationseinstellungen zurückzugeben. -Filter "site:*". Verwenden Sie diese Syntax, um alle Einstellungen mit dem Begriff "EMEA" im Identitätswert zurückzugeben: -Filter "*EMEA*". Beachten Sie, dass der Parameter "Filter" nur auf den Identitätswert der Einstellungen und nicht auf andere Konfigurationseigenschaften für Geräteaktualisierungen angewendet werden kann.

LocalStore

Optional

Switch-Parameter

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

Eingabetypen

Keine. Get-CsDeviceUpdateConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

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

Beispiel

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

Get-CsDeviceUpdateConfiguration

Der Befehl in Beispiel 1 gibt eine Auflistung aller derzeit in der Organisation verwendeten Konfigurationseinstellungen für Geräteaktualisierungen zurück. Durch Aufrufen von Get-CsDeviceUpdateConfiguration ohne zusätzliche Parameter werden alle derzeit verwendeten Geräteaktualisierungseinstellungen zurückgegeben.

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

Get-CsDeviceUpdateConfiguration -Identity Global

In Beispiel 2 werden Informationen zu den globalen Konfigurationseinstellungen für die Geräteaktualisierung zurückgegeben.

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

Get-CsDeviceUpdateConfiguration -Filter site:*

Beispiel 3 zeigt die Verwendung des Parameters "Filter". Der Filterwert "site:*" gibt eine Auflistung aller auf Standortebene angewendeten Einstellungen für Geräteaktualisierungen zurück, da der Identitätswert dieser Einstellungen mit dem Zeichenfolgenwert "site:" beginnt.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}

Mit dem vorstehenden Beispiel werden alle Konfigurationseinstellungen für Geräteaktualisierungen zurückgegeben, bei denen die Eigenschaft "MaxLogFileSize" größer als 2048000 Byte ist. Dazu wird zunächst das Cmdlet Get-CsDeviceUpdateConfiguration verwendet, um eine Auflistung aller derzeit verwendeten Konfigurationseinstellungen für Geräteaktualisierungen abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "MaxLogFileSize" größer als 2048000 ist.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}

Der Befehl in Beispiel 5 gibt alle Konfigurationseinstellungen für Geräteaktualisierungen zurück, die "Watson" als gültigen Protokolldateityp aufweisen. Dazu wird zunächst das Cmdlet Get-CsDeviceUpdateConfiguration verwendet, um eine Auflistung aller Konfigurationseinstellungen für Geräteaktualisierungen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Geräteeinstellungen herausfiltert, bei denen die Liste gültiger Protokolldateitypen den Wert "Watson" enthält.