Set-CsTestDevice
Ultima modifica dell'argomento: 2012-03-25
Consente di modificare uno o più dispositivi di test per la gestione degli aggiornamenti dei dispositivi configurati per l'utilizzo nella propria organizzazione. I dispositivi di test consentono agli amministratori di testare gli aggiornamenti del firmware prima di distribuirli a tutti i dispositivi di un'organizzazione.
Sintassi
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>]]
Descrizione dettagliata
Identificando particolare telefoni che utilizzano Microsoft Lync 2010 Phone Edition o altri dispositivi come dispositivi di test, gli amministratori possono verificare e approvare gli aggiornamenti firmware, prima che questi vengano applicati a tutti i relativi dispositivi dell'organizzazione. Una volta importate le regole di aggiornamento del dispositivo in Microsoft Lync Server 2010, queste regole vengono contrassegnate come "in sospeso"; ciò significa che gli aggiornamenti che corrispondono a tali regole non vengono scaricati e installati automaticamente nei dispositivi interessati.
Per contro, tali regole in sospeso vengono scaricate e installate dai dispositivi di test designati. L'idea generale alla base dei dispositivi di test è la seguente: le nuove regole di aggiornamento del dispositivo vengono applicate automaticamente ai dispositivi di test, offrendo agli amministratori la possibilità di verificare che gli aggiornamenti firmware funzionino nel modo appropriato. Se gli aggiornamenti funzionano, gli amministratori possono contrassegnare le regole come approvate; le regole approvate vengono quindi scaricate e installate da tutti i dispositivi pertinenti dell'organizzazione.
I dispositivi di test vengono creati utilizzando il cmdlet New-CsTestDevice. Una volta creato un dispositivo di test, è possibile utilizzare il cmdlet Set-CsTestDevice per modificare il valore di Identifier e IdentifierType di quel dispositivo o di qualunque altro dispositivo di test.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsTestDevice può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsTestDevice"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Indica l'identità del dispositivo di test da modificare. Ad esempio: -Identity site:Redmond/UCPhoneTestDevice. Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità. |
Instance |
Facoltativo |
Oggetto dispositivo di test |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
Identifier |
Obbligatorio |
Stringa |
In base al valore di IdentifierType, indica l'indirizzo MAC (Media Access Control) o il numero di serie del nuovo dispositivo di test. I numeri di serie possono essere specificati utilizzando numeri, lettere, trattini e sottolineature ad esempio: -Identifier "AB37_679e" Gli indirizzi MAC devono essere specificati sotto forma di sei o più coppie di caratteri; a seconda del tipo di indirizzo MAC, queste coppie di caratteri possono essere unite insieme in una singola stringa oppure essere separate da trattini o due punti. Si noti che gli indirizzi MAC possono includere lettere e/o numeri. Ciascuno dei seguenti esempi rappresenta un indirizzo MAC valido: 010203040506 01-02-03-04-05-06 01:02:03:04:05:06 Un indirizzo MAC come 01-02-03-04-05 non può essere accettato poiché non comprende almeno sei coppie di caratteri. |
IdentifierType |
Obbligatorio |
Stringa |
Indica se il dispositivo di test sarà univocamente identificato tramite il suo indirizzo MAC o il suo numero di serie. Per identificare un dispositivo tramite il suo indirizzo MAC, impostare IdentifierType su MACAddress. Per identificare un dispositivo tramite il suo numero di serie, impostare IdentifierType su SerialNumber. MACAddress e SerialNumber sono i soli valori consentiti. |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice. Set-CsTestDevice accetta input tramite pipeline dall'oggetto dispositivo di test.
Tipi restituiti
Set-CsTestDevice non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Esempio
-------------------------- Esempio 1 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -Identifier "09768-ABDR-83295"
Il comando precedente consente di modificare la proprietà Identifier del dispositivo di testo denominato UCPhone assegnato al sito Redmond.
-------------------------- Esempio 2 --------------------------
Set-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "09768-ABDR-83295"
Il comando riportato nell'Esempio 2 consente anche di modificare il dispositivo di test denominato UCPhone assegnato al sito Redmond. In questo caso, tuttavia, il comando non solo specifica un nuovo Identifier ma assegna anche un nuovo IdentifierType: SerialNumber