Condividi tramite

  • Articolo

New-CsDeviceUpdateConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare una nuova istanza delle impostazioni di configurazione per l'aggiornamento dei 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

New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 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. 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, utilizzate per gestire servizio Web di aggiornamento dispositivi, possono essere assegnate a livello globale o nell'ambito del sito. Per creare una nuova raccolta di impostazioni per un sito, utilizzare il cmdlet New-CsDeviceUpdateConfiguration. Si noti che è possibile creare le nuove impostazioni solo nell'ambito del sito; il comando avrà esito negativo se si cerca di creare una nuova raccolta di impostazioni nell'ambito globale. Inoltre, il comando avrà esito negativo se si cerca di creare una nuova raccolta di impostazioni per il sito Redmond e quel sito ospita già una raccolta di impostazioni di configurazione per l'aggiornamento dei dispositivi. Ciò perché per ogni sito è possibile avere solo una raccolta di impostazioni di configurazione per l'aggiornamento dei dispositivi.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Indica l'identità delle nuove impostazioni di configurazione per l'aggiornamento dei dispositivi. Dal momento che le nuove impostazioni possono essere create solo nell'ambito del sito, il parametro Identity sarà simile al seguente: -Identity "site:Redmond".

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. Il valore predefinito è Null.

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 dei dispositivi 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

UInt32

Indica il numero massimo di informazioni (in byte) che la cache del file di registro può contenere prima che sia necessario svuotarla e scrivere i dati in un file di registro. Per impostazione predefinita, i file di registro vengono scaricati ogni X 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

UInt32

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 servizio Web di aggiornamento dispositivi. Questo elenco può essere modificato. Tuttavia, non vi è alcun motivo per modificarlo a meno che non si utilizzi un dispositivo con Lync 2010 Phone Edition che crea 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 generati automaticamente da un dispositivo se il sistema smette di rispondere.

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 degli eventi di sistema critici.

È possibile aggiungere altri tipi di file se si dispone di un dispositivo 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.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno. New-CsDeviceUpdateConfiguration non accetta input tramite pipeline.

Tipi restituiti

Il cmdlet New-CsDeviceUpdateConfiguration crea le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Esempio

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond

Il comando riportato nell'Esempio 1 consente di creare un nuovo gruppo di impostazioni di configurazione per l'aggiornamento dei dispositivi con Identity site:Redmond. Dal momento che nel comando non sono inclusi altri parametri, questa nuova raccolta di impostazioni di configurazione utilizzerà i valori predefiniti per ogni proprietà.

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00

Anche il comando precedente consente di creare un nuovo gruppo di impostazioni di configurazione per l'aggiornamento dei dispositivi con Identity site:Redmond. In questo caso, vengono utilizzati due altri parametri per personalizzare le nuove impostazioni: MaxLogFileSize consente di impostare la dimensione massima del file di registro su 2048000 byte, mentre LogCleanUpInterval consente di impostare l'intervallo di pulizia del registro su 7 giorni (7 giorni . 00 ore : 00 minuti : 00 secondi).