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

Parameters

When it comes to Web conferences, management and administration is split between two sets of cmdlets. If you want to dictate the things that users can and cannot do (for example, can users invite anonymous participants to join a conference; are users allowed to offer application sharing and/or file transfers within a conference; etc.) then you need to use the CsConferencingPolicy cmdlets. But that’s only one piece of the puzzle. The other piece: the need to manage Web conferencing servers and server settings. For example, administrators need to be able to do such things as specify the maximum amount of content storage allotted to a single meeting and to specify the grace period before that meeting content is automatically deleted. They also need to be able to specify the ports used for activities such as application sharing and file transfer.

The CsConferencingConfiguration cmdlets represent the missing piece to the Web conferencing management puzzle. These cmdlets enable you to manage the actual severs themselves. The CsConferencingConfiguration cmdlets (which can be applied to the global, the site, and the service scopes) aren’t used to specify whether or not a user can share applications during a conference; if application sharing is allowed, however, these cmdlets let you indicate which ports should be used for that activity. Likewise, the cmdlets also let you specify such thing as storage limits and expiration periods, as well as pointers to internal and external URLs where users can obtain conferencing help and resources.

The Remove-CsConferencingConfiguration cmdlet provides a way for you to delete any of the custom collections of conferencing configuration settings created for use in your organization. When you delete a collection of settings any conferencing server previously affected by those settings will automatically come under the jurisdiction of the next collection in the hierarchy (service – site – scope). If the deleted settings were applied at the service scope, then the servers will be managed by the site settings. If there are no settings at the site scope then the servers will be managed by the global settings. Likewise, if you delete settings at the site scope then servers previously managed by those site settings will be managed by the global settings.

Note that you can also run Remove-CsConferencingConfiguration against the global settings. In that case, however, the global settings will not be removed; that’s because Microsoft Communications Server does not allow you to remove global settings. Instead, all the properties in the global collection will be reset to their default values. For example, if you previously changed the maximum content storage value to 200 megabytes this property will revert to the default value of 100 megabytes.

Remove-CsConferencingConfiguration deletes existing instances of the Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings object.

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

	Copy Code
Remove-CsConferencingConfiguration -Identity site:Redmond

The preceding command deletes the conferencing configuration settings applied to the Redmond site. When site settings such as these are deleted, users in the site will automatically inherit the settings found in the global conferencing configuration settings.

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

	Copy Code
Get-CsConferencingConfiguration -Filter site:* | Remove-CsConferencingConfiguration

In Example 2, the command deletes all the conferencing configuration settings applied to the site scope. To do this, the command first calls Get-CsConferencingConfiguration along with the -Filter parameter; the filter value "site:" ensures that only those settings that have an Identity that begins with the characters "site:" are returned. This filtered collection is then piped to Remove-CsConferencingConfiguration, which deletes each item in the collection.

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

	Copy Code
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Litwareinc"} | Remove-CsConferencingConfiguration

Example 3 deletes all the conferencing configuration settings where the organization is not set to Litwareinc. To carry out this task, the command first calls Get-CsConferencingConfiguration without any parameters; that returns a collection of all the conferencing configuration settings used in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those settings where the Organization property is not equal to (-ne) Litwareinc. Finally, the filtered collection is piped to Remove-CsConferencingConfiguration, which deletes all the settings where the organization is not set to Litwareinc. (In other words, all the settings in the filtered collection.)