Set-CsTestDevice
Letztes Änderungsdatum des Themas: 2012-03-25
Ändert ein oder mehrere der für die Verwendung in Ihrer Organisation konfigurierten Testgeräte 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
Set-CsTestDevice [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-WhatIf [<SwitchParameter>]]
Set-CsTestDevice [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Identifier <String>] [-IdentifierType <MACAddress | SerialNumber>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Durch das Festlegen spezifischer Telefone mit Microsoft Lync 2010 Phone Edition 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 werden mit dem Cmdlet New-CsTestDevice erstellt. Nach der Erstellung eines Testgeräts können Sie mit dem Cmdlet Set-CsTestDevice den Wert von "Identifier" und/oder "IdentifierType" für dieses Gerät oder ein beliebiges anderes Testgerät ändern.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 "Set-CsTestDevice"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Optional |
XdsIdentity |
Gibt den Identitätswert des zu ändernden Geräts an. Beispiel: -Identity site:Redmond/UCPhoneTestDevice. Beachten Sie, dass beim Angeben eines Identitätswerts keine Platzhalterzeichen verwendet werden können. |
Instance |
Optional |
Testgerätobjekt |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
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. |
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. Set-CsTestDevice akzeptiert eine weitergeleitete Eingabe von Testgerätobjekten.
Rückgabetypen
Mit Set-CsTestDevice werden keine Werte oder Objekte zurückgegeben. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice" konfiguriert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
Der vorstehende Befehl ändert die Eigenschaft "Identifier" des Testgeräts "UCPhone", das dem Standort "Redmond" zugewiesen ist.
-------------------------- Beispiel 2 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
Der Befehl in Beispiel 2 ändert ebenfalls das Testgerät "UCPhone", das dem Standort "Redmond" zugewiesen ist. In diesem Fall gibt der Befehl aber nicht nur eine neue Eigenschaft "Identifier" an, sondern weist außerdem die neue Eigenschaft "IdentifierType" zu: SerialNumber.