Condividi tramite

  • Articolo

Set-CsDeviceUpdateConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare una raccolta di impostazioni di configurazione di servizio Web di aggiornamento dispositivi. Queste impostazioni vengono utilizzate per gestire servizio Web di aggiornamento dispositivi, un componente di Microsoft Lync Server 2010 che consente agli amministratori di distribuire aggiornamenti firmware ai telefoni e ad altri dispositivi su cui è installato Microsoft Lync 2010 Phone Edition.

Sintassi

Set-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

servizio Web di aggiornamento dispositivi consente agli amministratori di distribuire aggiornamenti firmware ai dispositivi su cui è installato Microsoft Lync 2010 Phone Edition. Periodicamente, gli amministratori caricano un gruppo di regole di aggiornamento dei dispositivi su Microsoft 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. I dispositivi verificano la disponibilità di aggiornamenti quando vengono accessi per la prima volta e di nuovo quando un utente si collega. Successivamente, controllano la disponibilità di aggiornamenti ogni 24 ore.

Le impostazioni di configurazione per l'aggiornamento dei dispositivi possono essere applicate nell'ambito globale o del sito. Il cmdlet Set-CsDeviceUpdateConfiguration consente di modificare una raccolta di impostazioni. Ad esempio, è possibile utilizzare questo cmdlet per modificare per quanto tempo viene conservato un file di registrazione prima che venga eliminato automaticamente dal sistema.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Identificatore univoco delle impostazioni di configurazione per l'aggiornamento del dispositivo da modificare. Per ottenere le impostazioni globali, utilizzare la seguente sintassi: -Identity global. Per ottenere le impostazioni del sito, utilizzare una sintassi simile alla seguente: -Identity "site:Redmond". Si noti che non è consentito utilizzare i caratteri jolly per specificare l'identità.

Instance

Facoltativo

Oggetto DeviceUpdateSettings

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

LogCleanUpInterval

Facoltativo

Durata

Consente di specificare il periodo di tempo in cui un file di registro per l'aggiornamento del dispositivo viene mantenuto prima che venga eliminato dal sistema.

Il valore deve essere immesso nel formato gg.hh:mm:ss, dove gg è il numero di giorni, hh è il numero di ore, mm è il numero di minuti e ss è il numero di secondi. Per immettere solo i giorni, è necessario immettere dopo il valore un punto (.).

Valore minimo: 1.00:00:00 (1 giorno)

Valore massimo: 365.00:00:00 (1 anno)

Valore predefinito: 10.00:00:00 (10 giorni)

LogCleanUpTimeOfDay

Facoltativo

Data/ora

Indica l'ora e il giorno in cui il sistema controlla la presenza di eventuali file di registro scaduti che è necessario eliminare. I file di registro "scaduti" sono tutti quei file più vecchi del valore specificato per la proprietà LogCleanupInterval.

Il valore specificato per il parametro LogCleanupTimeOfDay deve essere nel formato 24 ore hh:mm, dove hh indica le ore e mm i minuti. In questo formato, 00:00 indica la mezzanotte; 08:30 indica le otto e trenta di mattina e 23:52 indica le undici e cinquantadue di sera.

LogFlushInterval

Facoltativo

Durata

Indica la frequenza con cui le informazioni archiviate nella cache del file di registro vengono scritte nel file di registro effettivo. Per impostazione predefinita, le informazioni sull'aggiornamento del dispositivo non vengono scritte immediatamente nel file di registro, ma vengono memorizzate nella cache finché: 1) l'intervallo di tempo flush del registro non scade; 2) la cache non raggiunge la dimensione massima. Se questo valore è impostato su 10 minuti (00:10:00), le informazioni nella cache verranno scritte nel file di registro ogni 10 minuti. Dopo aver registrato i dati, la cache verrà eliminata.

Il valore deve essere immesso nel formato hh:mm:ss, dove hh è il numero di ore, mm è il numero di minuti e ss è il numero di secondi.

Valore minimo: 00:01:00 (1 minuto)

Valore massimo: 1:00:00 (1 ora)

Valore predefinito: 00:05:00

MaxLogCacheLimit

Facoltativo

Numero intero

Indica il numero massimo di informazioni (in byte) che è possibile contenere nella cache del file di registro prima di essere eliminata e prima che i dati vengano scritti nel file di registro. Per impostazione predefinita, i file di registro vengono scaricati ogni 5 minuti. Per ulteriori informazioni, fare riferimento alla descrizione del parametro LogFlushInterval. Tuttavia, se la cache raggiunge la dimensione massima, le informazioni in essa contenute verranno scritte automaticamente nel file di registro (e la cache verrà svuotata) anche se non è ancora scaduto l'intervallo flush del registro.

Valore predefinito: 512000

MaxLogFileSize

Facoltativo

Numero intero

Indica la dimensione massima, in byte, di un file di registro. Quando un file raggiunge la dimensione massima, il batch successivo di dati viene scritto automaticamente in un nuovo file di registro. Il file di registro precedente verrà mantenuto finché non scade l'intervallo di pulizia del registro.

Valore predefinito: 1024000

ValidLogFileExtensions

Facoltativo

Modificatore dell'elenco PS

Indica le estensioni del file di registro valide che possono essere utilizzate con il Servizio Aggiornamento dispositivi. Questo elenco può essere modificato. Tuttavia, non vi è alcun motivo per modificarlo a meno che non si utilizzi un dispositivo compatibile con Lync 2010 Phone Edition che consente di creare file di registro che utilizzano un'estensione file diversa.

Valore predefinito: .dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex

ValidLogFileTypes

Facoltativo

Modificatore dell'elenco PS

Indica i tipi di file di registro mantenuti dal sistema di aggiornamento dei dispositivi. I tipi di file predefiniti comprendono:

Watson. File di registro creati automaticamente da un dispositivo nel caso si verifichi un arresto anomalo del sistema.

Config. I profili dispositivo per conferenze Microsoft RoundTable che vengono creati ogni volta che si configura dispositivo RoundTable.

DiagLog. Dati di autodiagnostica per dispositivi RoundTable.

CELog. Registri per telefoni con Lync 2010 che contengono i risultati dei test funzionali e un record di eventi di sistema critici.

È possibile aggiungere altri tipi di file se si dispone di un dispositivo compatibile con Lync 2010 Phone Edition che crea un diverso tipo di file di registro. È anche possibile rimuovere file. Ad esempio, se non si desidera archiviare i file CELog, è possibile rimuovere il tipo di file CELog.

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.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration. Set-CsDeviceUpdateConfiguration accetta le istanze dell'oggetto configurazione di aggiornamento dei dispositivi inviate tramite pipeline.

Tipi restituiti

Set-CsDeviceUpdateConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Esempio

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

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

Nell'Esempio 1 viene illustrato come è possibile utilizzare Set-CsDeviceUpdateConfiguration per modificare le impostazioni di configurazione globali. In questo caso, vengono modificati due valori della proprietà: la proprietà MaxLogFileSize è impostata su 2048000 byte e la proprietà MaxLogCacheLimit su 1024000 byte.

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

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

Il comando precedente consente di modificare la proprietà LogFlushInterval per le impostazioni di configurazione per l'aggiornamento del dispositivo con Identity site:Redmond. Per ottenere questo risultato, il parametro Identity viene utilizzato per specificare le impostazioni nel sito Redmond e il parametro LogFlushInterval viene utilizzato per indicare il valore della proprietà da modificare. In questo caso, LogFlushInterval è impostato su 2 minuti (00 ore: 02 minuti: 00 secondi).

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

Nell'Esempio 3, vengono modificate tutte le impostazioni di configurazione per l'aggiornamento del dispositivo nell'organizzazione in modo tale che LogCleanUpInterval venga impostato su 14 giorni. Per ottenere questo risultato, viene utilizzato prima Get-CsDeviceUpdateConfiguration per recuperare una raccolta di tutte le impostazioni di configurazione per l'aggiornamento del dispositivo. Questa raccolta viene quindi inviata tramite pipe al cmdlet Set-CsDeviceUpdateConfiguration, che utilizza il parametro LogCleanUpInterval per impostare l'intervallo di pulizia del registro per ogni elemento della raccolta su 14 giorni (14 giorni : 00 ore : 00 minuti : 00 secondi).

-------------------------- Esempio 4 --------------------------

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

Nell'Esempio 4 viene illustrato come è possibile modificare il valore di una proprietà per tutte le impostazioni di configurazione per l'aggiornamento del dispositivo configurate nell'ambito del sito. In questo caso, il comando imposta LogCleanUpInterval su 20 giorni (20 giorni : 00 ore : 00 minuti : 00 secondi). Per eseguire questa operazione, viene utilizzato il cmdlet Get-CsDeviceUpdateConfiguration insieme al parametro Filter; il valore del filtro "site:*" restituisce solo i dati relativi alle impostazioni la cui identità inizia con il valore "site:". La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsDeviceUpdateConfiguration, che modifica il valore dell'intervallo di pulizia del registro per ogni elemento nella raccolta.

-------------------------- Esempio 5 --------------------------

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

Il comando precedente consente di rimuovere CELog dall'elenco dei tipi di file di registro validi utilizzato dalle impostazioni di configurazione per l'aggiornamento del dispositivo. In questo comando, viene utilizzato prima Get-CsDeviceUpdateConfiguration per recuperare una raccolta di tutte le impostazioni di configurazione per l'aggiornamento del dispositivo al momento utilizzate nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Set-CsDeviceUpdateConfiguration, che utilizza il parametro ValidLogFileTypes per rimuovere CELog dall'elenco dei tipi di file di registro validi. Il valore del parametro specificato per ValidLogFileTypes, @{Remove="CELog"}, consente a Set-CsDeviceUpdateConfiguration di eliminare CELog dal gruppo dei tipi di file validi. Per rimuovere più tipi di file in un unico comando, includere i tipi aggiuntivi nell'elenco, separandoli con la virgola. Ad esempio:

@{Remove="CELog","Watson"}