Import-CsDeviceUpdate
Letztes Änderungsdatum des Themas: 2012-03-23
Importiert eine Reihe von Geräteaktualisierungsregeln von der Microsoft-Website. Geräteaktualisierungsregeln ordnen Updates für Firmwareversionen Hardwaregeräten zu, auf denen Microsoft Lync 2010 Phone Edition ausgeführt wird.
Syntax
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Microsoft bringt regelmäßig einen neuen Satz von Geräteaktualisierungsregeln für Lync 2010 Phone Edition heraus. Diese Regeln stellen Firmwareupdates für Geräte dar, auf denen Lync 2010 Phone Edition ausgeführt wird. Nachdem diese Regeln importiert wurden, können Administratoren die Firmwareupdates testen und sie dann, sofern die Tests erfolgreich waren, allen relevanten Geräten in der Organisation zur Verfügung stellen.
Die einzige Möglichkeit zum Erstellen neuer Aktualisierungsregeln besteht darin, Updatepakete von Microsoft herunterzuladen. Sie können keine eigenen Geräteaktualisierungsregeln erstellen. Um den neuesten Satz von Geräteaktualisierungsregeln zu erhalten, rufen Sie auf der Microsoft-Website die Seite "Hilfe und Support" auf und suchen "Phone Edition". Laden Sie das Updatepaket herunter, und extrahieren Sie die Dateien in einen Ordner auf dem Computer, auf den die Updates geladen werden sollen. Nachdem Sie die Dateien extrahiert haben, können Sie das Cmdlet Import-CsDeviceUpdate verwenden, um die Geräteaktualisierungsregeln aus der extrahierten CAB-Datei (die "UCUpdates.cab" oder ähnlich heißt) zu importieren.
Wie bereits erwähnt, können Updates nur lokal geladen werden. Sie müssen die Datei "UCUpdates.cab" auf einen Computer kopieren, auf dem die Webdienste ausgeführt werden, die die Geräteaktualisierungsregeln hosten müssen. Beachten Sie auch, dass die Geräteaktualisierungsregeln nicht von Server zu Server repliziert werden. Wenn Sie alle Geräteaktualisierungsregeln innerhalb der Organisation synchron halten möchten, müssen Sie diesen Vorgang auf allen Servern ausführen, auf denen diese Regeln gehostet werden. Wenn Sie beispielsweise eine Regel von einem Webdienste-Server entfernen, müssen Sie dieselbe Regel von den anderen Webdienste-Servern entfernen. Andernfalls sind die Geräteaktualisierungsregeln nicht mehr synchron.
Aktualisierungsregeln können nur in Dienste importiert werden. Sie können nicht auf globaler Ebene, auf Standortebene oder für individuelle Benutzer angewendet werden. Beachten Sie jedoch, dass mit Import-CsDeviceUpdate nicht automatisch jedem Dienst an einem Standort Regeln und Updates hinzugefügt werden. Vielmehr werden diese Regeln und Updates nur in den angegebenen Dienst geladen. Wenn beispielsweise an einem Standort drei Server die Webdienste ausführen, müssen Sie Import-CsDeviceUpdate dreimal ausführen: einmal für jede Instanz der Webdienste. Alternativ können Sie einen Befehl wie den in Beispiel 3 verwenden. Mit diesem Befehl wird der Identitätswert aller Ihrer Webdienste-Server abgerufen und dann Import-CsDeviceUpdate für jeden dieser Server ausgeführt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Import-CsDeviceUpdate 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 "Import-CsDeviceUpdate"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Gibt die Dienstinstanz an, auf die die neuen Aktualisierungsregeln angewendet werden. Beispiel: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
FileName |
Optional |
Zeichenfolge |
Pfad zur Updatedatei (z. B. "C:\Updates\UCUpdates.cab"). |
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
Keine. Import-CsDeviceUpdate akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit dem Cmdlet Import-CsDeviceUpdate werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule" importiert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
Der Befehl in Beispiel 1 importiert die Geräteaktualisierungsregeln aus der Datei "C:\Updates\UCUpdates.cab".
-------------------------- Beispiel 2 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
Der Befehl in Beispiel 2 importiert die Geräteaktualisierungsregeln aus der Datei unter dem UNC-Pfad "\\atl-fs-001\Updates\UCUpdates.cab".
-------------------------- Beispiel 3 ------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
Beispiel 3 zeigt, wie Sie Geräteaktualisierungsregeln mit nur einem Befehl in alle Server importieren können, auf denen die Webdienste ausgeführt werden. Dazu ruft der Befehl zunächst Get-CsService mit dem Parameter "WebServer" auf, um eine Auflistung aller Server zurückzugeben, auf denen die Webdienste ausgeführt werden. Diese Auflistung wird dann an das Cmdlet ForEach-Object weitergeleitet, das alle Server in der Auflistung durchläuft und sie mithilfe von Import-CsDeviceUpdate mit den aktuellen Geräteaktualisierungsregeln aktualisiert. Beachten Sie, dass dieser Befehl nur funktioniert, wenn Sie "UCUpdates.cab" auf allen Ihren Servern an den gleichen Speicherort (C:\Updates) kopieren.