Condividi tramite

  • Articolo

Remove-CsDeviceUpdateConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Rimuove le impostazioni di configurazione per l'aggiornamento dei dispositivi specificate. Tali impostazioni consentono di gestire servizio Web di aggiornamento dispositivi, un componente di Microsoft Lync Server 2010 che consente agli amministratori di distribuire gli aggiornamenti del firmware ai telefoni e ad altri dispositivi in cui è in esecuzione Microsoft Lync 2010 Phone Edition.

Sintassi

Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il servizio Web di aggiornamento dispositivi offre agli amministratori un mezzo per distribuire gli aggiornamenti del firmware ai dispositivi che eseguono Lync 2010 Phone Edition. Periodicamente, gli amministratori caricano un set di regole di aggiornamento dei dispositivi per Lync Server 2010. Dopo aver testato e approvato queste regole, è possibile applicarle ai dispositivi appropriati, come i dispositivi connessi al sistema. I dispositivi controllano gli aggiornamenti alla prima accensione, quindi ripetono il controllo all'accesso di un utente. Dopo di che, i dispositivi controllano gli aggiornamenti ogni 24 ore.

Lync Server utilizza le impostazioni di configurazione per l'aggiornamento dei dispositivi al fine di gestire il servizio Web di aggiornamento dispositivi; queste impostazioni di configurazione possono essere applicate nell'ambito globale o del sito. Per impostazione predefinita, le impostazioni sono disponibili solo nell'ambito globale; tuttavia, è possibile utilizzare il cmdlet New-CsDeviceUpdateConfiguration per assegnare impostazioni personalizzate anche nell'ambito del sito.

Inoltre, è possibile utilizzare il cmdlet Remove-CsDeviceUpdateConfiguration per eliminare le impostazioni assegnate nell'ambito del sito. Quando si esegue questo cmdlet su un sito, le impostazioni di configurazione per l'aggiornamento dei dispositivi assegnate a tale sito vengono rimosse. È inoltre possibile eseguire Remove-CsDeviceUpdateConfiguration sulle impostazioni globali. In questo caso, però, le impostazioni globali non vengono rimosse; non è infatti possibile rimuovere le impostazioni di configurazione per l'aggiornamento dei dispositivi globali. In realtà, le proprietà globali ritorneranno ai loro valori predefiniti. Ad esempio, si supponga di aver cambiato la proprietà globale MaxLogCacheLimit in 1.024.000 byte. Se si esegue Remove-CsDeviceUpdateConfiguration sulle impostazioni globali, queste non saranno rimosse; tuttavia, le proprietà modificate saranno riportate ai valori predefiniti. Significa che MaxLogCacheLimit verrà reimpostato a 512.000 byte.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsDeviceUpdateConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsDeviceUpdateConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Indica l'identità delle impostazioni di configurazione per l'aggiornamento dei dispositivi da rimuovere. Per fare riferimento alle impostazioni globali, utilizzare la sintassi seguente: -Identity global. Per referenziare le impostazioni del sito, utilizzare una sintassi simile a quella riportata di seguito: -Identity site:Redmond. Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity.

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.

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.DeviceUpdateConfiguration. Remove-CsDeviceUpdateConfiguration consente di accettare istanze da pipeline dell'oggetto configurazione di aggiornamento dei dispositivi.

Tipi restituiti

Nessuno. Il cmdlet Remove-CsDeviceUpdateConfiguration elimina invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Esempio

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

Remove-CsDeviceUpdateConfiguration -Identity global

Con l'esempio 1 viene utilizzato Remove-CsDeviceUpdateConfiguration per "rimuovere" le impostazioni di configurazione per l'aggiornamento dei dispositivi globali. Dal momento che le impostazioni globali non possono essere rimosse, il comando non elimina nulla; tuttavia, le proprietà nelle impostazioni di configurazione per l'aggiornamento dei dispositivi globali verranno reimpostate sui valori predefiniti.

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

Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

Con i comandi precedenti vengono rimosse le impostazioni di configurazione per l'aggiornamento dei dispositivi con identità site:Redmond. Dal momento che queste impostazioni sono state configurate nell'ambito del sito è possibile eliminarle; il sito Redmond non avrà più un set personale di impostazioni di configurazione per l'aggiornamento dei dispositivi.

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

Con l'esempio 3 vengono rimosse tutte le impostazioni di configurazione per l'aggiornamento dei dispositivi configurate nell'ambito del sito. Per eseguire tale operazione vengono utilizzati il cmdlet Get-CsDeviceUpdateConfiguration e il parametro Filter per restituire tutte le impostazioni la cui identità inizia con il valore stringa "site:"; per definizione, si tratta di tutte le impostazioni configurate nell'ambito del sito. Tale raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsDeviceUpdateConfiguration, che rimuove ciascun elemento nella raccolta.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration

Con l'esempio 4 vengono eliminate tutte le impostazioni di configurazione per l'aggiornamento dei dispositivi la cui proprietà MaxLogFileSize è maggiore di 1.024.000 byte. Per eseguire questa operazione, viene per prima cosa chiamato Get-CsDeviceUpdateConfiguration per restituire una raccolta di tutte le impostazioni di configurazione per l'aggiornamento dei dispositivi. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le impostazioni di configurazione in cui la proprietà MaxLogFileSize è maggiore di 1.024.000 byte. Tale raccolta filtrata viene quindi inviata tramite pipe a Remove-CsDeviceUpdateConfiguration, che elimina ciascun elemento nella raccolta.