Get-CsNetworkSubnet
上一次修改主题: 2012-03-23
检索有关一个或多个网络子网的信息。
语法
Get-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsNetworkSubnet [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
每个子网都必须与一个网络站点关联,以便确定此子网所属主机的地理位置。使用此 cmdlet 检索有关子网的信息,包括标识(子网 ID)、掩码位数、关联的网络站点以及子网描述。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsNetworkSubnet cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsNetworkSubnet"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
XdsGlobalRelativeIdentity |
要检索的子网的唯一子网 ID。该值将为一个 IP 地址(如 174.11.12.0)。 |
Filter |
可选 |
字符串 |
使用此参数以基于 Identity 对所有子网执行通配符搜索。例如,Filter 值 172.11.* 将检索 Identity 以 172.11 开头的所有子网(例如 172.11.10.0、172.11.25.0 等)。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本,而不是从中央管理存储本身检索网络子网信息。 |
输入类型
无。
返回类型
返回一个或多个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsNetworkSubnet
此示例检索 Microsoft Lync Server 2010 部署内的所有子网。
-------------------------- 示例 2 --------------------------
Get-CsNetworkSubnet -Identity 172.11.15.0
此示例检索有关 Identity(子网 ID)为 172.11.15.0 的子网的所有信息。
-------------------------- 示例 3 --------------------------
Get-CsNetworkSubnet -Filter 172.11.*
此示例检索标识以 172.11. 开头的所有子网。
-------------------------- 示例 4 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"}
示例 4 检索与 Vancouver 站点相关联的所有子网。首先调用不带参数的 Get-CsNetworkSubnet cmdlet,如示例 2 中所示,这将检索所有定义的子网。然后将此子网集合通过管道传递到 Where-Object cmdlet。Where-Object 会接受该集合并将其范围缩小为仅包含 NetworkSiteID 等于 (-eq) Vancouver 的子网。