• Artikel

Remove-CsDeviceUpdateConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt die angegebenen Konfigurationseinstellungen für Geräteaktualisierungen. 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

Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 nach 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.

Lync Server verwendet für die Verwaltung des Geräteaktualisierungswebdiensts Konfigurationseinstellungen für Geräteaktualisierungen. Diese Konfigurationseinstellungen können global oder auf Standortebene angewendet werden. Standardmäßig werden Einstellungen nur auf globaler Ebene angewendet, Sie können mit dem Cmdlet New-CsDeviceUpdateConfiguration jedoch auch benutzerdefinierte Einstellungen auf Standortebene zuweisen.

Darüber hinaus können Sie mit dem Cmdlet Remove-CsDeviceUpdateConfiguration Einstellungen löschen, die auf Standortebene zugewiesen wurden. Wenn Sie dieses Cmdlet für einen Standort ausführen, werden die diesem Standort zugewiesenen Konfigurationseinstellungen für Geräteaktualisierungen entfernt. Sie können das Cmdlet Remove-CsDeviceUpdateConfiguration auch für die globalen Einstellungen ausführen. In diesem Fall werden die globalen Einstellungen jedoch nicht entfernt, da die globalen Konfigurationseinstellungen für Geräteaktualisierungen nicht entfernt werden können. Stattdessen werden die globalen Eigenschaften auf ihre Standardwerte zurückgesetzt. Nehmen Sie beispielsweise an, Sie haben die globale Eigenschaft "MaxLogCacheLimit" in 1.024.000 Byte geändert. Wenn Sie Remove-CsDeviceUpdateConfiguration für die globalen Einstellungen ausführen, werden die globalen Einstellungen nicht entfernt, sondern alle geänderten Eigenschaften auf ihre Standardwerte zurückgesetzt. Dies bedeutet, dass "MaxLogCacheLimit" auf 512.000 Byte zurückgesetzt wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Gibt den Identitätswert der zu entfernenden 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.

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.DeviceUpdateConfiguration-Objekt. Remove-CsDeviceUpdateConfiguration akzeptiert weitergeleitete Instanzen des Objekts für die Geräteaktualisierungskonfiguration.

Rückgabetypen

Keine. Stattdessen werden mit dem Cmdlet Remove-CsDeviceUpdateConfiguration Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration" gelöscht.

Beispiel

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

Remove-CsDeviceUpdateConfiguration -Identity global

In Beispiel 1 werden mit Remove-CsDeviceUpdateConfiguration die globalen Konfigurationseinstellungen für Geräteaktualisierungen "entfernt". Da die globalen Einstellungen nicht entfernt werden können, werden sie mit diesem Befehl nicht wirklich gelöscht. Stattdessen werden sämtliche Eigenschaften in den globalen Konfigurationseinstellungen für Geräteaktualisierungen auf ihre Standardwerte zurückgesetzt.

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

Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

Mit den vorstehenden Befehlen werden die Konfigurationseinstellungen für Geräteaktualisierungen mit dem Identitätswert "site:Redmond" entfernt. Da diese Einstellungen auf Standortebene konfiguriert wurden, werden sie gelöscht, und der Standort "Redmond" verfügt nicht länger über einen eigenen Satz mit Konfigurationseinstellungen für Geräteaktualisierungen.

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

In Beispiel 3 werden alle auf Standortebene konfigurierten Konfigurationseinstellungen für Geräteaktualisierungen entfernt. Hierzu werden mit dem Cmdlet Get-CsDeviceUpdateConfiguration und dem Parameter "Filter" alle Einstellungen zurückgegeben, deren Identitätswert mit dem Zeichenfolgenwert "site:" beginnt. Dies sind laut Definition Einstellungen, die auf Standortebene konfiguriert wurden. Diese Auflistung wird dann an das Cmdlet Remove-CsDeviceUpdateConfiguration weitergeleitet, das dann sämtliche Elemente in der Auflistung entfernt.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration

In Beispiel 4 werden alle Konfigurationseinstellungen für Geräteaktualisierungen gelöscht, deren Eigenschaft "MaxLogFileSize" größer ist 1024000 Byte. Hierzu wird zunächst das Cmdlet Get-CsDeviceUpdateConfiguration aufgerufen, um eine Auflistung aller Konfigurationseinstellungen für die Geräteaktualisierung abzurufen. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das nur die Konfigurationseinstellungen herausfiltert, bei denen die Eigenschaft "MaxLogFileSize" größer als 1024000 Byte ist. Diese gefilterte Auflistung wird dann an Remove-CsDeviceUpdateConfiguration weitergeleitet, um sämtliche Elemente der Auflistung zu löschen.