EXAMPLE 1

The command shown in Example 1 removes the A/V Edge configuration settings that have the Identity site:Redmond. After the settings are removed, A/V Edge servers in the Redmond site will be governed by the global configuration settings.

	Copy Code
Remove-CsAVEdgeConfiguration -Identity site:Redmond

EXAMPLE 2

In Example 2, all of the A/V Edge configuration settings that have been applied at the service scope are removed. To do this, the command first calls the Get-CsAVEdgeConfiguration cmdlet along with the Filter parameter; the filter value "service:*" ensures that only settings configured at the service scope are returned. This filtered collection is then piped to the Remove-CsAVEdgeConfiguration cmdlet, which deletes each item in the collection.

	Copy Code
Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

EXAMPLE 3

The command shown in Example 3 deletes all of the A/V Edge configuration settings where the value of the MaxBandwidthPerUserKB property is less than 5,000 kilobits per second. To carry out this task, the command first uses the Get-CsAVEdgeConfiguration cmdlet without any additional parameters in order to return a collection of all the A/V Edge settings currently in use in the organization. This collection is piped to the Where-Object cmdlet, which selects only those settings where the MaxBandwidthPerUserKB property is less than 5000. The filtered collection is then piped to the Remove-CsAVEdgeConfiguration cmdlet, which deletes each item in that collection.

	Copy Code
Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

An A/V Edge server provides a way for audio and video traffic to be exchanged across an organization’s firewall. Among other things, this enables users to use Lync Server across the Internet, and then exchange audio and video data with users who have logged onto the system from inside the firewall. Edge Server configuration settings can be assigned at the global scope, the site scope, and the service scope. The A/V Edge configuration settings enable administrators to do such things as manage the amount of time that user authentication is valid before it must be renewed, and to limit the amount of bandwidth that can be used by a single user or a single port.

The Remove-CsAVEdgeConfiguration cmdlet enables you to delete A/V Edge configuration settings that have been applied to either the site or the service scope. The cmdlet can also be run against the global settings; however, those global settings will not be deleted. Instead, the properties contained within the global collection will all be reset to their default values.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsAVEdgeConfiguration cmdlet locally: RTCUniversalServerAdmins. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAVEdgeConfiguration"}

Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings object. The Remove-CsAVEdgeConfiguration cmdlet accepts pipelined input of media relay settings objects. These objects retrieved by running the Get-CsAVEdgeConfiguration cmdlet.

The Remove-CsAVEdgeConfiguration cmdlet does not return a value or object. Instead, the cmdlet deletes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings object.