Remove-CsNetworkSubnet
上一次修改主题: 2012-03-27
删除现有网络子网。
语法
Remove-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
每个子网都必须与一个网络站点关联,以便确定此子网所属主机的地理位置。使用此 cmdlet 可删除网络子网。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsNetworkSubnet cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkSubnet"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
要删除的子网的唯一子网 ID。该值将为一个 IP 地址(如 174.11.12.0)。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 对象。接受通过管道传递的网络子网对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsNetworkSubnet -Identity 172.11.15.0
此示例删除 Identity(子网 ID)为 172.11.15.0 的子网。
-------------------------- 示例 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Remove-CsNetworkSubnet
示例 2 删除与 Vancouver 站点关联的所有子网。为此,我们首先调用 Get-CsNetworkSubnet cmdlet。这将检索在 Microsoft Lync Server 2010 部署中定义的所有子网的集合。然后将该子网集合通过管道传递到 Where-Object cmdlet。Where-Object 会接受该集合并将其范围缩小为仅包含 NetworkSiteID 等于 (-eq) Vancouver 的子网。现在,该集合只包含与 Vancouver 站点关联的子网,接下来我们将该集合通过管道传递到 Remove-CsNetworkSubnet,后者会删除集合中的每一项。