[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Clear-CsDeviceUpdateLog deletes all the device update log and audit files that are older than the specified number of days.

Syntax

Clear-CsDeviceUpdateLog -Identity <XdsIdentity> -DaysBack <Int32> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter Required Type Description

Identity

Required

Xds Identity

Unique identifier of the service hosting the device update log files. For example, this syntax clears device update log files from the Web Server for the pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

DaysBack

Required

Integer

Maximum age (in days) of the log files to be maintained; all log files older than the value specified using the –DaysBack parameter will be deleted. For example, if you set –DaysBack to 7 then any log files more than 7 days old will be removed.

This parameter can be set to any integer value between 1 and 30, inclusive.

Force

Optional

Switch Parameter

Suppresses the display of any non-fatal error message that might arise when running the command.

LocalStore

Optional

Switch Parameter

WhatIf

Optional

Switch Parameter

Describes what would happen if you executed the command without actually executing the command.

Confirm

Optional

Switch Parameter

Prompts you for confirmation before executing the command.

Detailed Description

The device update management service keeps an extensive collection of log files; this collection includes both audit logs conducted by the service itself as well as log files uploaded from client devices such as cell phones. Depending on the amount of device update activity, and depending on the number of client devices used in your organization, your server could soon become “cluttered” with device update logs. The Clear-CsDeviceUpdateLog cmdlet provides a way for you to reduce the number of log files stored on the server. Just call the cmdlet and specify the maximum age (in days) of the files that should not be deleted. Any log files older than that maximum age will be removed from the system.

Return Types

Clear-CsDeviceUpdateLog does not return any values.

Examples

-------------------------- Example 1 ------------------------

Copy Code
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com" -DaysBack 10

The command shown in Example 1 connects to the device update service with the Identity "service:WebServer:atl-cs-001.litwareinc.com" and deletes all the device and audit logs more than 10 days old.