Microsoft Teams用CVIの設定およびトラブルシューティング

はじめに

このドキュメントでは、Microsoft Teams（MS Teams）統合による Cisco Video Integration（CVI）の設定およびトラブルシューティング方法について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Webex Control Hubの一般設定
• Office 365 (O365)一般構成
• エンドポイントWeb管理者設定
• Windows Power Shellの構成
• Webex Edge for Devicesの設定

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

• O365管理サイト
• Cisco WebEx Control Hub with A-MST-WX-CVI-ROOMSライセンス
• Windows Power Shellバージョン5.1
• デバイス向けWebEx Edgeを備えたDX70

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

背景説明

必要なポート

シグナリングに必要なポート：

メディアに必要なポート：

One Button To Push(OBTP)でサポートされるデバイスタイプ

• Webexボード、会議室、デスクデバイス
• Webexルームキットおよびルームフォン
• Cisco MX、SX、およびDXシリーズ

コンフィギュレーション

Control Hubでのビデオ統合の設定

ステップ 1：Webex Control Hubにサインインします。

ステップ 2：サブドメインにWebex Session Initiation Protocol(SIP)アドレスが設定されているかどうかを確認するには、Organization Settings >SIP Address for Cisco Webex Callingに移動します。

注：設定されていない場合は、次のドキュメント「Change Your Cisco Webex SIP Address」を確認してください。

ステップ 3：Services > Hybridの順に移動します。Microsoft Teamsのビデオ統合カードを探し、「設定」を選択します。（追加ライセンスが必要です）。

警告：この時点で、さらに作業を進めるにはA-MST-WX-CVI-ROOMSライセンスが必要です。

ステップ 4：Video Integration Setup画面で、Authorizeを選択します。

ステップ 5：Microsoft Tenant Global Administrator 権限を持つアカウントを選択し、クレデンシャルを入力します。

注:Microsoftユーザは、少なくとも2回の認証を個別に行う必要があります。この手順は、Control Hubへの完全な管理者アクセス権を持つアカウントを持つMicrosoft管理者が実行することをお勧めします。

手順 6：要求された権限を検証するには、Acceptを選択します。これは、 Webex Video IntegrationアプリケーションがMicrosoftテナントにアクセスします。 Control Hub Video Integration Setup画面にリダイレクト。

手順 7：コンピュータのPowerShellウィンドウを開き、MicrosoftTeams PowerShellモジュールがインストールされていない場合は、次のコマンドを使用してインストールします。

Install-Module MicrosoftTeams -AllowClobber

ステップ 8：MicrosoftTeamsモジュールをインポートし、次のコマンドを使用してTeamsテナントに接続します。

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

ステップ 9：Microsoftサインインページが表示されます。テナントのMicrosoft Teams管理権限を持つユーザのクレデンシャルを入力します。プロセスが正常に完了すると、アカウントとテナントに関するフィードバックが提供され、テナントが正常にサインインします。

ステップ 10：Control HubのVideo Integration設定画面に移動し、clipboardボタンを選択して、New-CsVideoInteropServiceProviderセクションのテキストを最初からコピーします テキストボックスを貼り付け、PowerShellセッションに貼り付けて確認します。 

ステップ 11ユーザーに対して統合を有効にする方法を選択します。すべてのユーザを統合する際の参考として、または次の例に示すようにユーザ単位で、これらの例を使用してください。

すべてのユーザ:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

ユーザーごと：

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

ステップ 12Okを選択して設定を完了します。

注:Microsoftテナントに対するPowerShellの変更は、Microsoft 365環境に反映されるまでに時間がかかる場合があります。Microsoftによると、この処理には最大6時間かかりますが、通常は20分未満で完了します。

ステップ 13設定完了後にPowerShellコマンドテキストにアクセスできない場合は、Control Hub > Hybrid > Services > Video Integrationの順に移動し、Edit settingsを選択します。

トラブルシュート

Case 1.Windows Power Shellで認識されないInstall-Moduleコマンド

Install-ModuleコマンドがWindows PowerShellで設定されている場合、コマンドからのバリエーションはコンソールでは認識されません。

ステップ 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コマンドで確認して、通常のインストールプロセスを続行します。

Case 2.コマンドInstall-ModuleがWindows PowerShellで認識されない

正しいPowerShellバージョンでも、ダウンロードプロセスが失敗し、次の図に示すような同様のエラーが表示されることがあります。

ステップ 1：サーバからUniform Resource Locator(URL)への到達可能性に関する問題を廃棄します。 PowerShellウィンドウで指定したURLをコピーし、Webブラウザに貼り付けて、コンテンツが表示されることを確認します。

ステップ 2：到達可能性に問題がない場合は、問題がTransport Layer Security(TLS)プロトコルバージョンに関連していることを意味します。Microsoftでは、次のドキュメント「Microsoft TLS 1.0および1.1無効化に関する通知」に記載されているように、TLSバージョン1.0および1.1を廃止しました。

ステップ 3：TLSのデフォルトのPowerShellバージョンを変更するには、次のコマンドを実行します。

[Net.ServicePointManager]::SecurityProtocol = Net.SecurityProtocolType]::Tls12

ステップ 4：Install-Module MicrosoftTeams -AllowClobberコマンドを実行し、Yコマンドで確認して、通常のインストールプロセスを試行します。

ステップ 5：2番目の選択は、Yコマンドで確認し、ダウンロード処理を開始します。

手順 6：Get-InstalledModuleコマンドを使用してMicrosoft Teamsモジュールがインストールされていることを確認し、展開プロセスを続行します。

Case 3.会議はスケジュールされているがデバイスに表示されない

MS Teamsで会議をスケジュールすると、詳細が招待状に表示されますが、エンドポイントには会議が表示されません。 

デバイスルームのメールボックスがMicrosoft Teamsの会議の招待内に一覧表示されていますが、一部の詳細が正しく構成されていません。

Webex Control Hubでは、会議情報も表示されません。

ステップ 1：O365管理サイトhttps : admin . microsoft . comに移動し、管理者アカウントでログインします。

ステップ 2：Users > Active Usersメニューに移動します。

ステップ 3： 会議開催者のユーザアカウントを見つけて、その詳細を展開します。

ステップ 4：割り当てられているライセンスを見つけるには、ユーザの詳細でLicenses and Appsセクションに移動します。

ステップ 5：Microsoft Teams Exploratoryライセンスは、O365の各ユーザに割り当てる必要があります。これが割り当てられていない場合、MS Teams会議の詳細はWebex Control Hubのデバイスカレンダーに送信されません。

手順 6：ライセンスを割り当ててテストします。

ケース 4.MS Teamsライセンスが割り当てられているが、会議がデバイスに表示されない

適切なライセンスを設定しても、Webex Control Hubの同じバナーが表示され、会議がまだデバイスのカレンダーに表示されていない。

ステップ 1：Webex Control Hubに移動します。

ステップ 2：Management > Workspacesの順に移動し、該当するデバイスを見つけます。 

ステップ 3：デバイスの詳細を開き、カレンダーセクションを見つけます。そのデバイスに設定されている電子メールアドレスを確認します。

デバイスに割り当てられた電子メールアドレスは、Control Hubのデバイスワークスペース表示名と、O365ユーザ設定のユーザ名および電子メールと一致する必要があります。この情報が一致しない場合、Control Hubは会議を識別して適切なデバイスに転送できません。

注：このフィールドでは、大文字と小文字は区別されません。ただし、他の文字または記号と完全に一致している必要があります。

確認

実行可能なシナリオのログの例：

すべてが適切に機能し、完全に動作可能になったら、次の3つの異なる観点で実装が適切に機能することを検証できます。

Webex Control Hubのデバイスカレンダーに、スケジュールされた会議が表示され、会議の開始、終了、期間、および開催者の会議の詳細が示されます。

デバイスは、タッチパネル上のMS Teamsアイコンと共に、押すボタンを1つ表示します。

また、これはエンドポイントログからAll.logファイルで確認できます。次の情報が表示されます。

これには、calendar.meeting.create命令と一意のTrackingIDが含まれます。MSTEAMSが会議タイプとしてリストされます。

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