Remove-CsNetworkInterRegionRoute
上一次修改主题: 2012-03-25
删除呼叫允许控制 (CAC) 配置中连接网络区域的路由。
语法
Remove-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
CAC 配置中的每个区域必须具有某种可访问其他每个区域的方式。虽然区域链接会对区域之间的连接设置带宽限制,并代表物理链接,但是路由可确定连接从一个区域到另一个区域将遍历的链接路径。此 cmdlet 可删除其中的某个路由关联。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsNetworkInterRegionRoute cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkInterRegionRoute"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
要删除的网络区域路由的唯一标识符。网络区域路由只能在 global 作用域创建,因此该标识符不需要指定作用域。它包含一个字符串,此字符串是一个用于标识该路由的唯一名称。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 对象。接受通过管道传递的网络区域间路由对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route
示例 1 删除 Identity 为 NA_APAC_Route 的路由。
-------------------------- 示例 2 --------------------------
Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"} | Remove-CsNetworkInterRegionRoute
示例 2 删除包括 NorthAmerica 区域的所有区域路由。该命令的第一部分是调用 Get-CsNetworkInterRegionRoute cmdlet。调用的此 cmdlet 不带任何参数,将检索所有区域路由。接下来,将该路由集合通过管道传递到 Where-Object cmdlet。Where-Object cmdlet 将该集合的范围缩小到仅包含将 NorthAmerica 定义为路由中的区域之一的路由。这是通过检查路由的 NetworkRegionID1 值是否等于 (-eq) NorthAmerica,或 (-or) NetworkRegionID2 值是否等于 NorthAmerica 实现的。只要该集合仅包含含有 NorthAmerica 区域的路由,就可将该集合通过管道传递到 Remove-CsNetworkInterRegionRoute,后者会删除其中的每个路由。