Condividi tramite

  • Articolo

Restore-CsDeviceUpdateRule

 

Ultima modifica dell'argomento: 2012-03-27

Consente di eseguire il rollback di una regola di aggiornamento dei dispositivi approvata per l'utilizzo nell'organizzazione. Quando si ripristina una regola di aggiornamento dei dispositivi, la versione approvata della regola viene ripristinata per riflettere l'aggiornamento che era in uso prima dell'approvazione della regola. A loro volta, i dispositivi client che si collegano al sistema disinstallano automaticamente l'aggiornamento più recente e scaricano e reinstallano la versione precedente dell'aggiornamento.

Sintassi

Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Restore-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 utilizza le regole di aggiornamento dei dispositivi come strumento per fornire gli aggiornamenti firmware ai dispositivi su cui è installato Lync 2010 Phone Edition. Periodicamente, gli amministratori caricano un set di regole di aggiornamento dei dispositivi su Lync Server 2010; dopo averle testate e approvate, queste regole vengono automaticamente scaricate e applicate ai dispositivi appropriati quando questi si collegano al sistema. Per impostazione predefinita, i dispositivi verificano la disponibilità di nuove regole di aggiornamento tutte le volte che vengono accesi e si collegano a Lync Server, i dispositivi verificano la presenza di aggiornamenti anche ogni 24 ore dopo l'accesso iniziale.

Ogni nuova regola di aggiornamento dei dispositivi aggiunta al sistema viene contrassegnata come "In sospeso". Ciò significa che l'aggiornamento verrà scaricato e installato dai dispositivi di test appropriati; tuttavia, non verrà scaricato e installato dai dispositivi client in generale. Ciò consente di testare gli aggiornamenti e verificare che non presentino problemi prima di distribuirli a tutti i dispositivi interessati. Non appena verificato che l'aggiornamento ha superato i test e funzionerà senza problemi nell'organizzazione, è possibile utilizzare il cmdlet Approve-CsDeviceUpdateRule per approvarlo.

Quando si approva un aggiornamento, alla proprietà ApprovedVersion viene assegnato il valore della proprietà PendingVersion della regola di aggiornamento associata e la proprietà PendingVersion viene cancellata. Ad esempio, si supponga che la proprietà PendingVersion di una nuova regola di aggiornamento sia la versione 1.0.0.1. Dopo l'esecuzione di Approve-CsDeviceUpdateRule, la proprietà PendingVersion verrà impostata su un valore nullo e la proprietà ApprovedVersion verrà impostata su 1.0.0.1. La prossima volta che un dispositivo client verificherà la presenza di aggiornamenti, questo aggiornamento verrà automaticamente scaricato ed installato.

Inoltre, eventuali versioni precedenti dell'aggiornamento (ad esempio, la versione 1.0.0.0) vengono contrassegnate come RestoreVersion. Questa versione dell'aggiornamento resta sul sistema e viene utilizzata nel caso sia necessario eseguire il rollback del nuovo aggiornamento. Se si verificano dei problemi, gli amministratori possono utilizzare il cmdlet Restore-CsDeviceUpdateRule per eseguire il rollback dell'aggiornamento. In questo caso, la prossima volta che un dispositivo client verificherà la presenza di aggiornamenti disinstallerà automaticamente il nuovo aggiornamento (versione 1.0.0.1) e reinstallerà l'aggiornamento precedente (1.0.0.0).

Si noti che questo è possibile solo se è disponibile un aggiornamento precedente da reinstallare. Se così non fosse, l'aggiornamento di cui si deve eseguire il rollback verrà semplicemente disinstallato.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Restore-CsDeviceUpdateRule 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 "Restore-CsDeviceUpdateRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco della regola di aggiornamento dei dispositivi da ripristinare. L'identità di una regola di aggiornamento dei dispositivi consta di due parti: il servizio a cui è stata assegnata la regola di aggiornamento dei dispositivi (ad esempio, service:WebServer:atl-cs-001.litwareinc.com) e un identificatore univoco globale (GUID). Di conseguenza, una regola di aggiornamento dei dispositivi configurata per il sito Redmond avrà un'identità simile alla seguente: service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Facoltativo

Oggetto DeviceUpdate.Rule

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro.

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.DeviceUpdate.Rule. Restore-CsDeviceUpdateRule accetta le istanze dell'oggetto regola di aggiornamento dei dispositivi inviate tramite pipeline.

Tipi restituiti

Nessuno. Il cmdlet Restore-CsDeviceUpdateRule ripristina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Esempio

-------------------------- Esempio 1 ------------------------

Restore-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

Il comando riportato nell'Esempio 1 consente di ripristinare la regola di aggiornamento dei dispositivi d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 trovata nel servizio WebServer:atl-cs-001.litwareinc.com.

-------------------------- Esempio 2 ------------------------

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Restore-CsDeviceUpdateRule

Il comando precedente ripristina tutte le regole di aggiornamento dei dispositivi configurate per il servizio WebServer:atl-cs-001.litwareinc.com. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsDeviceUpdateRule con il parametro Filter e il valore di filtro "WebServer:atl-cs-001.litwareinc.com*" per ottenere solo quelle regole che hanno un'identità che inizia con la stringa "WebServer:atl-cs-001.litwareinc.com". Per definizione, si tratta di tutte le regole di aggiornamento dei dispositivi assegnate al servizio WebServer:atl-cs-001.litwareinc.com. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Restore-CsDeviceUpdateRule che ripristina tutte le regole nella raccolta.

-------------------------- Esempio 3 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Restore-CsDeviceUpdateRule

L'Esempio 3 mostra come ripristinare tutte le regole di aggiornamento dei dispositivi per uno specifico marchio (LG-Nortel). Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsDeviceUpdateRule senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le regole di aggiornamento dei dispositivi attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo le regole in cui la proprietà Brand è uguale a (-eq) LG-Nortel. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Restore-CsDeviceUpdateRule, che ripristina ogni regola nella raccolta filtrata.