New-CsTestDevice
Letztes Änderungsdatum des Themas: 2012-03-26
Erstellt ein neues 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
New-CsTestDevice -Identity <XdsIdentity> -Identifier <String> -IdentifierType <MACAddress | SerialNumber> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
New-CsTestDevice -Identifier <String> -IdentifierType <MACAddress | SerialNumber> -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Durch das Festlegen 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 die 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 werden mit dem Cmdlet New-CsTestDevice erstellt. Diese Geräte können entweder auf globaler Ebene oder auf Standortebene konfiguriert werden.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsTestDevice"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Gibt den Identitätswert für das neue Testgerät an. Ein Identitätswert umfasst den Bereich, dem das Testgerät zugewiesen werden soll (z. B. "site:Redmond"), und den Namen für das neue Gerät (z. B. "UCPhone"). Wenn Sie ein Testgerät mit dem Namen "UCPhone" dem Standort "Redmond" zuweisen möchten, muss der Parameter "Identity" folgendermaßen lauten: -Identity "site:Redmond/UCPhone". |
Identifier |
Erforderlich |
Zeichenfolge |
Gibt basierend auf "IdentifierType" die MAC-Adresse (Media Access Control) oder Seriennummer des neuen Testgeräts an. Seriennummern können unter Verwendung von Zahlen, Buchstaben, Bindestrichen und Unterstrichen angegeben werden, z. B.: -Identifier "AB37_679e" MAC-Adressen müssen aus sechs oder mehr Paaren mit je zwei Zeichen angegeben werden. Je nach MAC-Adresse kann es sich um einen einzelnen Zeichenfolgenwert oder um Zeichenpaare handeln, die durch Bindestriche oder Doppelpunkte getrennt sind. (Beachten Sie, dass MAC-Adressen sowohl Buchstaben als auch Zahlen enthalten können.) Bei jeder der folgenden Adressen handelt es sich um eine gültige MAC-Adresse: 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Eine Mac-Adresse wie z. B. "01-02-03-04-05" wird nicht akzeptiert, da sie anstelle der erforderlichen sechs Paare nur fünf Paare mit je zwei Zeichen enthält. |
IdentifierType |
Erforderlich |
Zeichenfolge |
Gibt an, ob das Testgerät durch seine MAC-Adresse oder durch seine Seriennummer eindeutig identifiziert wird. Legen Sie "IdentifierType" auf "MACAddress" fest, um ein Gerät anhand seiner MAC-Adresse zu identifizieren. Um ein Gerät anhand seiner Seriennummer zu identifizieren, legen Sie "IdentifierType" auf "SerialNumber" fest. "MACAddress" und "SerialNumber" sind die einzigen zulässigen Werte. |
Name |
Optional |
Zeichenfolge |
Der Name des neuen Testgeräts (Namen müssen innerhalb eines Bereichs eindeutig sein). Der Parameter "Name" sollte nur verwendet werden, wenn der Parameter "Parent" verwendet wird. |
Parent |
Optional |
Zeichenfolge |
Name des Bereichs (z. B. "site:Redmond"), dem das neue Testgerät zugewiesen werden soll. Wenn Sie den Parameter "Parent" verwenden, müssen Sie auch den Parameter "Name" verwenden. Beispiel: -Parent site:Redmond –Name UCPhone. Wenn Sie den Parameter "Parent" verwenden, sollten Sie nicht den Parameter "Identity" verwenden, und umgekehrt. |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
InMemory |
Optional |
Switch-Parameter |
Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen. |
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. New-CsTestDevice akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice".
Beispiel
-------------------------- Beispiel 1 ------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
Mit dem vorstehenden Befehl wird ein neues Testgerät mit dem Namen "UCPhone" für den Standort "Redmond" erstellt. Beachten Sie die Syntax, mit der der Identitätswert des Geräts angegeben wird: der Gerätebereich (site:Redmond), gefolgt von dem Zeichen "/" und dem Gerätenamen (UCPhone). Das Gerät verwendet die Seriennummer als "IdentifierType" und weist die Seriennummer 07823-A345 auf.
-------------------------- Beispiel 2 ------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
Der Befehl in Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In Beispiel 2 wird der Parameter "Identity" jedoch nicht verwendet. Stattdessen werden mit dem Parameter "Parent" der Bereich für das neue Testgerät (site:Redmond) und mit dem Parameter "Name" der Name des neuen Geräts (UCPhone) angeben. Das Cmdlet New-CsTestDevice erstellt aus diesen beiden Parameterwerten den Identitätswert des Testgeräts (site:Redmond/UCPhone).