New-CsHealthMonitoringConfiguration
上一次修改主题: 2012-03-26
创建在组织中使用的运行状况监控配置设置的新集合。通过这些设置,管理员无需提供所需测试帐户的用户名和密码,即可运行质量保证测试。
语法
New-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]
New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]
详细说明
Microsoft Lync Server 2010 中使用综合事务来验证用户是否能够成功完成常见任务,如登录系统、交换即时消息,或者拨打位于公用电话交换网 (PSTN) 中的电话。这些测试可以由管理员“手动”执行,也可以通过应用程序(如 Microsoft System Center Operations Manager(以前称为 Microsoft Operations Manager))自动运行。
执行综合事务的方式有两种。许多管理员会使用 CsHealthMonitoringConfiguration cmdlet 为其每一个注册器池设置测试帐户。这些测试帐户是预先配置的与综合事务配合使用的一对用户帐户。(通常,这些帐户是测试帐户,而不是属于实际用户的帐户。)为某个池配置这些测试帐户后,管理员无需指定测试中所涉及用户帐户的标识(以及为其提供凭据),即可针对该池运行综合事务。实际上,综合事务在执行检查时将自动使用预先配置的测试帐户。
此外,管理员也可以使用实际用户帐户来运行综合事务。例如,如果两个用户无法交换即时消息,管理员可以使用这两个用户帐户(而非两个测试帐户)运行综合事务。如果决定使用实际用户帐户执行综合事务,您需要提供每个用户的凭据。
New-CsHealthMonitoringConfiguration cmdlet 提供了一种为注册器池或控制器池创建新运行状况监控配置设置的方法。创建运行状况监控配置设置的新集合时,必须指定池的完全限定域名 (FQDN),以及将充当池测试帐户的两个帐户的 SIP 地址。(但并不需要提供这些测试帐户的密码。)请注意,每个池最多可承载一个运行状况监控配置设置集合。如果尝试为 atl-cs-001.litwareinc.com 池创建新集合,而此池已分配了注册器,则命令将失败。
运行 New-CsHealthMonitoringConfiguration 时,如果存在尚未分配测试用户的池,可能会收到一条警告;这样的池可能包括控制器池和 Office Communications Server 池。可以忽略这些警告。如果愿意,可以将其他池上托管的测试用户分配给控制器池;这样,您就可以针对控制器运行 Test-CsRegistration cmdlet。但是,不能将测试用户分配给 Office Communications Server 池。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 New-CsHealthMonitoringConfiguration cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsHealthMonitoringConfiguration"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
FQDN |
运行状况监控配置设置要分配到的池的 FQDN(例如:-Identity atl-cs-001.litwareinc.com)。如果指定池已承载了一个运行状况监控配置设置集合,则命令将失败。 Identity 等价于 TargetFqdn 参数。创建设置的新集合时,可以使用其中一个参数。如果两个参数都省略,则 New-CsHealthMonitoringConfiguration 将提示您输入 Identity。 |
TargetFqdn |
可选 |
FQDN |
运行状况监控配置设置要分配到的池的 FQDN(例如:-TargetFqdn atl-cs-001.litwareinc.com)。如果指定池已承载了一个运行状况监控配置设置集合,则命令将失败。 TargetFqdn 等价于 Identity 参数。创建设置的新集合时,可以使用其中一个参数。如果两个参数都省略,则 New-CsHealthMonitoringConfiguration 将提示您输入 Identity。 |
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:”前缀。例如:-SecondTestUserSipUri "sip:pilar@litwareinc.com"。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用,但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量,您可以更改对象引用的属性,然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsHealthMonitoringConfiguration 不接受通过管道传递的输入。
返回类型
New-CsHealthMonitoringConfiguration 创建 Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 对象的新实例。
示例
-------------------------- 示例 1 ------------------------
New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"
示例 1 中显示的命令为 atl-cs-001.litwareinc.com 池创建运行状况监控配置设置的新集合。这些新设置将使用 sip:kenmyer@litwareinc.com 和 sip:pilar@litwareinc.com 作为预先配置的测试帐户。
-------------------------- 示例 2 ------------------------
$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
{New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}
示例 2 为组织中的所有注册器池创建运行状况监控配置设置的新集合。为执行此操作,示例中的第一个命令使用 Get-Service cmdlet 和 Registrar 参数返回所有注册器池的集合。然后将该集合通过管道传递到 Select-Object cmdlet,该 cmdlet 仅挑选出 PoolFqdn 属性。(此属性返回注册器池的 FQDN。)将这些 FQDN 存储在一个名为 $x 的变量中。
在第二个命令中,创建了一个 foreach 循环来遍历每个注册器池的完全限定域名。对于每个 FQDN,将调用 New-CsHealthMonitoringConfiguration 以创建一个新的配置设置集合,存储在 $x 内的 FQDN 用作新集合的 Identity。每个集合还分配了两个相同的测试帐户:sip:kenmyer@litwareinc.com 和 sip:pilar@litwareinc.com。