Remove-CsStaticRoutingConfiguration
上一次修改主题： 2012-03-25
删除指定的静态路由配置设置集合。
语法
Remove-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
向某人发送 SIP 消息时，该消息可能需要穿越多个子网和网络才能传送；该消息的传输路径通常称为路由。在网络中，共有两种路由：即动态路由和静态路由。对于动态路由，服务器使用算法确定应将消息转发到的下一个位置（即下一个跃点）。对于静态路由，消息路径由系统管理员预先确定。当服务器接收消息时，该服务器将检查消息地址，并将其转发到管理员预先配置的下一个跃点服务器。如果配置正确，静态路由将有助于确保及时、准确地传送消息，并在服务器上消耗最少的开销。静态路由的不利方面就是，如果出现网络故障，将不会以动态方式重新路由消息。
当安装 Microsoft Lync Server 2010 时，系统将自动为您创建静态路由的一个全局集合。（虽然将创建该集合，但不会向该集合分配任何路由。）此外，使用该软件还可以创建应用于 service 作用域的其他集合（只能将这些新集合分配给 Registrar 服务）。如果您今后改变主意，可以使用 Remove-CsStaticRoutingConfiguration cmdlet 来删除应用于 service 作用域的集合。
您也可以针对全局集合运行 Remove-CsStaticRoutingConfiguration。但是在这种情况下，将不会删除全局集合；Lync Server 2010 不允许您删除全局集合。全局集合中的所有属性都将重置为其默认值。这意味着分配给全局集合的所有路由将被删除。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsStaticRoutingConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsStaticRoutingConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的静态路由配置集合的唯一标识符。要删除在 service 作用域配置的集合，请使用以下类似语法：-Identity "service:Registrar:atl-cs-001.litwareinc.com"。 此外，还可以针对全局集合运行 Remove-CsStaticRoutingConfiguration；为执行此操作，请使用以下语法：-Identity global。但是请记住，此命令实际上不会删除全局集合，但该集合中的属性将重置为其默认值。这意味着将删除 Route 属性中的所有项。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings 对象。Remove-CsStaticRoutingConfiguration 接受通过管道传递的静态路由设置对象的实例。
返回类型
Remove-CsStaticRoutingConfiguration 不会返回值或对象。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"
示例 1 中显示的命令删除 Identity 为 service:Registrar:atl-cs-001.litwareinc.com 的静态路由配置集合。
-------------------------- 示例 2 --------------------------
Get-CsStaticRoutingConfiguration -Filter "service:*" | Remove-CsStaticRoutingConfiguration
在示例 2 中，将删除应用于 service 作用域的所有静态路由配置集合。为执行此操作，该命令首先使用 Get-CsStaticRoutingConfiguration 和 Filter 参数；筛选器值“service:*”将返回的数据限制为 Identity 以字符串值“service:”开头的集合。然后，将筛选出的集合通过管道传递到 Remove-CsStaticRoutingConfiguration，后者将删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration
示例 3 说明如何删除尚未分配任何实际路由的所有静态路由配置集合。为了执行此任务，该命令首先调用 Get-CsStaticRoutingConfiguration；这将返回有关组织中使用的所有静态路由集合的信息。然后，将该集合通过管道传递到 Where-Object cmdlet，后者仅挑选路由数 (Route.Count) 等于 0 的集合。接下来，将筛选出的信息通过管道传递到 Remove-CsStaticRoutingConfiguration，后者将删除尚未分配任何路由的所有集合。