Condividi tramite


Approve-CsDeviceUpdateRule

 

Ultima modifica dell'argomento: 2012-03-23

Approva una regola di aggiornamento dispositivi importata nel sistema. Dopo l'approvazione di una regola di aggiornamento dispositivi, l'aggiornamento corrispondente verrà scaricato e installato automaticamente dai dispositivi client interessati dall'aggiornamento.

Sintassi

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

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

Descrizione dettagliata

In Microsoft Lync Server 2010 le regole di aggiornamento dispositivi vengono utilizzate per fornire aggiornamenti del firmware per i dispositivi in cui è in esecuzione Lync 2010 Phone Edition. Gli amministratori periodicamente caricano un insieme di regole di aggiornamento dispositivi in Lync Server 2010. Una volta verificate e approvate, tali regole vengono scaricate e applicate automaticamente ai dispositivi appropriati non appena tali dispositivi si connettono al sistema. Per impostazione predefinita, i dispositivi verificano l'eventuale presenza di nuove regole di aggiornamento ogni volta che vengono accesi e si connettono a Lync Server 2010. Dopo tale accesso iniziale, i dispositivi verificano inoltre l'esistenza di aggiornamenti ogni 24 ore.

Ogni nuova regola di aggiornamento dispositivi aggiunta al sistema viene contrassegnata come "In sospeso". Ciò significa che l'aggiornamento verrà scaricato e installato dai dispositivi di test appropriati ma che non verrà scaricato e installato dai dispositivi client in generale. In questo modo sarà possibile verificare gli aggiornamenti e garantire che non vi siano effetti negativi prima di rendere l'aggiornamento ampiamente disponibile. Quando si è certi che l'aggiornamento abbia superato i test effettuati e funzioni all'interno dell'organizzazione, è possibile utilizzare Approve-CsDeviceUpdateRule per approvarlo.

Dopo aver approvato un aggiornamento, il valore di PendingVersion della regola di aggiornamento associata viene assegnato ad ApprovedVersion e la proprietà PendingVersion viene cancellata. Si supponga, ad esempio, che il valore di PendingVersion di una nuova regola di aggiornamento sia versione 1.0.0.1. Dopo aver eseguito Approve-CsDeviceUpdateRule, PendingVersion verrà impostato su un valore NULL e ApprovedVersion verrà impostato su 1.0.0.1. Al successivo accesso, il dispositivo client verificherà automaticamente la disponibilità di aggiornamenti recentemente approvati a esso applicabili. Se presenti, l'aggiornamento verrà scaricato e installato automaticamente.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Approve-CsDeviceUpdateRule 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 "Approve-CsDeviceUpdateRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Stringa

Identificatore univoco per la regola di aggiornamento dispositivi da approvare. L'identità di una regola di aggiornamento dispositivi è composta da due parti: il servizio in cui la regola di aggiornamento dispositivi è stata assegnata, ad esempio service:WebServer:atl-cs-001.litwareinc.com, e un identificatore univoco globale (GUID). Di conseguenza, una regola di aggiornamento dispositivi configurata per il sito Redmond avrà un parametro Identity simile al 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 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.DeviceUpdate.Rule. Approve-CsDeviceUpdateRule accetta istanze da pipeline dell'oggetto regola di aggiornamento dispositivi.

Tipi restituiti

Nessuno. Approve-CsDeviceUpdateRule piuttosto approva le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Esempio

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

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

Il comando mostrato nell'esempio 1 approva la regola di aggiornamento dispositivi d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 presente nel servizio WebServer:atl-cs-001.litwareinc.com.

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

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

Il comando precedente approva tutte le regole di aggiornamento dispositivi configurate per il servizio WebServer:atl-cs-001.litwareinc.com. A tale scopo, il comando innanzitutto chiama Get-CsDeviceUpdateRule con il parametro Filter. Il valore di filtro "service:WebServer:atl-cs-001.litwareinc.com*" garantisce che vengano restituite solo le regole con un valore Identity che inizia con il valore stringa "service:WebServer:atl-cs-001.litwareinc.com". Per definizione, si tratta di tutte le regole di aggiornamento dispositivi assegnate al servizio WebServer:atl-cs-001.litwareinc.com. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Approve-CsDeviceUpdateRule, che approva ogni regola presente nella raccolta.

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

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

Il comando mostrato nell'esempio 3 approva tutte le regole di aggiornamento dispositivi per la marca specificata (LG-Nortel). A tale scopo, il comando innanzitutto chiama Get-CsDeviceUpdateRule per restituire una raccolta di tutte le regole di aggiornamento 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 LG-Nortel. La raccolta filtrata viene quindi inviata tramite pipe a Approve-CsDeviceUpdateRule, che approva ogni regola presente nella raccolta.