Remove-CsNetworkSite
上一次修改主题: 2012-03-26
删除已为呼叫允许控制 (CAC) 或增强型 9-1-1 (E9-1-1) 定义的网络站点。
语法
Remove-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
网络站点是指在部署了 CAC 或 E9-1-1 的每个区域中配置的办公室或位置。此 cmdlet 从 CAC 或 E9-1-1 配置中删除站点。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsNetworkSite cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsNetworkSite"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 全局相关标识 |
要删除的网络站点的唯一标识符。仅在全局范围内创建站点,因此不需要指定范围。而是只需要指定站点 ID。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 对象。接受通过管道传递的网络站点对象的输入。
返回类型
此 cmdlet 不返回值。删除一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsNetworkSite -Identity Vancouver
此示例从 CAC 或 E9-1-1 配置中删除 Identity 为 Vancouver 的站点。
-------------------------- 示例 2 --------------------------
Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Remove-CsNetworkSite
示例 2 从 CAC 或 E9-1-1 配置中删除使用名为 LowBWProfile 的带宽策略配置文件的所有站点。此示例首先调用 Get-CsNetworkSite 检索所有网络站点。将这些站点的集合通过管道传递给 Where-Object cmdlet,后者将集合的范围缩小到仅 BWPolicyProfileID 等于 (-eq) LowBWProfile 的那些站点。然后,将此新集合通过管道传递给 Remove-CsNetworkSite 以删除那些站点。