Get-CsDeviceUpdateConfiguration
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni relative alle impostazioni di configurazione dell'aggiornamento dei dispositivi attualmente distribuite nell'organizzazione. Tali impostazioni consentono di gestire il servizio Web di aggiornamento dispositivi, un componente di Microsoft Lync Server 2010 grazie al quale gli amministratori possono distribuire gli aggiornamenti del firmware ai telefoni e ad altri dispositivi in cui è in esecuzione Microsoft Lync 2010 Phone Edition.
Sintassi
Get-CsDeviceUpdateConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDeviceUpdateConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrizione dettagliata
Il servizio Web di aggiornamento dispositivi consente agli amministratori di distribuire gli aggiornamenti del firmware ai dispositivi in cui è in esecuzione Lync 2010 Phone Edition. Gli amministratori periodicamente caricano un insieme di regole di aggiornamento dei dispositivi in Lync Server 2010. Una volta verificate e approvate, tali regole possono essere applicate ai dispositivi appropriati non appena questi si connettono al sistema. I dispositivi infatti verificano l'eventuale presenza di aggiornamenti inizialmente quando vengono accesi e quindi di nuovo quando un utente esegue l'accesso. Successivamente controllano la disponibilità di aggiornamenti ogni 24 ore.
Il servizio Web di aggiornamento dispositivi viene gestito mediante impostazioni di configurazione dei dispositivi che possono essere applicate nell'ambito globale o nell'ambito del sito. È possibile utilizzare il cmdlet Get-CsDeviceUpdateConfiguration per restituire informazioni relative alle impostazioni di configurazione dell'aggiornamento dei dispositivi attualmente in uso nell'organizzazione.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsDeviceUpdateConfiguration i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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
Parameter | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
Identità XDS |
Indica l'identità delle impostazioni di configurazione dell'aggiornamento dei dispositivi da recuperare. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per far riferimento alle impostazioni del sito, utilizzare una sintassi simile alla seguente: -Identity site:Redmond. Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity. Per poter utilizzare i caratteri jolly, è necessario includere il parametro Filter. |
Filter |
Facoltativo |
Filtro identità XDS |
Fornisce un modo per utilizzare i caratteri jolly per specificare le impostazioni di configurazione dell'aggiornamento dei dispositivi. Ad esempio, per restituire una raccolta di tutte le impostazioni di configurazione applicate nell'ambito del sito, utilizzare la seguente sintassi: -Filter "site:*". Per restituire tutte le impostazioni che presentano il termine "EMEA" nel valore Identity, utilizzare la seguente sintassi: -Filter "*EMEA*". Il parametro Filter agisce soltanto sul valore Identity delle impostazioni. Non è pertanto possibile filtrare in base ad altre proprietà di configurazione dell'aggiornamento dei dispositivi. |
LocalStore |
Facoltativo |
Parametro opzionale |
Recupera i dati di configurazione dell'aggiornamento dei dispositivi dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso. |
Tipi di input
Nessuno. Get-CsDeviceUpdateConfiguration non accetta l'input da pipeline.
Tipi restituiti
Get-CsDeviceUpdateConfiguration restituisce istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsDeviceUpdateConfiguration
Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi attualmente in uso nell'organizzazione. Chiamando Get-CsDeviceUpdateConfiguration senza ulteriori parametri, vengono restituite tutte le impostazioni di aggiornamento dei dispositivi attualmente in uso.
-------------------------- Esempio 2 ------------------------
Get-CsDeviceUpdateConfiguration -Identity Global
Nell'esempio 2 vengono restituite informazioni relative alle impostazioni globali di configurazione dell'aggiornamento dei dispositivi.
-------------------------- Esempio 3 ------------------------
Get-CsDeviceUpdateConfiguration -Filter site:*
Nell'esempio 3 viene mostrato l'utilizzo del parametro Filter. Con il valore "site:*" per il filtro viene restituita una raccolta di tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi applicate nell'ambito del sito; questo perché tali impostazioni presentano tutte un valore Identity che inizia con il valore stringa "site:".
-------------------------- Esempio 4 ------------------------
Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}
Con il comando precedente vengono restituite tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi in cui la proprietà MaxLogFileSize è maggiore di 2.048.000 byte. A tale scopo, viene utilizzato Get-CsDeviceUpdateConfiguration per restituire una raccolta di tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi attualmente in uso. Tale raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona soltanto le impostazioni nelle quali la proprietà MaxLogFileSize è maggiore di 2.048.000.
-------------------------- Esempio 5 ------------------------
Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}
Con il comando mostrato nell'esempio 5 vengono restituite tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi che includono "Watson" come tipo di file di registro valido. Per eseguire questa attività, viene utilizzato Get-CsDeviceUpdateConfiguration per restituire una raccolta di tutte le impostazioni di configurazione dell'aggiornamento dei dispositivi. Tale raccolta viene quindi inviata tramite pipe a Where-Object, che seleziona soltanto le impostazioni dei dispositivi che includono "Watson" nel proprio insieme di tipi di file di registro validi.
Vedere anche
Ulteriori risorse
New-CsDeviceUpdateConfiguration
Remove-CsDeviceUpdateConfiguration
Set-CsDeviceUpdateConfiguration