Clear-CsDeviceUpdateLog
Ultima modifica dell'argomento: 2012-03-23
Consente di eliminare tutti i file di controllo e i registri del servizio Web di aggiornamento dei dispositivi la cui creazione è antecedente al numero di giorni specificato.
Sintassi
Clear-CsDeviceUpdateLog -Identity <XdsIdentity> -DaysBack <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il servizio Web di aggiornamento dei dispositivi contiene un gran numero di file di registro; tra questi vi sono i file di registro dei controlli eseguiti dal servizio così come quelli caricati dai dispositivi client come, ad esempio, i cellulari. A seconda del numero di operazioni di aggiornamento dei dispositivi e del numero di dispositivi client presenti nell'organizzazione, in breve tempo il server potrebbe saturarsi con i file di registro di questo servizio. Il cmdlet Clear-CsDeviceUpdateLog consente di ridurre il numero di file di registro memorizzati sul server: è sufficiente utilizzare il cmdlet e specificare il tempo massimo (in giorni) di conservazione dei file. Superato quel periodo di tempo, i file di registro vengono rimossi dal sistema.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Clear-CsDeviceUpdateLog 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-CsDeviceUpdateLog"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
XdsIdentity |
Identificatore univoco del servizio che ospita i file di registro del servizio Web di aggiornamento dei dispositivi. Ad esempio, la seguente sintassi consente di eliminare i file di registro del servizio Web di aggiornamento dei dispositivi da servizi Web per il pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
DaysBack |
Obbligatorio |
Numero intero |
Numero massimo di giorni per la conservazione dei file di registro. Una volta superato il valore specificato dal parametro DaysBack, i file di registro verranno eliminati. Ad esempio, se si imposta DaysBack su 7, dopo 7 giorni di permanenza sul server i file di registro verranno rimossi. Questo parametro può essere impostato su qualsiasi numero intero compreso tra 1 e 30, inclusi. |
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-CsDeviceUpdateLog non accetta input tramite pipeline.
Tipi restituiti
Nessuno. Clear-CsDeviceUpdateLog non restituisce alcun valore.
Esempio
-------------------------- Esempio 1 --------------------------
Clear-CsDeviceUpdateLog -Identity "service:WebServer:atl-cs-001.litwareinc.com" -DaysBack 10
Il comando riportato nell'Esempio 1 consente di eseguire la connessione al servizio Web di aggiornamento dei dispositivi con Identity "service:WebServer:atl-cs-001.litwareinc.com" ed eliminare tutti i file di controllo e dei dispositivi creati più di 10 giorni prima.