New-CsTestDevice
Ultima modifica dell'argomento: 2012-03-26
Consente di creare un nuovo dispositivo di test per la gestione degli aggiornamenti dei dispositivi. I dispositivi di test consentono agli amministratori di testare gli aggiornamenti del firmware prima di distribuirlo a tutti i dispositivi di un'organizzazione.
Sintassi
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>]]
Descrizione dettagliata
Identificando specifici telefoni compatibili con Microsoft Lync 2010 Phone Edition o altri dispositivi come dispositivi di test, gli amministratori possono verificare e approvare gli aggiornamenti del firmware prima che essi vengono installati sui dispositivi di pertinenza dell'organizzazione. Una volta importate le regole di aggiornamento del dispositivo in Microsoft Lync Server 2010, queste regole vengono contrassegnata 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. Questi dispositivi possono essere configurati nell'ambito globale o del sito.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-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 "New-CsTestDevice"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Indica l'identità per il nuovo dispositivo di test. L'identità è composta dall'ambito a cui è assegnato il dispositivo di test (ad esempio, site:Redmond) e dal nome del nuovo dispositivo (ad esempio, UCPhone). Per assegnare un dispositivo di test denominato UCPhone al sito Redmond, il parametro Identity deve essere impostato nel seguente modo: -Identity "site:Redmond/UCPhone". |
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 l'indirizzo MAC può 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. |
Name |
Facoltativo |
Stringa |
Nome del nuovo dispositivo di test (i nomi devono essere univoci in un dato ambito). Il parametro Name deve essere utilizzato solo quando è specificato il parametro Parent. |
Parent |
Facoltativo |
Stringa |
Nome dell'ambito (ad esempio, site:Redmond) a cui verrà assegnato il nuovo dispositivo di test. Se si utilizza il parametro Parent, è necessario specificare anche il parametro Name; ad esempio: -Parent site:Redmond –Name UCPhone. Se si utilizza il parametro Parent, non si deve specificare il parametro Identity e viceversa. |
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. |
InMemory |
Facoltativo |
Parametro opzionale |
Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente. |
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
Nessuno. New-CsTestDevice non accetta input tramite pipeline.
Tipi restituiti
Crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Esempio
-------------------------- Esempio 1 ------------------------
New-CsTestDevice -Identity site:Redmond/UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
Il comando precedente consente di creare un nuovo dispositivo di test (con nome UCPhone) per il sito Redmond. Si noti la sintassi usata per specificare l'identità del dispositivo: ambito del dispositivo (site:Redmond) seguito dal carattere / e quindi dal nome del dispositivo (UCPhone). Questo dispositivo utilizza il suo numero di serie (07823-A345) come identificativo (IdentifierType).
-------------------------- Esempio 2 ------------------------
New-CsTestDevice -Parent Redmond -Name UCPhone -IdentifierType SerialNumber -Identifier "07823-A345"
Il comando riportato nell'Esempio 2 è una variante del comando riportato nell'Esempio 1. Nell'Esempio 2, però, non viene utilizzato il parametro Identity. Al suo posto, viene utilizzato il parametro Parent per specificare l'ambito del nuovo dispositivo di test (site:Redmond) e il parametro Name per indicare il nome del nuovo dispositivo (UCPhone). Il cmdlet New-CsTestDevice utilizzerà i valori di questi due parametri per ricavare automaticamente l'identità del dispositivo di test (site:Redmond/UCPhone).