• Artikel

Set-CsDeviceUpdateConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine Auflistung von Geräteaktualisierungswebdienst-Konfigurationseinstellungen. 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

Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Der Geräteaktualisierungswebdienst bietet Administratoren die Möglichkeit, Firmwareupdates für Geräte bereitzustellen, auf denen Microsoft Lync 2010 Phone Edition ausgeführt wird. Administratoren laden regelmäßig einen neuen Satz von Geräteaktualisierungsregeln in Microsoft 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 suchen die Geräte alle 24 Stunden nach Updates.

Konfigurationseinstellungen für die Geräteaktualisierung können entweder global oder auf Standortebene zugewiesen werden. Mit dem Cmdlet Set-CsDeviceUpdateConfiguration können Sie Änderungen an einer Einstellungsauflistung vornehmen. Sie können dieses Cmdlet beispielsweise verwenden, um zu ändern, wie lange eine Protokolldatei gespeichert wird, bevor sie automatisch vom System gelöscht wird.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eindeutige ID der zu ändernden Konfigurationseinstellungen für Geräteaktualisierungen. 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.

Instance

Optional

DeviceUpdateSettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

LogCleanUpInterval

Optional

Timespan

Gibt die Dauer an, die eine Protokolldatei für Geräteaktualisierungen gespeichert wird, bevor sie vom System gelöscht wird.

Der Wert muss im Format "tt.hh:mm:ss" eingegeben werden, wobei "tt" für Tage, "hh" für Stunden, "mm" für Minuten und "ss" für Sekunden steht. Um nur Tage einzugeben, müssen Sie hinter den Wert einen Punkt (.) setzen.

Mindestwert: 1.00:00:00 (1 Tag)

Höchstwert: 365.00:00:00 (1 Jahr)

Standard: 10.00:00:00 (10 Tage)

LogCleanUpTimeOfDay

Optional

DateTime

Gibt die Uhrzeit an, zu der das System prüft, ob abgelaufene Protokolldateien vorhanden sind, die gelöscht werden müssen. (Abgelaufene Protokolldateien sind Dateien, die älter sind als der für die Eigenschaft "LogCleanupInterval" angegebene Wert.)

Der an den Parameter "LogCleanupTimeOfDay" übergebene Wert muss im 24-Stunden-Format (hh:mm) angegeben werden, dabei steht "hh" für die Stunden und "mm" für die Minuten. In diesem Format wird Mitternacht als "00:00" dargestellt. 8:30 AM wird als "08:30" und 11:52 PM wird als "23:52" angegeben.

LogFlushInterval

Optional

TimeSpan

Gibt an, wie oft im Protokolldateicache gespeicherte Informationen in die tatsächliche Protokolldatei geschrieben werden. Standardmäßig werden die Geräteaktualisierungsinformationen nicht sofort in die Protokolldatei geschrieben. Stattdessen werden die Informationen im Arbeitsspeicher zwischengespeichert, bis einer der folgenden Zustände eintritt: 1) Das Intervall der Protokollleerung ist abgelaufen; oder 2) die Maximalgröße des Caches wurde erreicht. Wenn dieser Wert auf 10 Minuten (00:10:00) festgelegt ist, werden die Informationen im Cache alle zehn Minuten in die Protokolldatei geschrieben. Nach der Protokollierung der Daten wird der Cache geleert.

Der Wert muss im Format "hh:mm:ss" eingegeben werden, wobei "hh" für Stunden, "mm" für Minuten und "ss" für Sekunden steht.

Mindestwert: 00:01:00 (1 Minute)

Höchstwert: 1:00:00 (1 Stunde)

Standard: 00:05:00

MaxLogCacheLimit

Optional

Ganze Zahl

Gibt die maximale Informationsmenge (in Byte) an, die im Protokolldateicache gespeichert werden kann, bevor der Cache geleert und die Daten in eine Protokolldatei geschrieben werden müssen. Protokolldateien werden standardmäßig alle 5 Minuten geleert. (Weitere Informationen finden Sie in der Beschreibung zu Parameter "LogFlushInterval".) Wenn jedoch die maximale Informationsmenge im Cache erreicht wurde, werden die Informationen automatisch in eine Protokolldatei geschrieben (und der Cache geleert), selbst wenn das Protokollleerungsintervall noch nicht abgelaufen ist.

Standard: 512000

MaxLogFileSize

Optional

Ganze Zahl

Gibt die maximale Größe einer einzelnen Protokolldatei in Byte an. Wenn die maximale Größe einer Datei erreicht wurde, wird der nächste Datenbatch automatisch in eine neue Protokolldatei geschrieben. Die alte Protokolldatei wird so lange beibehalten, bis das Protokollleerungsintervall abgelaufen ist.

Standard: 1024000

ValidLogFileExtensions

Optional

PSListModifier

Gibt die gültigen Protokolldateierweiterungen an, die mit dem Geräteaktualisierungswebdienst verwendet werden können. Diese Liste kann geändert werden. Dies ist in der Regel jedoch nur erforderlich, wenn Sie über ein Lync 2010 Phone Edition-kompatibles Gerät verfügen, das Protokolldateien mit einer anderen Dateierweiterung erstellt.

Standard: .dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex

ValidLogFileTypes

Optional

PSListModifier

Gibt die Protokolldateitypen an, die vom Geräteaktualisierungssystem beibehalten werden. Es gibt die folgenden Standarddateitypen:

Watson. Von einem Gerät bei einem Systemabsturz automatisch erstellte Protokolldateien.

Config. Microsoft RoundTable-Konferenzgerät-Profile, die bei jeder Konfiguration eines RoundTable-Geräts erstellt werden.

DiagLog. Selbstdiagnosedaten für RoundTable-Geräte.

CELog. Lync 2010 Phone-Protokolle mit den Ergebnissen von Funktionstests sowie einer Aufzeichnung wichtiger Systemereignisse.

Weitere Dateitypen können hinzugefügt werden, wenn Sie ein Lync 2010 Phone Edition-kompatibles Gerät besitzen, das einen anderen Protokolldateityp erstellt. Sie können Dateien auch entfernen. Wenn Sie beispielsweise keine CELog-Dateien speichern möchten, können Sie den Dateityp "CELog" entfernen.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration-Objekt. Set-CsDeviceUpdateConfiguration akzeptiert weitergeleitete Instanzen des Objekts für die Geräteaktualisierungskonfiguration.

Rückgabetypen

Set-CsDeviceUpdateConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration" konfiguriert.

Beispiel

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

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

In Beispiel 1 wird gezeigt, wie das Cmdlet Set-CsDeviceUpdateConfiguration zum Ändern der globalen Konfigurationseinstellungen verwendet werden kann. In diesem Fall werden zwei Eigenschaftswerte geändert: die Eigenschaft "MaxLogFileSize" wird auf 2048000 Bytes und die Eigenschaft "MaxLogCacheLimit" auf 1024000 Bytes festgelegt.

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

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

Mit dem vorstehenden Befehl wird die Eigenschaft "LogFlushInterval" für die Konfigurationseinstellungen zur Geräteaktualisierung für den Identitätswert "site:Redmond" geändert. Der Parameter "Identity" wird hierbei zum Angeben der Einstellungen am Standort "Redmond" und der Parameter "LogFlushInterval" zum Angeben des zu ändernden Eigenschaftswerts verwendet. In diesem Fall wird der Parameter "LogFlushInterval" auf 2 Minuten festgelegt (00 Stunden: 02 Minuten: 00 Sekunden).

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

In Beispiel 3 werden alle Geräteaktualisierungseinstellungen in der Organisation so geändert, dass der Parameter "LogCleanUpInterval" auf 14 Tage festgelegt wird. Hierzu 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 Set-CsDeviceUpdateConfiguration weitergeleitet, das den Parameter "LogCleanUpInterval" verwendet, um das Protokollleerungsintervall für alle Elemente in der Auflistung auf 14 Tage festzulegen (14 Tage . 00 Stunden : 00 Minuten : 00 Sekunden).

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

Beispiel 4 veranschaulicht, wie Sie einen Eigenschaftswert für alle Konfigurationseinstellungen für Geräteaktualisierungen ändern können, die auf Standortebene konfiguriert wurden. In diesem Fall legt der Befehl den Parameter "LogCleanUpInterval" auf 20 Tage fest (20 Tage . 00 Stunden : 00 Minuten : 00 Sekunden). Hierzu wird das Cmdlet Get-CsDeviceUpdateConfiguration zusammen mit dem Parameter "Filter" aufgerufen. Der Filterwert "site:*" beschränkt die zurückgegebenen Daten auf Einstellungen, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsDeviceUpdateConfiguration weitergeleitet, das den Wert des Protokollleerungsintervalls für jedes Element in der Auflistung ändert.

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

Mit dem vorstehenden Befehl wird CELog aus der Liste der gültigen Protokolldateitypen entfernt, die in den Konfigurationseinstellungen für Geräteaktualisierungen verwendet werden. Bei diesem Befehl wird zunächst das Cmdlet Get-CsDeviceUpdateConfiguration verwendet, um eine Auflistung aller Konfigurationseinstellungen für die Geräteaktualisierung abzurufen, die gegenwärtig in der Organisation genutzt werden. Diese Auflistung wird anschließend an das Cmdlet Set-CsDeviceUpdateConfiguration weitergeleitet, das den Parameter "ValidLogFileTypes" verwendet, um CELog aus der Liste der gültigen Protokolldateitypen zu entfernen. Der an "ValidLogFileTypes" übergebene Parameterwert "@{Remove="CELog"}" weist Set-CsDeviceUpdateConfiguration an, CELog aus der Gruppe der gültigen Dateitypen zu entfernen. Zum Entfernen mehrerer Dateitypen in einem einzelnen Befehl fügen Sie die zusätzlichen Typen in einer Liste mit Kommas als Trennzeichen hinzu. Beispiel:

@{Remove="CELog","Watson"}