Remove-CsTestDevice
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt das angegebene Testgerät für die Verwaltung von Geräteaktualisierungen. Testgeräte bieten Administratoren eine Möglichkeit zum Testen von Firmwareupdates, bevor diese an alle Geräte in einer Organisation verteilt werden.
Syntax
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Durch Bestimmen spezifischer Microsoft Lync 2010 Phone Edition-kompatibler Telefone oder anderer Geräte als Testgeräte können Administratoren Firmwareupdates überprüfen und genehmigen, bevor diese Updates auf alle betreffenden Geräte in der Organisation aufgespielt werden. Wenn Geräteaktualisierungsregeln in Microsoft Lync Server 2010 importiert werden, werden diese als "Ausstehend" markiert, was bedeutet, dass die zu diesen Regeln gehörenden Updates von den betreffenden Geräten nicht automatisch heruntergeladen und installiert werden.
Stattdessen werden diese mit "Ausstehend" markierten Regeln heruntergeladen und von in Frage kommenden Testgeräten installiert. Testgeräte erfüllen folgenden Zweck: Neue Geräteaktualisierungsregeln werden automatisch auf Testgeräte angewendet, damit Administratoren überprüfen können, ob die Firmwareupdates erwartungsgemäß funktionieren. Falls ja, können diese Administratoren die Regeln als genehmigt markieren. Anschließend werden genehmigte Regeln von allen betreffenden Geräten in der Organisation heruntergeladen und installiert.
Testgeräte sind Hardwaregeräte, auf denen Lync 2010 Phone Edition ausgeführt wird. Diese Geräte werden mit dem Cmdlet New-CsTestDevice erstellt. Später können die Geräte mit dem Cmdlet Remove-CsTestDevice entfernt werden. Beachten Sie, dass das Entfernen eines Testgeräts sich nicht auf das tatsächliche Gerät auswirkt. Ein mit Lync 2010 Phone Edition kompatibles Telefon kann beispielsweise weiterhin für den Zugriff auf Lync Server 2010 verwendet werden. Der einzige Unterschied besteht darin, dass das Gerät nicht länger als Testgerät eingestuft wird und daher keine Geräteaktualisierungsregeln mehr herunterlädt, die sich im Status "Ausstehend" befinden. Stattdessen lädt das Gerät Regeln erst dann herunter und installiert sie, wenn die Regeln genehmigt wurden.
Mit Remove-CsTestDevice können einzelne Testgeräte entfernt werden, die entweder auf globaler oder auf Standortebene konfiguriert wurden. Sie können das Cmdlet auch dazu verwenden, alle Testgeräte für einen bestimmten Bereich zu entfernen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsTestDevice 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-CsTestDevice"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Gibt den Identitätswert des zu entfernenden Geräts an. Um ein bestimmtes Gerät zu entfernen, geben Sie sowohl den Bereich (z. B. "site:Redmond") als auch den Gerätenamen an. Beispiel: -Identity "site:Redmond/UCPhoneTest". Verwenden Sie eine Syntax wie die folgende, um alle Geräte aus einem bestimmten Standort zu entfernen: -Identity "site:Redmond". Testgeräte können auch auf globaler Ebene entfernt werden. Die globale Auflistung von Testgeräten selbst kann nicht entfernt werden; allerdings können mit dem folgenden Befehl alle Geräte gelöscht werden, die in der globalen Auflistung enthalten sind: Remove-CsTestDevice –Identity global |
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.TestDevice-Objekt. Remove-CsTestDevice akzeptiert eine weitergeleitete Eingabe von Testgerätobjekten.
Rückgabetypen
Remove-CsTestDevice gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice" gelöscht.
Beispiel
-------------------------- Beispiel 1 ------------------------
Remove-CsTestDevice -Identity site:Redmond
Mit dem vorstehenden Befehl werden alle Testgeräte aus dem Standort "Redmond" entfernt. Es werden sowohl die Geräteauflistung als auch die einzelnen Testgeräte entfernt.
-------------------------- Beispiel 2 ------------------------
Get-CsTestDevice | Remove-CsTestDevice
Der in Beispiel 2 gezeigte Befehl entfernt alle Testgeräte, die in der Organisation konfiguriert wurden. Dies wird erreicht, indem mit dem Cmdlet Get-CsTestDevice zunächst alle Testgeräteauflistungen zurückgegeben und diese Elemente anschließend an Remove-CsTestDevice weitergeleitet werden. Beachten Sie, dass die globale Auflistung der Testgeräte nicht entfernt werden kann. Mit diesem Befehl werden die einzelnen Testgeräte entfernt, die auf globaler Ebene konfiguriert wurden.
-------------------------- Beispiel 3 ------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
In Beispiel 3 werden alle auf Standortebene konfigurierten Testgeräte entfernt. Hierzu wird das Cmdlet Get-CsTestDevice mit dem Parameter "Filter" ausgeführt, um alle Testgeräte zurückzugeben, deren Identitätswert mit der Zeichenfolge "site:" beginnt. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsTestDevice weitergeleitet, das alle Elemente in der Auflistung löscht.
-------------------------- Beispiel 4 ------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
Der in Beispiel 4 gezeigte Befehl löscht alle Testgeräte, deren Name die Zeichenfolge "LG-Nortel" enthält. Hierzu ruft der Befehl zunächst Get-CsTestDevice auf, um alle Testgeräte zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Informationen werden an das Cmdlet Where-Object weitergeleitet, das mit dem Operator "-match" Geräte zurückgibt, die an beliebiger Stelle in der Eigenschaft "Name" die Zeichenfolge "LG-Nortel" aufweisen. Alle Testgeräte, die dieses Kriterium erfüllen, werden anschließend mit Remove-CsTestDevice gelöscht.