Skype for Business Server：配置观察程序节点测试用户和设置

  • 项目

总结：为Skype for Business Server综合事务配置测试用户帐户和观察程序节点设置。

配置将充当观察程序节点的计算机后，必须：

  1. 配置这些观察程序节点要使用的测试用户帐户。 如果使用 Negotiate 身份验证方法，还必须使用 Set-CsTestUserCredential cmdlet 来启用这些测试帐户以在观察程序节点上使用。

  2. 更新观察程序节点配置设置。

配置测试用户帐户

测试帐户不需要表示实际人员，但它们必须是有效的 Active Directory 帐户。 此外，必须为这些帐户启用Skype for Business Server，它们必须具有有效的 SIP 地址，并且应为企业语音 (启用这些帐户以使用Test-CsPstnPeerToPeerCall综合事务) 。

如果使用 TrustedServer 身份验证方法，只需确保这些帐户存在并按说明进行配置。 为每个要测试的池分配至少三个测试用户。 如果使用 Negotiate 身份验证方法，还必须使用 Set-CsTestUserCredential cmdlet 和 Skype for Business Server 命令行管理程序，使这些测试帐户能够处理综合事务。 为此，请运行类似于下面的命令 (这些命令假定已创建三个 Active Directory 用户帐户，并且为Skype for Business Server) 启用了这些帐户：

Set-CsTestUserCredential -SipAddress "sip:watcher1@litwareinc.com" -UserName "litwareinc\watcher1" -Password "P@ssw0rd"
Set-CsTestUserCredential -SipAddress "sip:watcher2@litwareinc.com" -UserName "litwareinc\watcher2" -Password "P@ssw0rd"
Set-CsTestUserCredential -SipAddress "sip:watcher3@litwareinc.com" -UserName "litwareinc\watcher3" -Password "P@ssw0rd"

不仅包括 SIP 地址，还包括用户名和密码。 如果未包含密码，Set-CsTestUserCredential cmdlet 将提示输入该信息。 可以使用上述代码块中显示的域名\用户名格式来指定用户名。

若要验证是否已创建测试用户凭据，请从 Skype for Business Server 命令行管理程序运行以下命令：

Get-CsTestUserCredential -SipAddress "sip:watcher1@litwareinc.com"
Get-CsTestUserCredential -SipAddress "sip:watcher2@litwareinc.com"
Get-CsTestUserCredential -SipAddress "sip:watcher3@litwareinc.com"

将为每个用户返回与此类似的信息：

用户 密码
Litwareinc\watcher1
 System.Security.SecureString

使用默认综合事务配置基本观察程序节点

创建测试用户后，可以使用类似于以下命令创建观察程序节点：

New-CsWatcherNodeConfiguration -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com", "sip:watcher3@litwareinc.com"}

此命令创建一个新的观察程序节点，该节点使用默认设置并运行默认的一组综合事务。 新的观察程序节点还使用测试用户 watcher1@litwareinc.com、 watcher2@litwareinc.com和 watcher3@litwareinc.com。 如果观察程序节点使用 TrustedServer 身份验证，则这三个测试帐户可以是为 Active Directory 和 Skype for Business Server 启用的任何有效用户帐户。 如果观察程序节点使用 Negotiate 身份验证方法，则还必须通过使用 Set-CsTestUserCredential cmdlet 为观察程序节点启用这些用户帐户。

若要验证是否已正确配置目标池以登录的自动发现，而不是直接面向池，请改用以下步骤：

New-CsWatcherNodeConfiguration -UseAutoDiscovery $true -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com", "sip:watcher3@litwareinc.com"}

配置扩展测试

如果要启用 PSTN 测试（用于验证与公用电话交换网的连接），则需要在设置观察程序节点时执行更多配置。 首先，必须通过运行与 Skype for Business Server 命令行管理程序类似的命令，将测试用户与 PSTN 测试类型相关联：

$pstnTest = New-CsExtendedTest -TestUsers "sip:watcher1@litwareinc.com", "sip:watcher2@litwareinc.com", "sip:watcher3@litwareinc.com"  -Name "Contoso Provider Test" -TestType PSTN

注意

此命令的结果必须存储在变量中。 在此示例中，变量名为 $pstnTest。

接下来，可以使用 New-CsWatcherNodeConfiguration cmdlet 将存储在变量$pstnTest) 的测试类型 (关联到Skype for Business Server池。 例如，以下命令为池 atl-cs-001.litwareinc.com 创建新的观察程序节点配置，添加之前创建的三个测试用户，并添加 PSTN 测试类型：

New-CsWatcherNodeConfiguration -TargetFqdn "atl-cs-001.litwareinc.com" -PortNumber 5061 -TestUsers @{Add= "sip:watcher1@litwareinc.com","sip:watcher2@litwareinc.com", "sip:watcher3@litwareinc.com"} -ExtendedTests @{Add=$pstnTest}

如果尚未在观察程序节点计算机上安装Skype for Business Server核心文件和 RTCLocal 数据库，上述命令将失败。

若要测试多个语音策略，可以使用 New-CsExtendedTest cmdlet 为每个策略创建扩展测试。 应为提供的用户配置所需的语音策略。 使用逗号分隔符将扩展测试传递到 New-CsWatcherNodeConfiguration cmdlet，例如：

-ExtendedTests @{Add=$pstnTest 1，$pstnTest 2，$pstnTest 3}

由于 调用 New-CsWatcherNodeConfiguration cmdlet 时未使用 Tests 参数，因此只会为新的观察程序节点启用默认综合事务 (和指定的扩展综合事务) 。 因此，观察程序节点将测试以下组件：

  • 注册

  • 即时消息

  • GroupIM

  • P2PAV (对等音频/视频会话)

  • AvConference (音频/会议)

  • 状态

  • ABS (通讯簿服务)

  • ABWQ (通讯簿 Web 服务)

默认情况下，不会测试以下组件：

  • ASConference

  • AVEdgeConnectivity

  • DataConference

  • DialinConferencing

  • ExumConnectivity (Exchange 统一消息)

  • JoinLauncher

  • MCXP2PIM (旧式移动设备即时消息)

  • P2PVideoInteropServerSipTrunkAV

  • PersistentChatMessage

  • PSTN (PSTN 网关调用，指定为扩展测试)

  • UcwaConference

  • UnifiedContactStore

  • XmppIM

添加和删除综合事务

配置观察程序节点后，可以使用 Set-CsWatcherNodeConfiguration cmdlet 在节点中添加或删除综合事务。 例如，若要将 PersistentChatMessage 测试添加到观察程序节点，请使用 Add 方法和类似如下的命令：

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Add="PersistentChatMessage"}

可以通过使用逗号分隔测试名称来添加多个测试。 例如：

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Add="PersistentChatMessage","DataConference","UnifiedContactStore"}

如果其中一个或多个测试 (，例如，已在观察程序节点上启用 DataConference) ，则会发生错误。 在这种情况下，将收到类似于以下消息的错误消息：

Set-CsWatcherNodeConfiguration：对于“urn：schema：Microsoft.Rtc.Management.Settings.WatcherNode.2010：TestName”键或唯一标识约束，存在重复的键序列“DataConference”。

发生此错误时，不会应用任何更改。 应重新运行命令，并删除重复测试。

若要从观察程序节点中删除综合事务，请使用 Remove 方法。 例如，此命令从观察程序节点中删除 ABWQ 测试：

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Remove="ABWQ"}

可以使用 Replace 方法将当前启用的所有测试替换为一个或多个新测试。 例如，如果希望观察程序节点仅运行 IM 测试，可以使用以下命令对其进行配置：

Set-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" -Tests @{Replace="IM"}

运行此命令时，将禁用指定观察程序节点上的所有综合事务，IM 除外。

查看和测试观察程序节点配置

如果要查看已分配给观察程序节点的测试，请使用类似于下面的命令：

Get-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object -ExpandProperty Tests

此命令将返回类似于以下内容的信息，具体取决于已分配给节点的综合事务：

注册 IM GroupIM P2PAV AvConference Presence PersistentChatMessage DataConference

提示

若要按字母顺序查看综合事务，请改用以下命令：

Get-CsWatcherNodeConfiguration -Identity "atl-cs-001.litwareinc.com" | Select-Object -ExpandProperty Tests | Sort-Object

若要验证是否已创建观察程序节点，请在 Skype for Business Server 命令行管理程序中键入以下命令：

Get-CsWatcherNodeConfiguration

你将返回类似于以下内容的信息：

标识： atl-cs-001.litwareinc.com TestUsers ： {sip：watcher1@litwareinc.com， sip：watcher2@litwareinc.com ...}ExtendedTests： {TestUsers=IList<System.String>;Name=PSTN 测试;Te...}TargetFqdn ： atl-cs-001.litwareinc.com PortNumber ： 5061 若要验证是否已正确配置观察程序节点，请从 Skype for Business Server 命令行管理程序键入以下命令：

Test-CsWatcherNodeConfiguration

此命令将测试部署中的每个观察程序节点，并确认是否已完成以下操作：

  • 已安装所需的注册器角色

  • 运行 Set-CsWatcherNodeConfiguration cmdlet) 时，将创建 (完成所需的注册表项

  • 服务器运行的是正确版本的 Skype for Business Server

  • 端口配置正确

  • 分配的测试用户具有所需的凭据

管理观察程序节点

除了修改在观察程序节点上执行的综合事务外，还可以使用 Set-CsWatcherNodeConfiguration cmdlet 执行另外两项重要任务：启用和禁用观察程序节点，以及将观察程序节点配置为在运行其测试时使用内部 Web URL 或外部 Web URL。

默认情况下，观察程序节点设计为定期运行其所有已启用的综合事务。 但是，有时可能需要暂停这些事务。 例如，如果观察程序节点暂时与网络断开连接，则没有理由运行综合事务。 如果没有网络连接，这些事务将失败。 若要暂时禁用观察程序节点，请从 Skype for Business Server 命令行管理程序运行类似如下的命令：

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -Enabled $False

此命令将在观察程序节点 atl 观察程序 001.litwareinc.com 上禁用执行综合事务。 若要继续执行综合事务，请将 Enabled 属性设置为 true ($True) ：

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -Enabled $True

注意

Enabled 属性可用于打开或关闭观察程序节点。 如果要永久删除观察程序节点，请使用 Remove-CsWatcherNodeConfiguration cmdlet：

Remove-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com"

该命令从指定计算机中删除所有观察程序节点配置设置，从而阻止该计算机自动运行综合事务。 但是，该命令不会卸载 System Center 代理文件或Skype for Business Server系统文件。

默认情况下，观察程序节点在进行测试时使用组织的外部 Web URL。 但是，也可以将观察程序节点配置为使用组织的内部 Web URL。 这使管理员能够验证位于外围网络内的用户的 URL 访问权限。 若要将观察程序节点配置为使用内部 URL 而不是外部 URL，请将 UseInternalWebURls 属性设置为 True ($True) ：

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -UseInternalWebUrls $True

将此属性重置为默认值 False ($False) 将导致观察程序再次使用外部 URL：

Set-CsWatcherNodeConfiguration -Identity "atl-watcher-001.litwareinc.com" -UseInternalWebUrls $False

综合事务的特殊设置说明

大多数综合事务可以按原样在观察程序节点上运行。 在大多数情况下，只要将综合事务添加到观察程序节点配置设置，观察程序节点就可以在其测试通过期间开始使用该综合事务。 但是，某些综合事务需要特殊设置说明，如以下部分所述。

数据会议综合事务

如果观察程序节点计算机位于外围网络之外，则可能无法运行数据会议综合事务，除非首先通过完成以下步骤禁用网络服务帐户的 Windows Internet Explorer® Internet 浏览器代理设置：

  1. 在观察程序节点计算机上，依次单击“ 开始”、“ 所有程序”、“ 附件”、“ 命令提示符”和“ 以管理员身份运行”。

  2. 在控制台窗口中，键入以下命令，然后按 Enter。

bitsadmin /util /SetIEProxy NetworkService NO_PROXY

你将在命令窗口中看到以下消息：

BITSAdmin 已弃用，不能保证在未来版本的 Windows 中可用。 BITS PowerShell cmdlet 现在提供了 BITS 服务的管理工具。

帐户 NetworkService 的 Internet 代理设置设置为 NO_PROXY。

(连接 = 默认)

此消息指示你已禁用网络服务帐户的 Internet Explorer 代理设置。

Exchange 统一消息综合事务

Exchange 统一消息 (UM) 综合事务验证测试用户是否可以连接到驻留在 Exchange 中的语音邮件帐户。

测试用户需要使用语音邮件帐户进行预配置。

持久聊天综合事务

若要使用持久聊天综合事务，必须先创建一个通道，并授予测试用户使用它的权限。

可以使用持久聊天综合事务来配置此通道：

$cred1 = Get-Credential "contoso\testUser1"
$cred2 = Get-Credential "contoso\testUser2"

Test-CsPersistentChatMessage -TargetFqdn pool0.contoso.com -SenderSipAddress sip:testUser1@contoso.com -SenderCredential $cred1 -ReceiverSipAddress sip:testUser2@contoso.com -ReceiverCredential $cred2 -TestUser1SipAddress sip:testUser1@contoso.com -TestUser2SipAddress sip:testUser2@contoso.com -Setup $true

从企业内部运行此设置任务：

  • 如果从非服务器计算机运行，则执行 cmdlet 的用户必须是 Role-Based 访问控制 (RBAC) 的 CsPersistentChatAdministrators 角色的成员。

  • 如果从服务器本身运行，则执行 cmdlet 的用户必须是 RTCUniversalServerAdmins 组的成员。

PSTN 对等呼叫综合事务

Test-CsPstnPeerToPeerCall综合事务验证通过公用电话交换网络 (PSTN) 拨打和接听呼叫的能力。

若要运行此综合事务，必须配置：

  • 两个已启用 UC 的测试用户 (调用方和接收方) 。

  • 直接传入拨号 (为每个用户帐户) 号码。

  • 允许呼叫接收方号码到达 PSTN 网关的 VoIP 策略和语音路由。

  • 一个 PSTN 网关，它接受呼叫和媒体，根据拨打的号码将呼叫路由回接收方的主池。

统一联系人存储综合事务

统一联系人存储综合事务验证Skype for Business Server是否能够代表 Exchange 用户检索联系人。

若要使用此综合事务，必须满足以下条件：

  • 必须配置Lyss-Exchange服务器到服务器的身份验证。

  • 测试用户必须具有有效的 Exchange 邮箱。

满足这些条件后，可以运行以下Windows PowerShell cmdlet，将测试用户的联系人列表迁移到 Exchange：

Test-CsUnifiedContactStore -TargetFqdn pool0.contoso.com -UserSipAddress sip:testUser1@contoso.com -RegistrarPort 5061 -Authentication TrustedServer -Setup

测试用户联系人列表可能需要一些时间才能迁移到 Exchange。 若要监视迁移进度，可以在不带 -Setup 标志的情况下运行同一命令行：

Test-CsUnifiedContactStore -TargetFqdn pool0.contoso.com -UserSipAddress sip:testUser1@contoso.com -RegistrarPort 5061 -Authentication TrustedServer

迁移完成后，此命令行将成功。

XMPP 综合事务

可扩展消息传送和状态协议 (XMPP) IM 综合事务要求使用一个或多个联合域配置 XMPP 功能。

若要启用 XMPP 综合事务，必须在可路由的 XMPP 域中提供具有用户帐户的 XmppTestReceiverMailAddress 参数。 例如：

Set-CsWatcherNodeConfiguration -Identity pool0.contoso.com -Tests @{Add="XmppIM"} -XmppTestReceiverMailAddress user1@litwareinc.com

在此示例中，需要存在Skype for Business Server规则才能将 litwareinc.com 的消息路由到 XMPP 网关。

注意

XMPP 网关和代理在 2015 Skype for Business Server可用，但在 2019 Skype for Business Server不再受支持。 有关详细信息 ，请参阅迁移 XMPP 联合身份验证 。

视频互操作服务器 (VIS) 综合事务

视频互操作服务器 (VIS) 综合事务需要下载并安装综合事务支持文件 (VISSTSupportPackage.msi) 。

若要安装VISSTSupportPackage.msi，请确保已安装 msi 的系统要求) 下的依赖项 (。 运行 VISSTSupportPackage.msi 以执行简单的安装。 .msi安装以下路径中的所有文件：“%ProgramFiles%\VIS 合成事务支持包”。

有关如何运行 VIS 合成事务的详细信息，请参阅 Test-CsP2PVideoInteropServerSipTrunkAV cmdlet 的文档。

更改综合事务的运行频率

默认情况下，综合事务将每 15 分钟与配置的用户一起运行一次。 综合事务在一组用户中按顺序运行，以避免两个综合事务相互冲突。 需要更长的间隔来提供完成所有综合事务的时间。

如果希望更频繁地运行综合事务，则应减少使用一组给定用户运行的综合事务数，以便测试可以在所需时间范围内完成，并具有一些偶尔网络延迟的缓冲区。 如果需要运行更多综合事务，请创建更多用户集来运行更多综合事务。

若要更改综合事务的运行频率，请执行以下步骤：

  1. 打开 System Center Operations Manager。 单击“创作”部分。 单击“创作) 下的”规则“部分 (

  2. 在“规则”部分中，找到名为“主综合事务运行器性能收集规则”的规则

  3. 右键单击该规则，依次选择“替代”、“重写规则”和“对于类的所有对象：池观察程序”

  4. 在“替代属性窗口，选择”参数名称“”频率“，并将”替代值“设置为所需的值。

  5. 在同一窗口中，选择需要应用此替代的管理包

对综合事务使用丰富日志记录

综合事务有助于识别系统问题。 例如，Test-CsRegistration cmdlet 可能会提醒管理员用户难以注册Skype for Business Server。 但是，可能需要更多详细信息来确定失败的实际原因。

因此，综合事务提供丰富的日志记录。 使用丰富的日志记录，对于合成事务执行的每个活动，将记录以下信息：

  • 活动开始的时间。

  • 活动完成的时间。

  • (执行的操作，例如创建、加入或离开会议;登录到 Skype for Business Server;) 发送即时消息。

  • 活动运行时生成的信息性、详细、警告或错误消息

  • SIP 注册消息。

  • 活动运行时生成的异常记录或诊断代码。

  • 运行活动的净结果。

每次运行综合事务时都会自动生成此信息，但不会自动显示或保存到日志文件。 如果手动运行综合事务，则可以使用 OutLoggerVariable 参数指定存储信息的Windows PowerShell变量。 在其中，可以选择使用两种方法之一，以 XML 或 HTML 格式保存和/或查看富日志中的错误消息。

若要检索故障排除信息，请指定 OutLoggerVariable 参数，后跟所选的变量名称：

Test-CsRegistration -TargetFqdn atl-cs-001.litwareinc.com -OutLoggerVariable RegistrationTest

注意

：不要在变量名称前面加上 $ 字符。 使用变量名称（如 RegistrationTest (不$RegistrationTest) ）。

运行此命令时，会看到如下所示的输出：

目标 Fqdn ： atl-cs-001.litwareinc.com 结果 ： 失败延迟 ： 00：00：00 错误消息 ：此计算机未分配任何证书。 诊断：对于此失败，你可以访问比此处显示的错误消息更详细的信息。 若要以 HTML 格式访问此信息，请使用类似于下面的命令将变量 RegistrationTest 中存储的信息保存到 HTML 文件：

$RegistrationTest.ToHTML() | Out-File C:\Logs\Registration.html

或者，可以使用 ToXML () 方法将数据保存到 XML 文件：

$RegistrationTest.ToXML() | Out-File C:\Logs\Registration.xml

可以使用 Windows Internet Explorer、Microsoft Visual Studio 或任何其他能够打开 HTML/XML 文件的应用程序来查看这些文件。

从 System Center Operations Manager 内部运行的综合事务将自动生成这些日志文件，以用于发生故障。 如果在Skype for Business Server PowerShell 能够加载和运行综合事务之前执行失败，则不会生成这些日志。

重要

默认情况下，Skype for Business Server将日志文件保存到未共享的文件夹。 若要使这些日志易于访问，应共享此文件夹。 例如：\atl-watcher-001.litwareinc.com\WatcherNode。