Clear-CsDeviceUpdateLog
上次修改主題的時間： 2012-03-23
刪除早於指定天數的所有裝置更新 Web 服務記錄檔和稽核檔案。
語法
Clear-CsDeviceUpdateLog -Identity <XdsIdentity> -DaysBack <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
裝置更新 Web 服務會保存大量的記錄檔集合；此集合包括服務本身進行的稽核記錄，以及從用戶端裝置 (如行動電話) 上傳的記錄檔。根據裝置更新活動量以及組織中使用的用戶端裝置數目，裝置更新 Web 服務記錄檔很快就會「塞滿」您的伺服器。Clear-CsDeviceUpdateLog 指令程式提供一種方式，讓您減少儲存在伺服器上的記錄檔數目。您只需要執行該指令程式，並指定不應刪除之檔案的保留時間上限 (天)。早於保留時間上限的任何檔案都會從系統移除。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Clear-CsDeviceUpdateLog Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Clear-CsDeviceUpdateLog"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
必要 |
Xds 識別碼 |
主控裝置更新 Web 服務記錄檔之服務的唯一識別碼。例如，此語法會針對 atl-cs-001.litwareinc.com 集區，從 Web 服務清除裝置更新 Web 服務記錄檔：-Identity "service:WebServer:atl-cs-001.litwareinc.com"。 |
DaysBack |
必要 |
整數 |
要保留之記錄檔的保留時間上限 (天)。早於使用 DaysBack 參數指定之值的所有記錄檔都會遭到刪除。例如，如果您將 DaysBack 設為 7，則七天以上的任何記錄檔將會遭到移除。 此參數可以設為 1 和 30 (含) 之間的任何整數值。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。Clear-CsDeviceUpdateLog 不接受管線傳送的輸入。
傳回類型
無。Clear-CsDeviceUpdateLog 不會傳回任何值。
範例
-------------------------- 範例 1 ------------------------
Clear-CsDeviceUpdateLog -Identity "service:WebServer:atl-cs-001.litwareinc.com" -DaysBack 10
範例 1 所示的命令會連線至 Identity 為 "service:WebServer:atl-cs-001.litwareinc.com" 的裝置更新 Web 服務，並刪除 10 天以上的所有裝置和稽核記錄。