Condividi tramite

  • Articolo

Get-CsDeviceUpdateRule

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle regole di aggiornamento dei dispositivi configurate per l'utilizzo nell'organizzazione. Le regole di aggiornamento dei dispositivi vengono utilizzate per associare aggiornamenti del firmware a dispositivi che eseguono Microsoft Lync 2010 Phone Edition.

Sintassi

Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

In Microsoft Lync Server 2010 vengono utilizzate le regole di aggiornamento dei dispositivi per fornire aggiornamenti del firmware a dispositivi che eseguono Lync 2010 Phone Edition. Gli amministratori caricano periodicamente un insieme di regole di aggiornamento dei dispositivi in Lync Server 2010. Una volta verificate e approvate, tali regole vengono scaricate e applicate automaticamente ai dispositivi appropriati non appena tali dispositivi si collegano al sistema. Per impostazione predefinita, i dispositivi ricercano nuove regole di aggiornamento dei dispositivi ogni volta che vengono avviati e connessi a Lync Server. I dispositivi ricercano inoltre gli aggiornamenti ogni 24 ore dopo l'accesso iniziale.

Le regole di aggiornamento dei dispositivi possono essere importate nel servizio servizi Web e a esso applicate. Il cmdlet Get-CsDeviceUpdateRule consente di restituire informazioni sulle regole di aggiornamento dei dispositivi importate per l'utilizzo nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsDeviceUpdateRule i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC 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 "Get-CsDeviceUpdateRule"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

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). In base a questi dati, l'identità di una data regola di aggiornamento sarà simile a quella seguente: "service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 ".

I caratteri jolly non sono consentiti quando si specifica un valore Identity. Utilizzare il parametro Filter se si desidera utilizzare i caratteri jolly per specificare una regola.

Filter

Facoltativo

Stringa

Consente l'utilizzo di caratteri jolly per specificare l'identità di una regola di aggiornamento del dispositivo o di una serie di regole. Ad esempio, per restituire tutte le regole di aggiornamento del dispositivo per WebServer:atl-cs-001.litwareinc.com, utilizzare il valore di filtro seguente: "service:WebServer:atl-cs-001.litwareinc.com*".

LocalStore

Facoltativo

Parametro opzionale

Recupera i dati delle regole di aggiornamento dei dispositivi dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsDeviceUpdateRule non accetta l'input da pipeline.

Tipi restituiti

Get-CsDeviceUpdateRule restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Esempio

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

Get-CsDeviceUpdateRule

Il comando precedente restituisce le informazioni su tutte le regole di aggiornamento del dispositivo applicate nell'organizzazione. Se si chiama Get-CsDeviceUpdateRule senza parametri aggiuntivi, viene sempre restituita la raccolta completa di regole di aggiornamento dei dispositivi.

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

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

Il comando mostrato nell'esempio 2 restituisce le informazioni sulla regola di aggiornamento del dispositivo con identità "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

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

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

Nell'esempio 3 vengono restituite le informazioni su tutte le regole di aggiornamento del dispositivo, configurate per il servizio WebServer:atl-cs-001.litwareinc.com. Per eseguire questa attività, il parametro Filter viene utilizzato insieme al valore di filtro "WebServer:atl-cs-001.litwareinc.com*". Questo filtro circoscrive i dati restituiti alle regole di aggiornamento dei dispositivi con valore Identity che inizia con il valore stringa "service:WebServer:atl-cs-001.litwareinc.com".

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

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

Il comando precedente restituisce tutte le regole di aggiornamento dei dispositivi con proprietà Brand uguale a "LG-Nortel". A tale scopo, viene chiamato Get-CsDeviceUpdateRule per restituire una raccolta di tutte le regole di aggiornamento dei dispositivi dell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona unicamente le regole con proprietà Brand uguale a "LG-Nortel".

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

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}

Nell'esempio 5 viene restituita una raccolta di tutte le regole di aggiornamento del dispositivo che non sono state approvate. Questa operazione viene eseguita utilizzando Get-CsDeviceUpdateRules per restituire una raccolta di tutte le regole e quindi inviando la raccolta tramite pipe a Where-Object. A sua volta, Where-Object seleziona solo le regole con proprietà Approved uguale a null. Se la proprietà Approved è impostata su null, queste regole non sono approvate.

-------------------------- Esempio 6 ------------------------

Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}

Il comando mostrato sopra restituisce una raccolta di tutte le regole di aggiornamento del dispositivo che soddisfano i due criteri seguenti: la regola è stata approvata ed è correlata ai dispositivi LG-Nortel. Per eseguire questa attività, viene chiamato innanzitutto Get-CsDeviceUpdateRule per restituire una raccolta di tutte le regole di aggiornamento dei dispositivi dell'organizzazione. La raccolta viene quindi inviata tramite pipe a Where-Object, che filtra la raccolta in base a due criteri: la proprietà Approved deve essere impostata su null, ovvero deve presentare un valore di questo tipo e la proprietà Brand deve essere uguale a "LG-Nortel".