Remove-CsTestDevice
Ultima modifica dell'argomento: 2012-03-27
Rimuove il dispositivo di test di gestione dell'aggiornamento dei dispositivi specificato. I dispositivi di test consentono agli amministratori di eseguire il test degli aggiornamenti firmware, prima che questi vengano distribuiti a tutti i dispositivi dell'organizzazione.
Sintassi
Remove-CsTestDevice -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Se particolari telefoni compatibili con Microsoft Lync 2010 Phone Edition o altri dispositivi vengono identificati come dispositivi di test, gli amministratori possono verificare e approvare gli aggiornamenti del firmware prima che questi vengano applicati a tutti i relativi dispositivi nell'organizzazione. Una volta importate in Microsoft Lync Server 2010, le regole di aggiornamento dei dispositivi vengono contrassegnate come "in sospeso". Questo significa che gli aggiornamenti che corrispondono a tali regole non verranno scaricati e installati automaticamente dai dispositivi interessati.
Al contrario, queste regole in sospeso verranno scaricate e installate in tutti i relativi dispositivi di test. Il concetto alla base dei dispositivi di test è il seguente: le nuove regole di aggiornamento dei dispositivi vengono applicate automaticamente ai dispositivi di test, offrendo agli amministratori la possibilità di verificare che gli aggiornamenti del firmware funzionino come previsto. In tal caso, gli amministratori possono contrassegnare tali regole come approvate; una volta approvate, queste regole vengono scaricate e installate in tutti i relativi dispositivi dell'organizzazione.
I dispositivi di test sono dispositivi hardware che eseguono Lync 2010 Phone Edition. Vengono creati utilizzando il cmdlet New-CsTestDevice. Una volta creati, questi dispositivi possono essere rimossi eseguendo il cmdlet Remove-CsTestDevice. Si noti che la rimozione del dispositivo come dispositivo di test non influisce sul dispositivo in sé. Sarà possibile ad esempio continuare a utilizzare il telefono compatibile con Lync 2010 Phone Edition per accedere a Lync Server 2010. L'unica differenza consiste nel fatto che, non essendo più un dispositivo di test, non sarà possibile scaricare le regole di aggiornamento del dispositivo "in sospeso" nel dispositivo in questione. Al contrario, prima di poterle scaricare e installare, è necessario attendere fino a quando queste regole non vengano approvate.
Per rimuovere i singoli dispositivi di test configurati nell'ambito globale o del sito, è possibile utilizzare il cmdlet Remove-CsTestDevice. È inoltre possibile utilizzare questo cmdlet per rimuovere tutti i dispositivi di test configurati in un particolare ambito.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsTestDevice i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTestDevice"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Indica l'identità del dispositivo di test da rimuovere. Per rimuovere un dispositivo specifico, includere sia l'ambito, ad esempio site:Redmond, che il nome del dispositivo, ad esempio -Identity "site:Redmond/UCPhoneTest". Per rimuovere tutti i dispositivi da un particolare sito, utilizzare la sintassi: -Identity "site:Redmond". È possibile rimuovere i dispositivi di test anche dall'ambito globale. La raccolta di dispositivi di test globale non può essere rimossa. Il seguente comando tuttavia eliminerà tutti i dispositivi archiviati nella raccolta globale: Remove-CsTestDevice –Identity global |
Force |
Facoltativo |
Parametro opzionale |
Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'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. Remove-CsTestDevice accetta l'input da pipeline dell'oggetto dispositivo di test.
Tipi restituiti
Remove-CsTestDevice non restituisce un valore o un oggetto. Il cmdlet piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.TestDevice.
Esempio
-------------------------- Esempio 1 ------------------------
Remove-CsTestDevice -Identity site:Redmond
Il comando precedente rimuove tutti i dispositivi di test dal sito Redmond. Questa operazione rimuove la raccolta di dispositivi, nonché i singoli dispositivi di test.
-------------------------- Esempio 2 ------------------------
Get-CsTestDevice | Remove-CsTestDevice
Il comando mostrato nell'esempio 2 rimuove tutti i dispositivi di test configurati per l'utilizzo nell'organizzazione. Questa operazione viene eseguita utilizzando Get-CsTestDevice per rimuovere tutte le raccolte di dispositivi di test e quindi inviando tutti questi elementi tramite pipe a Remove-CsTestDevice. Si noti che non è possibile rimuovere la raccolta globale di dispositivi di test, tuttavia, questo comando consente di rimuovere tutti i singoli dispositivi di test configurati a livello globale.
-------------------------- Esempio 3 ------------------------
Get-CsTestDevice -Filter "site:" | Remove-CsTestDevice
Nell' esempio 3 vengono rimossi tutti i dispositivi di test configurati nell'ambito del sito. Per eseguire questa attività, vengono utilizzati Get-CsTestDevice e il parametro Filter per restituire tutti i dispositivi di test con valore Identity che inizia con il valore stringa "site:". La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsTestDevice, che elimina tutti gli elementi della raccolta.
-------------------------- Esempio 4 ------------------------
Get-CsTestDevice | Where-Object {$_.Name -match "LG-Nortel Phone"} | Remove-CsTestDevice
Il comando mostrato nell'esempio 4 elimina tutti i dispositivi di test LG-Nortel Phone. A tale scopo, il comando chiama innanzitutto Get-CsTestDevice per restituire tutti i dispositivi di test configurati per l'utilizzo nell'organizzazione. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Where-Object, che utilizza l'operatore -match per restituire tutti i dispositivi con valore stringa "LG-Nortel" all'interno della proprietà Name. Tutti i dispositivi di test che soddisfano questo criterio verranno quindi eliminati tramite Remove-CsTestDevice.