配置用于Microsoft Teams的CVI并对其进行故障排除
简介
本文档介绍如何配置 Cisco Video Integration (CVI) 与 Microsoft Teams (MS Teams) 的集成并对其进行故障排除。
先决条件
要求
Cisco 建议您了解以下主题：
- Webex Control Hub常规配置
- Office 365(O365)常规配置
- 终端Web管理员配置
- Windows Power Shell配置
- 设备配置的Webex Edge
使用的组件
本文档中的信息基于以下软件和硬件版本：
- O365管理站点
- 带A-MST-WX-CVI-ROOMS许可证的Cisco WebEx Control Hub
- Windows Power Shell版本5.1
- 适用于设备的DX70与Webex Edge
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。
背景信息
所需端口
信令所需的端口：
介质所需的端口：
一键式(OBTP)支持的设备类型
- Webex板、会议室和桌面设备
- Webex Room Kit和Room Phone
- Cisco MX、SX和DX系列
配置
在Control Hub中设置视频集成
步骤1.登录到Webex Control Hub。
步骤2.要检查是否为Webex会话初始协议(SIP)地址设置了子域，请导航到Organization Settings > SIP Address for Cisco Webex Calling。
步骤3.导航。找到Microsoft Teams的视频集成卡，选择设置。（需要额外的许可证）。
步骤4.在Video Integration Setup屏幕上，选择Authorize。
步骤5.选择具有Microsoft Tenant Global Administrator权限的帐户，然后输入凭据。
第6步：要验证请求的权限，请选择接受。此授权 Webex Video Integration应用程序访问你的Microsoft租户。将重定向到Control Hub视频集成安装程序屏幕。
步骤7.在计算机上打开PowerShell窗口，如果尚未安装Microsoft Teams PowerShell模块，请使用以下命令进行安装：
Install-Module MicrosoftTeams -AllowClobber
步骤8.导入Microsoft Teams模块并使用下一个命令连接到您的Teams租户：
Import-Module MicrosoftTeams
Connect-MicrosoftTeams
步骤9.显示Microsoft登录页面。输入具有Microsoft Teams租户管理权限的用户的凭据。如果流程成功，则会提供有关帐户的反馈，并且租户成功登录。
第10步：导航到Control Hub中的Video Integration设置屏幕，选择剪贴板按钮，以便从第一个窗口复制New-CsVideoInteropServiceProvider部分的文本 文本框并将其粘贴到PowerShell会话中并进行确认。
步骤11.选择您想要为用户启用集成的方式。使用示例作为所有用户或每个用户的集成参考，如以下示例所示：
所有用户:
Grant-CsTeamsVideoInteropServicePolicy -PolicyName
CiscoServiceProviderEnabled -Global
每个用户：
Grant-CsTeamsVideoInteropServicePolicy -PolicyName
CiscoServiceProviderEnabled -Identity
步骤12.选择确定以完成设置。
步骤13.如果配置后未完成对PowerShell命令文本的访问，请导航到Control Hub > Hybrid > Services > Video Integration，然后选择Edit settings。
故障排除
案例1. Windows Power Shell中无法识别命令Install-Module
在Windows PowerShell上配置命令Install-Module时，控制台无法识别命令的任何变体：
步骤1.使用Windows Admin帐户打开Windows PowerShell并在控制台上运行命令Get-Command，以验证Install-Module是否列为有效命令。
步骤2.如果未列出该版本，请运行命令Get-Host并验证当前的PowerShell版本：
步骤3.如果PowerShell当前版本低于5.0，请升级到下一个Microsoft文档中提到的所有受支持版本：Install-Module Supported PowerShell version。
步骤4.升级后，再次使用Get-Host命令验证版本是否已更新。
步骤5.运行命令Install-Module MicrosoftTeams -AllowClobber，并使用Y命令进行确认以继续常规安装过程。
案例2. Windows PowerShell中无法识别命令Install-Module
即使使用正确的PowerShell版本，下载过程也可能失败，并出现类似错误，如下图所示：
步骤1.丢弃从服务器到统一资源定位器(URL)的可达性方面的任何问题。 复制PowerShell窗口中指定的URL，并将其粘贴到Web浏览器上，以验证显示的内容。
步骤2.如果连通性不是问题，这可能意味着问题与传输层安全(TLS)协议版本有关。Microsoft已弃用TLS版本1.0和1.1，如下文所示：Microsoft TLS 1.0和1.1禁用通知。
步骤3.要更改TLS默认PowerShell版本，请运行以下命令：
[Net.ServicePointManager]::SecurityProtocol = Net.SecurityProtocolType]::Tls12
步骤4.运行命令Install-Module MicrosoftTeams -AllowClobber，并使用Y命令进行确认，以尝试常规安装过程。
步骤5.使用Y命令确认第二次选择，以便开始下载过程。
步骤6.使用命令Get-InstalledModule确认Microsoft Teams模块已安装，然后继续执行部署过程。
案例3.会议已安排但未在设备上显示
当您在Microsoft Teams上安排会议时，邀请中会显示详细信息，但终端不会显示会议。
Microsoft Teams会议邀请中列出了设备会议室邮箱，某些详细信息未正确配置。
Webex Control Hub也不显示会议信息。
步骤1.导航到O365管理站点https:管理员.Microsoft 。com并使用管理员帐户登录。
步骤2.导航到用户>活动用户菜单。
步骤3.找到会议组织者用户帐户并展开其详细信息。
第4步：导航到用户详细信息中的许可证和应用部分，以查找为其分配的许可证。
步骤5.必须在O365上为每个用户分配Microsoft Teams Exploration许可证。如果未分配此许可证，Microsoft Teams会议详细信息将不会发送到Webex Control Hub上的设备日历。
步骤6.分配许可证并进行测试。
案例4.已分配Microsoft Teams许可证，但设备上仍未显示会议
即使已设置正确的许可证，会议仍不会显示在设备日历上，且来自Webex Control Hub的标语相同：
步骤1.导航到Webex Control Hub。
步骤2.导航到Management > Workspaces，以查找列出的受影响设备。
步骤3.打开设备详细信息，找到Calendar部分。验证为该设备配置的Email Address。
分配给设备的电子邮件地址必须与Control Hub上的设备工作空间显示名称以及O365用户配置上的用户名和电子邮件匹配。如果此信息不匹配，控制中心将无法识别会议并将其转发到正确的设备。
验证
使用来自可行场景的日志的示例：
当一切就绪且完全正常运行时，您可以验证实施是否可以在三个不同的角度上正常工作：
Webex Control hub上的设备日历显示安排的会议以及开始、结束、持续时间和组织者会议的详细信息：
设备显示“一键式”按钮，以及触摸屏上的Microsoft Teams图标：
此外，这可以在终端日志的All.log文件中进行验证。您可以看到以下信息：
它包含指令calendar.meeting.create和唯一的TrackingID。Microsoft Teams列为会议类型：
2021-07-02T15:51:49.571-05:00 appl[2073]: Wx2 I: NotificationChannel: calendar.meeting.create, trackingid ccc_d0965d59-34ea-437e-9c09-c621e871e873
2021-07-02T15:51:49.572-05:00 appl[2073]: Wx2[3]: CalendarClientImpl::on_meeting_updated_event
2021-07-02T15:51:49.573-05:00 appl[2073]: Wx2[1]: Inserting new meeting - organizer='7ad83eb6-549d-4282-86a4-bf3c05e4b6f3' start='2021-07-02T21:00:00.000Z' id='8fd64402-f665-6bd3-bf15-be436bbe2c97' meetingJoinType='MSTEAMS' meetingJoinURI=true meetingJoinURL=true webexURI=false spaceURI=false callURI=false"
new meeting - organizer='7ad83eb6-549d-4282-86a4-bf3c05e4b6f3' start='2021-07-02T21:00:00.000Z' id='8fd64402-f665-6bd3-bf15-be436bbe2c97' meetingJoinType='MSTEAMS' meetingJoinURI=true meetingJoinURL=true webexURI=false spaceURI=false callURI=false"来自Webex的更新事件被推送到终端：
2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2[5]: Creating new Meeting (id=2)
2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2[5]: Attaching CalendarEvent (id=8fd64402-f665-6bd3-bf15-be436bbe2c97) to Meeting (id=2)
2021-07-02T15:51:49.579-05:00 appl[2073]: Wx2 I: Wx2MeetingsHandlerImpl::meetings_updated: num meetings=1修订历史记录
| 版本 | 发布日期 | 备注 |
|---|---|---|
6.0 |
19-May-2026
|
更新的格式、选中的链接、粗体和品牌 |
5.0 |
07-May-2025
|
更新的样式要求和格式。 |
4.0 |
16-Apr-2024
|
更新的SEO、替换文本和格式。 |
3.0 |
24-Feb-2023
|
重新认证 |
1.0 |
06-Jul-2021
|
初始版本 |
反馈