Get-CsStaticRoutingConfiguration
上一次修改主题： 2012-03-23
返回有关您组织中使用的静态路由配置设置的信息。
语法
Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsStaticRoutingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
向某人发送 SIP 消息时，该消息可能需要穿越多个子网和网络才能传送；该消息的传输路径通常称为路由。在网络中，共有两种路由：即动态路由和静态路由。对于动态路由，服务器使用算法确定应将消息转发到的下一个位置（即下一个跃点）。对于静态路由，消息路径由系统管理员预先确定。当服务器接收消息时，该服务器将检查消息地址，并将其转发到管理员预先配置的下一个跃点服务器。如果配置正确，静态路由将有助于确保及时、准确地传送消息，并在服务器上消耗最少的开销。静态路由的不利方面就是，如果出现网络故障，将不会以动态方式重新路由消息。
当安装 Microsoft Lync Server 2010 时，系统将自动为您创建静态路由的一个全局集合。（虽然将创建该集合，但不会向该集合分配任何路由。）此外，使用该软件还可以创建应用于 service 作用域的其他集合（只能将这些新集合分配给 Registrar 服务）。Get-CsStaticRoutingConfiguration cmdlet 提供了一种返回有关您组织中使用的所有静态路由配置集合的信息的方法。包括返回有关分配给集合的每个路由的详细信息的功能。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsStaticRoutingConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsStaticRoutingConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
静态路由配置集合的唯一标识符。要返回有关全局集合的信息，请使用以下语法：-Identity global。要检索有关在 service 作用域配置的集合的信息，请使用类似如下的语法：-Identity "service:Registrar:atl-cs-001.litwareinc.com"。请注意，在指定 Identity 时不能使用通配符。如果需要使用通配符，请改用 Filter 参数。 如果不包含 Identity 或 Filter 参数，则 Get-CsStaticRoutingConfiguration 将返回有关所有静态路由配置集合的信息。 |
Filter |
可选 |
字符串 |
使您可以在指定要返回的静态路由配置集合时使用通配符。例如，该语法可返回在 service 作用域配置的所有静态路由集合：-Filter "service:*"。 请注意，不能在同一命令中同时使用 Identity 和 Filter 参数。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索静态路由配置数据。 |
输入类型
无。Get-CsStaticRoutingConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsStaticRoutingConfiguration 返回 Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsStaticRoutingConfiguration
示例 1 中显示的命令返回有关您组织中使用的所有静态路由配置集合的信息。
-------------------------- 示例 2 --------------------------
Get-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"
在示例 2 中，返回有关单个静态路由配置集合的信息：Identity 为 service:Registrar:atl-cs-001.litwareinc.com 的集合。
-------------------------- 示例 3 --------------------------
Get-CsStaticRoutingConfiguration -Filter "service:*"
示例 3 使用 Filter 参数返回有关分配给 service 作用域的静态路由配置集合的信息。筛选器值“service:*”将返回数据限制为标识以字符串值“service:”开头的集合。
-------------------------- 示例 4 --------------------------
Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route
上述命令返回组织中使用的所有静态路由配置集合的详细路由信息。为执行此操作，该命令首先调用不带任何参数的 Get-CsStaticRoutingConfiguration，以返回每个静态路由集合的完整信息。然后，将该信息通过管道传递到 Select-Object cmdlet，后者将使用 ExpandProperty 参数“展开”Route 属性的值。展开属性时，将以便于读取的方式在屏幕上显示该属性内包含的所有对象和值。
-------------------------- 示例 5 --------------------------
Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}
示例 5 中显示的命令返回有关配置为仅匹配电话统一资源标识符 (URI) 的所有静态路由的信息。为完成此任务，该命令首先调用不带任何参数的 Get-CsStaticRoutingConfiguration，这将返回所有静态路由配置集合及其关联的路由。然后将该集合通过管道传递到 Select-Object cmdlet，后者将使用 ExpandProperty 展开 Route 属性中存储的所有对象。然后将这些路由对象通过管道传递到 Where-Object cmdlet，后者将仅挑选出 MatchOnlyPhoneUri 属性等于 True 的路由。