Get-CsTestDevice
Letztes Änderungsdatum des Themas: 2012-03-23
Ruft Informationen zu den Testgeräten für die Geräteaktualisierungsverwaltung ab, die für den Einsatz in Ihrer Organisation konfiguriert wurden. Testgeräte bieten Administratoren eine Möglichkeit zum Testen von Firmwareupdates, bevor diese an alle Geräte in einer Organisation verteilt werden.
Syntax
Get-CsTestDevice [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsTestDevice [-Filter <String>] [-LocalStore <SwitchParameter>]
Detaillierte Beschreibung
Durch das 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. Verwendungszweck von Testgeräten: 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 können auf globaler oder Standortebene zugewiesen werden. Mit dem Cmdlet Get-CsTestDevice können Sie Informationen zu Testgeräten abrufen, die derzeit für Ihre Organisation konfiguriert sind.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsTestDevice 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 "Get-CsTestDevice"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Gibt die Identität des zurückzugebenden Testgeräts an. Verwenden Sie die folgende Syntax, um auf ein einzelnes Gerät mit dem Namen "UCPhone" (gespeichert in der globalen Auflistung) zu verweisen: -Identity global/UCPhone. Verwenden Sie eine Syntax wie die folgende, um auf ein Gerät in einer Standortauflistung zu verweisen: -Identity site:Redmond/UCPhone. Zum Verweisen auf eine gesamte Auflistung lassen Sie den Gerätenamen weg. Die folgende Syntax gibt beispielsweise alle für den Standort "Redmond" konfigurierten Testgeräte zurück: -Identity site:Redmond. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. |
Filter |
Optional |
Zeichenfolge |
Ermöglicht die Verwendung von Platzhalterzeichen beim Angeben der zurückzugebenden Testgeräte. Verwenden Sie beispielsweise folgende Syntax, um alle auf Standortebene konfigurierten Testgeräteauflistungen zurückzugeben: -Filter "site:*". Zum Zurückgeben aller Geräte mit dem Begriff "EMEA" im Identitätswert verwenden Sie diese Syntax: -Filter "*EMEA*". "Filter" kann nur auf den Identitätswert der Testgeräteauflistung und nicht auf andere Auflistungseigenschaften angewendet werden. |
LocalStore |
Optional |
Switch-Parameter |
Ruft die Testgerätedaten aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt sie aus dem zentraler Verwaltungsspeicher selbst abzurufen. |
Eingabetypen
Keine. Get-CsTestDevice akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit Get-CsTestDevice werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice" zurückgegeben.
Beispiel
-------------------------- Beispiel 1 --------------------------
Get-CsTestDevice
In Beispiel 1 werden alle Testgeräte in der Organisation zurückgegeben. Bei Aufruf von Get-CsTestDevice ohne zusätzliche Parameter werden alle derzeit verwendeten Testgeräte zurückgegeben.
-------------------------- Beispiel 2 --------------------------
Get-CsTestDevice -Identity site:Redmond/UCPhone
Das vorherige Beispiel gibt das Testgerät "UCPhone" zurück, das dem Standort "Redmond" zugewiesen war.
-------------------------- Beispiel 3 --------------------------
Get-CsTestDevice -Identity site:Redmond
In Beispiel 3 gibt der Befehl alle für den Standort "Redmond" konfigurierten Testgeräte zurück.
-------------------------- Beispiel 4 --------------------------
Get-CsTestDevice -Filter site:*
Mit dem vorstehenden Befehl werden alle auf Standortebene konfigurierten Testgeräte zurückgegeben. Hierzu wird der Befehl mit dem Parameter "Filter" aufgerufen. Der Filterwert "site:*" beschränkt die zurückgegebenen Daten auf Testgeräte, deren Identitätswert mit der Zeichenfolge "site:" beginnt.