Condividi tramite

  • Articolo

Reset-CsDeviceUpdateRule

 

Ultima modifica dell'argomento: 2012-03-25

Consente di rifiutare una regola di aggiornamento dei dispositivi importata nel sistema.

Sintassi

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

Reset-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 gruppo di regole di aggiornamento dei dispositivi su Lync Server 2010. Una volta verificate e approvate, queste regole vengono scaricate e applicate automaticamente ai dispositivi appropriati non appena questi si collegano al sistema. Per impostazione predefinita, i dispositivi verificano la disponibilità di nuove regole di aggiornamento ogni volta che vengono accesi e si collegano a Lync Server. Inoltre, dopo l'accesso iniziale, i dispositivi verificano la disponibilità di aggiornamenti ogni 24 ore.

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.

Tuttavia, può anche accadere che gli amministratori decidano di non utilizzare un dato aggiornamento nell'organizzazione, perché, ad esempio, potrebbe provocare un conflitto con il software locale. In questo caso, gli amministratori possono utilizzare il cmdlet Reset-CsDeviceUpdateRule per rifiutare l'aggiornamento. Quando ciò accade, la proprietà PendingVersion della regola di aggiornamento viene impostata su un valore nullo. Di conseguenza, i dispositivi di test che accedono al sistema eseguiranno la disinstallazione dell'aggiornamento e reinstalleranno la sua versione approvata. Poiché l'aggiornamento non è mai stato approvato, non verrà mai installato su alcun dispositivo ad eccezione dei dispositivi di test e ciò significa che non avrà alcun impatto sugli utenti.

Il cmdlet Reset-CsDeviceUpdateRule può essere utilizzato solo per le regole di aggiornamento dei dispositivi con stato In sospeso. Se una regola è già stata approvata, sarà necessario utilizzare il cmdlet Restore-CsDeviceUpdateRule per annullare la distribuzione dell'aggiornamento ai dispositivi.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Reset-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 "Reset-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-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Instance

Facoltativo

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 prompt di conferma o messaggi di errore non irreversibile che possono verificarsi quando si esegue il cmdlet.

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

Tipi restituiti

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

Esempio

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

Reset-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*  | Reset-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, viene utilizzato 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 Reset-CsDeviceUpdateRule che ripristina tutte le regole nella raccolta.

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

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

Il comando riportato nell'Esempio 3 consente di ripristinare tutte le regole di aggiornamento dei dispositivi per la marca 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. A questo punto, la raccolta filtrata viene inviata tramite pipe al cmdlet Reset-CsDeviceUpdateRule che ripristina tutte le regole nella raccolta filtrata.