Import-CsDeviceUpdate
Ultima modifica dell'argomento: 2012-03-23
Importa un insieme di regole di aggiornamento dei dispositivi scaricate dal sito Web Microsoft. Le regole di aggiornamento dei dispositivi associano gli aggiornamenti della versione del firmware ai dispositivi hardware che eseguono Microsoft Lync 2010 Phone Edition.
Sintassi
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Periodicamente, Microsoft rende disponibile un nuovo set di regole di aggiornamento dei dispositivi per Lync 2010 Phone Edition. Queste regole rappresentano aggiornamenti del firmware per dispositivi che eseguono Lync 2010 Phone Edition. Una volta importate queste regole, gli amministratori possono testare gli aggiornamenti del firmware e successivamente renderli disponibili per tutti i dispositivi pertinenti in uso nell'organizzazione in caso di esito positivo del test.
L'unico modo per creare nuove regole di aggiornamento consiste nello scaricare pacchetti di aggiornamento dal sito Microsoft. Non è infatti possibile creare regole di aggiornamento dei dispositivi personalizzate. Per ottenere il set più recente di regole di aggiornamento dei dispositivi, aprire la pagina del supporto tecnico del sito Web Microsoft e cercare "Phone Edition". Scaricare il pacchetto di aggiornamento ed estrarre i file in una cartella nel computer dove devono essere caricati gli aggiornamenti. Dopo aver estratto i file, è possibile utilizzare il cmdlet Import-CsDeviceUpdate per importare le regole di aggiornamento dei dispositivi presenti nel file CAB estratto, che sarà denominato UCUpdates.cab.
Come già indicato precedentemente, gli aggiornamenti possono essere caricati solo localmente. Sarà necessario pertanto copiare il file UCUpdates.cab in tutti i computer che eseguono il servizio servizi Web che devono ospitare le regole di aggiornamento dei dispositivi. Considerare inoltre che le regole di aggiornamento dei dispositivi non vengono replicate da server a server. Se si desidera che tutte le regole di aggiornamento dei dispositivi dell'organizzazione siano sempre sincronizzate, sarà necessario eseguire la stessa operazione in ogni server che ospita tali regole. Se ad esempio si rimuove una regola da un server servizi Web, sarà necessario rimuovere la stessa regola dagli altri server servizi Web. In caso contrario, le regole di aggiornamento dei dispositivi non saranno più sincronizzate.
Le regole di aggiornamento possono essere importate solo nei servizi, poiché non sono applicabili all'ambito globale, all'ambito del sito o ad ambiti specifici per gli utenti. Import-CsDeviceUpdate tuttavia non aggiunge automaticamente regole e aggiornamenti a ogni servizio di un sito, li carica solo nel servizio specificato. Se ad esempio in un sito esistono tre server che eseguono i servizi Web, sarà necessario eseguire Import-CsDeviceUpdate tre volte, una per ogni istanza dei servizi Web. In alternativa, è possibile utilizzare un comando come quello riportato nell'esempio 3, che recupera l'identità di tutti i server servizi Web e quindi esegue Import-CsDeviceUpdate in ciascuno di tali server.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Import-CsDeviceUpdate i membri dei seguenti gruppi: 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 "Import-CsDeviceUpdate"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Indica l'istanza del servizio a cui verranno applicate le nuove regole di aggiornamento. Ad esempio: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
FileName |
Facoltativo |
Stringa |
Percorso del file di aggiornamento, ad esempio C:\Updates\UCUpdates.cab. |
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
Nessuno. Import-CsDeviceUpdate non accetta l'input da pipeline.
Tipi restituiti
Il cmdlet Import-CsDeviceUpdate importa le istanze della classe Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.
Esempio
-------------------------- Esempio 1 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
Il comando riportato nell'esempio 1 importa le regole di aggiornamento dei dispositivi dal file C:\Updates\UCUpdates.cab.
-------------------------- Esempio 2 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
Il comando riportato nell'esempio 2 importa le regole di aggiornamento dei dispositivi dal percorso UNC \\atl-fs-001\Updates\UCUpdates.cab.
-------------------------- Esempio 3 ------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
Nell'esempio 3 viene mostrato come utilizzare un solo comando per importare le regole di aggiornamento dei dispositivi in tutti i server che eseguono i servizi Web. A tale scopo, il comando chiama innanzitutto Get-CsService con il parametro WebServer per restituire una raccolta di tutti i server che eseguono il servizio servizi Web. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che esegue un ciclo in ogni server della raccolta e utilizza Import-CsDeviceUpdate per aggiornare le regole di aggiornamento dei dispositivi più recenti in tali server. Questo comando funzionerà solo se il file UCUpdates.cab è stato copiato nello stesso percorso (C:\Updates) in tutti i server.