Clear-CsDeviceUpdateFile deletes any rejected device update files that have been on the server for more than 30 days.
Syntax
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-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 files. For example, this syntax clears device update files from the Web Server service for the pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
|
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
Each time new device updates are uploaded to the system a corresponding device update rule is created. By default, these new device update rules are assigned to the Pending state; that means that the rules can be downloaded and installed on test devices, but not on production devices. This gives you an opportunity to test the updates before making them available to users. If testing is successful, you can then run the Approve-CsDeviceUpdateRule cmdlet to make these device updates available to users.
If testing is not successful then you can use the Reset-CsDeviceUpdateRule or the Restore-CsDeviceUpdateRule cmdlets to reject an update. When these cmdlets are run, the actual device update itself is disassociated from its device update rule. At that point, administrators can then use the Clear-CsDeviceUpdate file to remove the disassociated updates from the server.
Return Types
Clear-CsDeviceUpdateFile does not return any values.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com" |
|
The command shown in Example 1 deletes all the device update files from the service WebServer:atl-cs-001.litwareinc.com that are more than 30 days old.