Remove-CsHealthMonitoringConfiguration
上一次修改主题： 2012-03-26
删除运行状况监视配置设置的现有集合。通过这些设置，管理员不必提供所需测试帐户的用户名和密码即可运行质量保证测试。
语法
Remove-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 中使用综合事务来验证用户是否能够成功完成常见任务，如登录系统、交换即时消息，或者拨打位于公用电话交换网 (PSTN) 中的电话。这些测试可以由管理员手动执行，也可以通过应用程序（如 Microsoft System Center Operations Manager（以前称为 Microsoft Operations Manager））自动运行。
执行综合事务的方式有两种。许多管理员会使用 CsHealthMonitoringConfiguration cmdlet 为其每一个注册器池设置测试帐户。这些测试帐户是预先配置的与综合事务配合使用的一对用户帐户。（通常，这些帐户是测试帐户，而不是属于实际用户的帐户。）为某个池配置这些测试帐户后，管理员无需指定测试中所涉及用户帐户的标识（以及为其提供凭据），即可针对该池运行综合事务。综合事务在执行其检查时将自动使用预先配置的测试帐户。
此外，管理员也可以使用真实的用户帐户运行综合事务。例如，如果两个用户无法交换即时消息，则管理员可使用这两个相关的用户帐户（而非一对测试帐户）运行综合事务。如果决定使用实际用户帐户执行综合事务，您需要提供每个用户的凭据。
Remove-CsHealthMonitoringConfiguration cmdlet 提供了一种方法，用于删除已配置为在组织中使用的任何运行状况监视配置设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsHealthMonitoringConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHealthMonitoringConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
托管要删除的运行状况监视配置设置的池的完全限定域名 (FQDN)。例如：-Identity atl-cs-001.litwareinc.com。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 对象。Remove-CsHealthMonitoringConfiguration 接受通过管道传递的运行状况监控配置对象的实例。
返回类型
无。Remove-CsHealthMonitoringConfiguration 删除 Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 对象的现有实例。
示例
-------------------------- 示例 1 ------------------------
Remove-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com
示例 1 中显示的命令删除 Identity 为 atl-cs-001.litwareinc.com 的运行状况监视配置设置的集合。由于标识必须唯一，因此此命令最多只会删除一个设置集合。
-------------------------- 示例 2 --------------------------
Get-CsHealthMonitoringConfiguration | Remove-CsHealthMonitoringConfiguration
示例 2 删除当前正在使用的所有运行状况监视配置设置。为此，该命令首先调用不带任何参数的 Get-CsHealthMonitoringConfiguration；这样将返回组织中所有运行状况监视配置设置的集合。然后，将此集合通过管道传递给 Remove-CsHealthMonitoringConfiguration，后者将删除集合中的每项。
-------------------------- 示例 3 ------------------------
Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com | Remove-CsHealthMonitoringConfiguration
上述命令删除为域 litwareinc.com 创建的所有运行状况监控配置设置。为此，调用了带有 Filter 参数的 Get-CsHealthMonitoringConfiguration；筛选器值“*.litwareinc.com”可确保仅返回 Identity 以字符串值“.litwareinc.com”结尾的设置。然后，将筛选出的集合通过管道传递给 Remove-CsHealthMonitoringConfiguration，后者将删除集合中的每项。
-------------------------- 示例 4 ------------------------
(Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}) | Remove-CsHealthMonitoringConfiguration
示例 4 中显示的命令删除所有运行状况监视配置设置，其中包括 SIP 地址为 sip:kenmyer@litwareinc.com 的用户作为一名测试用户。为执行此任务，该命令首先调用不带任何参数的 Get-CsHealthMonitoringConfiguration；这样将返回组织中当前正在使用的所有运行状况监视配置设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅选取 FirstTestUserSipUri 属性等于“sip:kenmyer@litwareinc.com”或 SecondTestUserSipUri 属性等于“sip:kenmyer@litwareinc.com”的设置。然后，将这些设置通过管道传递给 Remove-CsHealthMonitoringConfiguration，并由其删除这些设置。