Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Parameters

The device update service provides a way for administrators to distribute firmware updates to devices (such as Tanjay phones and Roundtable conference stations) that run Communicator “14” Phone Edition. Periodically, administrators upload a set of device update rules to Microsoft Communications Server; after those rules have been tested and approved, they are then automatically downloaded and applied to the appropriate devices as those devices connect to the system.

Microsoft Communications Server uses device update configuration settings to manage the device update service; these configuration settings can be applied at the global scope or at the site scope. By default, settings are found only at the global scope; however, you can use the New-CsDeviceUpdateConfiguration cmdlet to assign customized settings at the site scope as well.

In addition, you can use the Remove-CsDeviceUpdateConfiguration cmdlet to delete settings that have been assigned at the site scope. When you run this cmdlet against a site, the device update configuration settings assigned to that site are remove. You can also run Remove-CsDeviceUpdateConfiguration against the global settings. In that case, however, the global settings will not be removed; you cannot remove the global device update configuration settings. Instead, the global properties will be reset to their default values. For example, suppose you have changed the global property MaxLogCacheLimit to 1024000 bytes. If you run Remove-CsDeviceUpdateConfiguration against the global settings the global settings will not be removed; however, any properties that have been modified will be reset to their default values. That means that MaxLogCacheLimit will be reset to 512000 bytes.

The Remove-CsDeviceUpdateConfiguration cmdlet deletes instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration class.

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

	Copy Code
Remove-CsDeviceUpdateConfiguration -Identity global

In Example 1, Remove-CsDeviceUpdateConfiguration is used to "remove" the global device update configuration settings. Because the global settings cannot be removed, the command will not actually delete anything; however, all the properties in the global device update configuration settings will be reset to their default values. When you run this command you will see the following information message: WARNING. Global configuration for CsDeviceUpdateConfiguration cannot be removed, but has been reverted to the default values.

-------------------------- Example 2 ------------------------

	Copy Code
Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

The preceding commands removes the device update configuration settings with the Identity site:Redmond. Because these settings were configured at the site scope, they will be deleted, and the Redmond site will no longer have its own set of device update configuration settings.

-------------------------- Example 3 ------------------------

	Copy Code
Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

In Example 3, all the device update configuration settings that have been configured at the site scope are removed. To do this, the Get-CsDeviceUpdateConfiguration cmdlet, and the -Filter parameter, are used to return all the settings that have an Identity that begins with the string value "site:"; by definition, these will all be settings that were configured at the site scope. That collection is then piped to the Remove-CsDeviceUpdateConfiguration cmdlet, which, in turn, removes each of the items in the collection.

-------------------------- Example 4 ------------------------

	Copy Code
Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000 | Remove-CsDeviceUpdateConfiguration

In Example 4, all the device update configuration settings that have a MaxLogFileSize property greater than (-gt) 1024000 bytes are deleted. To accomplish this task, Get-CsDeviceUpdateConfiguration is first called in order to return a collection of all the device update configuration settings. This collection is piped to the Where-Object cmdlet, which selects only those configuration settings where the MaxLogFileSize property is greater than 1024000 bytes. That filtered collection is then piped to Remove-CsDeviceUpdateConfiguration, which deletes each item in the collection.