Condividi tramite

  • Articolo

Remove-CsDeviceUpdateRule

 

Ultima modifica dell'argomento: 2012-03-25

Consente di rimuovere una regola di aggiornamento dei dispositivi configurata per l'utilizzo nella propria organizzazione. Le regole di aggiornamento dei dispositivi consentono di associare gli aggiornamenti firmware ai dispositivi su cui è installato Microsoft Lync 2010 Phone Edition.

Sintassi

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

Descrizione dettagliata

Microsoft Lync Server 2010 utilizza le regole di aggiornamento dei dispositivi come strumento per fornire gli aggiornamenti firmware ai dispositivi su cui è installato Lync 2010 Phone Edition. Periodicamente, gli amministratori caricano un insieme di regole di aggiornamento dei dispositivi in 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. Per impostazione predefinita, i dispositivi verificano la disponibilità di nuove regole di aggiornamento ogni volta che vengono accesi e si collegano a Lync Server. Inoltre, dopo l'accesso iniziale, i dispositivi verificano la disponibilità di aggiornamenti ogni 24 ore.

Gli amministratori non possono creare proprie regole di aggiornamento dei dispositivi. Le regole di aggiornamento possono essere create solamente scaricando e importando set di regole dal sito Web Microsoft. Ciò significa che, nel tempo, vengono probabilmente raccolte regole non aggiornate o che non sono utili nell'organizzazione. Se, ad esempio, l'organizzazione non utilizza più telefoni LG-Nortel, gli aggiornamenti firmware per questi dispositivi non sono più necessari. Sebbene queste regole non necessarie non creino alcun problema, possono complicare l'amministrazione: utilizzare il cmdlet Get-CsDeviceUpdateRule per ottenere una raccolta di tutte le regole di aggiornamento dei dispositivi può creare confusione se la maggior parte di queste regole non è poi effettivamente applicabile nell'organizzazione. Per semplificare l'amministrazione, è possibile utilizzare il cmdlet Remove-CsDeviceUpdateRule per rimuovere eventuali regole o set di regole di aggiornamento dei dispositivi importati per essere utilizzati.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco della regola di aggiornamento dei dispositivi. L'identità di una regola di aggiornamento dei dispositivi è composta di due parti: l'ambito del servizio nel quale la regola è stata applicata (ad esempio, service:WebServer:atl-cs-001.litwareinc.com) e l'identificatore univoco globale (GUID) preassegnato alla regola (ad esempio, d5ce3c10-2588-420a-82ac-dc2d9b1222ff9). Basata su queste norme, l'identità di una data regola di aggiornamento dei dispositivi sarà simile a: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

I caratteri jolly non sono consentiti quando si specifica una identità.

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.DeviceUpdate.Rule. Remove-CsDeviceUpdateRule accetta le istanze dell'oggetto regola di aggiornamento dei dispositivi inviate tramite pipeline.

Tipi restituiti

Remove-CsDeviceUpdateRule non restituisce alcun oggetto o valore. Il cmdlet elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.

Esempio

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

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

Il comando precedente consente di eliminare la regola di aggiornamento dei dispositivi con l'identità service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9. Dopo l'eliminazione della regola, il corrispondente aggiornamento firmware non sarà più disponibile.

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

Get-CsDeviceUpdateRule | Remove-CsDeviceUpdateRule

Il comando riportato nell'Esempio 2 consente di rimuovere tutte le regole di aggiornamento dei dispositivi configurate per l'utilizzo nella propria organizzazione. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsDeviceUpdateRule (senza alcun parametro) in modo da ottenere una raccolta di tutte le regole di aggiornamento dei dispositivi attualmente in uso. Questa raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsDeviceUpdateRule che, a sua volta, elimina ogni singola regola nella raccolta.

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

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

Nell'empio 3, vengono eliminate tutte le regole di aggiornamento dei dispositivi importate per il servizio WebServer:atl-cs-001.litwareinc.com. Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsDeviceUpdateRule e il parametro Filter per recuperare tutte le regole di aggiornamento dei dispositivi la cui identità inizia con la stringa "service:WebServer:atl-cs-001.litwareinc.com". Questa raccolta viene quindi inviata tramite pipe al cmdlet Remove-CsDeviceUpdateRule che elimina ciascuna regola nella raccolta.

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

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

Il comando precedente consente di eliminare tutte le regole di aggiornamento dei dispositivi nelle quali il parametro Brand è uguale a "LG-Nortel". Per ottenere questo risultato, il comando utilizza il cmdlet Get-CsDeviceUpdateRule senza alcun parametro aggiuntivo in modo da ottenere una raccolta di tutte le regole di aggiornamento dei dispositivi in uso nell'organizzazione. La raccolta così ottenuta viene quindi inviata tramite pipe al cmdlet Where-Object che seleziona solo quelle regole nelle quali il parametro Brand è uguale a "LG-Nortel". Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsDeviceUpdateRule che elimina ogni regola nella raccolta.