.png)
Remove-CsNetworkInterSitePolicy
Topic Last Modified: 2013-03-06
Removes a network inter-site policy that defines bandwidth limitations between sites that are directly linked within a call admission control (CAC) configuration. This cmdlet was introduced in Lync Server 2010.
Remove-CsNetworkInterSitePolicy -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
This example removes the network site policy with the Identity Reno_Portland.
Remove-CsNetworkInterSitePolicy -Identity Reno_Portland
In Example 2, we remove all network site policies defined within the CAC configuration. We begin by calling the Get-CsNetworkInterSitePolicy cmdlet to retrieve a collection of all network site policies. That collection is then piped to the Remove-CsNetworkInterSitePolicy cmdlet, which removes each item in the collection.
Get-CsNetworkInterSitePolicy | Remove-CsNetworkInterSitePolicy
When network sites share a direct link, bandwidth limitations for audio and video connections can be defined between those two sites. This cmdlet removes a network site policy that associates a bandwidth limitation policy with two directly connected sites.
Who can run this cmdlet: By default, members of the following groups are authorized to run the Remove-CsNetworkInterSitePolicy 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-CsNetworkInterSitePolicy"}
| Parameter | Required | Type | Description |
|---|---|---|---|
| Identity | Required | Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity | The unique identifier of the network site policy you want to remove. Network site policies are created only at the global scope, so this identifier does not need to specify a scope. Instead, it contains a string that is a unique name that identifies that site policy. |
| Confirm | Optional | System.Management.Automation.SwitchParameter | Prompts you for confirmation before executing the command. |
| Force | Optional | System.Management.Automation.SwitchParameter | Suppresses any confirmation prompts that would otherwise be displayed before making changes. |
| WhatIf | Optional | System.Management.Automation.SwitchParameter | Describes what would happen if you executed the command without actually executing the command. |
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType object. Accepts pipelined input of network inter-site policy objects.
This cmdlet does not return a value. It removes an object of type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.
