Clear-CsDeviceUpdateFile
Ultima modifica dell'argomento: 2012-03-23
Consente di eliminare i file di aggiornamento dei dispositivi rifiutati e non più associati ad alcun dispositivo.
Sintassi
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Ogni volta che sul sistema vengono caricati degli aggiornamenti dei dispositivi, viene creata una corrispondente regola di aggiornamento dei dispositivi. Per impostazione predefinita, questa nuova regola di aggiornamento dei dispositivi viene assegnata allo stato Pending; ciò significa che la regola può essere scaricata e installata su dispositivi di prova ma non su dispositivi in produzione. In questo modo, è possibile provare gli aggiornamenti prima di renderli disponibili agli utenti. Se il test riesce, è possibile utilizzare il cmdlet Approve-CsDeviceUpdateRule per rendere questo aggiornamento disponibile agli utenti.
Se il test non riesce, è possibile utilizzare il cmdlet Reset-CsDeviceUpdateRule o Restore-CsDeviceUpdateRule per rifiutare l'aggiornamento. Quando si esegue uno di questi cmdlet, viene annullata l'associazione tra l'aggiornamento e la corrispondente regola. A quel punto, gli amministratori possono utilizzare il cmdlet Clear-CsDeviceUpdateFile per rimuovere dal server gli aggiornamenti per i quali è stata annullata l'associazione.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Clear-CsDeviceUpdateFile 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 "Clear-CsDeviceUpdateFile"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco del servizio che ospita i file di aggiornamento dei dispositivi. Ad esempio, questa sintassi consente di eliminare i file di aggiornamento dei dispositivi dal servizio servizi Web per il pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
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. Clear-CsDeviceUpdateFile non accetta input tramite pipeline.
Tipi restituiti
Nessuno. Clear-CsDeviceUpdateFile non restituisce alcun valore.
Esempio
-------------------------- Esempio 1 --------------------------
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com"
Il comando riportato nell'Esempio 1 consente di eliminare tutti i file di aggiornamento dei dispositivi dal servizio WebServer:atl-cs-001.litwareinc.com che non sono più associati al dispositivo.