Syntax

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.