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