تكوين CVI واستكشاف أخطائه وإصلاحها ل Microsoft Teams

المقدمة

يصف هذا المستند كيفية تكوين Cisco Video Integration ‏(CVI) مع دمج Microsoft Teams ‏(MS Teams) واستكشاف أخطائه وإصلاحها.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• التكوين العام لموزع التحكم في Webex
• التكوين العام ل Office 365 (O365)
• تكوين إدارة ويب لنقطة النهاية
• تكوين Windows Power Shell
• Webex Edge لتكوين الأجهزة

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• موقع إدارة O365
• Cisco WebEx Control Hub باستخدام ترخيص A-MST-WX-CVI-Rooms
• Windows Power Shell الإصدار 5.1
• DX70 مع Webex Edge للأجهزة

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

معلومات أساسية

المنافذ المطلوبة

المنافذ المطلوبة لإرسال الإشارات:

المنافذ المطلوبة للوسائط:

أنواع الأجهزة المدعومة لزر واحد للضغط (OBTP)

• لوحة Webex وأجهزة الغرفة والمكتب
• Webex Room Kit وهاتف الغرفة
• سلسلة MX و SX و DX من Cisco

التكوين

إعداد دمج الفيديو في لوحة التحكم

الخطوة 1. سجل الدخول إلى Webex Control Hub.

الخطوة 2. للتحقق من تعيين المجال الفرعي لعناوين بروتوكول بدء جلسة عمل WebEx (SIP)، انتقل إلى إعدادات المؤسسة >عنوان SIP للاتصال عبر Cisco Webex.

ملاحظة: في حالة عدم تعيينها، راجع المستند التالي، وغير عنوان SIP ل Cisco Webex.

الخطوة 3. انتقل إلى Services >هجين. حدد موقع بطاقة تكامل الفيديو ل Microsoft Teams، حدد إعداد. (مطلوب ترخيص إضافي).

تحذير: وفي هذه المرحلة، يلزم الحصول على ترخيص A-MST-WX-CVI-Rooms من أجل إحراز مزيد من التقدم.

الخطوة 4. في شاشة إعداد تكامل الفيديو، حدد تخويل.

الخطوة 5. حدد الحساب الذي يحتوي على امتيازات مسؤول Microsoft Tenant العمومي، وأدخل بيانات الاعتماد.

ملاحظة: يجب على مستخدم Microsoft المصادقة مرتين منفصلتين على الأقل. من المستحسن تنفيذ الخطوات بواسطة مسؤول Microsoft لديه وصول كامل للمسؤول إلى Control Hub.

الخطوة 6. للتحقق من صحة الأذونات المطلوبة، حدد قبول. هذا يمنح يقوم تطبيق تكامل الفيديو Webex بالوصول إلى مستأجر Microsoft الخاص بك. تتم إعادة التوجيه إلى شاشة إعداد تكامل فيديو Control Hub.

الخطوة 7. افتح نافذة PowerShell على الكمبيوتر وقم بتثبيت الوحدة النمطية MicrosoftTeams PowerShell إذا لم تكن مثبتة بالفعل مع الأمر التالي:

Install-Module MicrosoftTeams -AllowClobber

الخطوة 8. قم باستيراد الوحدة النمطية MicrosoftTeams واتصل بمستأجر Teams الخاص بك باستخدام الأمر التالي:

Import-Module MicrosoftTeams
Connect-MicrosoftTeams

الخطوة 9. تظهر صفحة تسجيل دخول Microsoft. أدخل بيانات اعتماد المستخدم مع امتيازات إدارة Microsoft Teams للمستأجر. في حالة نجاح العملية، يتم توفير الملاحظات حول الحساب ويتم تسجيل دخول المستأجر بنجاح.

الخطوة 10. انتقل إلى شاشة إعداد تكامل الفيديو في Control Hub، حدد الزر الحافظة لنسخ نص قسم New-CsVideoInteropServiceProvider، من الأول مربع نص ولصقه في جلسة عمل PowerShell وتأكيده. 

الخطوة 11. حدد الطريقة التي تريد تمكين التكامل بها للمستخدمين. أستخدم الأمثلة كمرجع للتكامل لكافة المستخدمين أو لكل مستخدم كما هو موضح في الأمثلة التالية:

جميع المستخدمين:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
 CiscoServiceProviderEnabled -Global

لكل مستخدم:

Grant-CsTeamsVideoInteropServicePolicy -PolicyName 
CiscoServiceProviderEnabled -Identity

الخطوة 12. حدد موافق لإكمال الإعداد.

ملاحظة: قد تستغرق تغييرات PowerShell لمستأجر Microsoft وقتا للانتشار في بيئة Microsoft 365. وتقول مايكروسوفت إن هذا قد يستغرق 6 ساعات، على الرغم من أن ذلك يستغرق في العادة أقل من 20 دقيقة.

الخطوة 13. في حالة عدم اكتمال الوصول إلى نص الأمر PowerShell بعد التكوين، انتقل إلى Control Hub > Hybrid > Services > تكامل الفيديو ثم حدد إعدادات التحرير.

استكشاف الأخطاء وإصلاحها

حالة 1. لم يتم التعرف على وحدة Install-Module للأوامر في Windows Power Shell

عند تكوين الأمر install-module على Windows PowerShell، لا يتم التعرف على أي تباين من الأمر بواسطة وحدة التحكم:

الخطوة 1. باستخدام حساب إدارة Windows، افتح Windows PowerShell وقم بتشغيل الأمر get-command على وحدة التحكم للتحقق من ما إذا كان Install-Module مدرجا كأمر صالح.

الخطوة 2. في حالة عدم إدراجها، قم بتشغيل الأمر get-host وقم بالتحقق من صحة إصدار PowerShell الحالي:

الخطوة 3. في حالة أن إصدار PowerShell الحالي أقدم من 5.0، قم بالترقية إلى أي إصدار مدعوم مذكور في مستند Microsoft التالي: Install-Module مدعوم إصدار PowerShell.

الخطوة 4. بعد الترقية، تحقق مرة أخرى من تحديث الإصدار الآن باستخدام الأمر get-host.

الخطوة 5. قم بتشغيل الأمر install-module MicrosoftTeams -AllowClobber، والتأكيد باستخدام الأمر Y لمتابعة عملية التثبيت العادية.

حالة 2. لم يتم التعرف على وحدة Command Install-Module في Windows PowerShell

حتى مع إصدار PowerShell الصحيح، يمكن أن تفشل عملية التنزيل مع حدوث خطأ مماثل كما هو موضح في الصورة التالية:

الخطوة 1. تجاهل أي مشكلة مع إمكانية الوصول من الخادم إلى محدد موقع الموارد الموحد (URL). انسخ عنوان URL المحدد في نافذة PowerShell، ولصقه في مستعرض ويب للتحقق من صحة المحتوى المعروض.

الخطوة 2. إذا لم تكن إمكانية الوصول مشكلة، فهذا قد يعني أن المشكلة متعلقة بإصدار بروتوكول أمان طبقة النقل (TLS). Microsoft الإصداران 1.0 و 1.1 من TLS المهملين كما هو موضح في المستند التالي: إشعار التعطيل Microsoft TLS 1.0 و 1.1.

الخطوة 3. لتغيير إصدار PowerShell الافتراضي من TLS، قم بتشغيل الأمر التالي:

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

الخطوة 4. قم بتشغيل الأمر install-module MicrosoftTeams -AllowClobber، والتأكيد باستخدام الأمر Y لمحاولة عملية التثبيت العادية.

الخطوة 5. قم بتأكيد التحديد الثاني باستخدام الأمر Y لبدء عملية التنزيل.

الخطوة 6. تأكد من تثبيت وحدة Microsoft Teams باستخدام الأمر Get-InstallModule، وتابع عملية النشر.

الحالة 3. تمت جدولة الاجتماع ولكن لا يتم عرضه على الجهاز

عند جدولة إجتماع في MS Teams، يتم عرض التفاصيل ضمن الدعوة، ومع ذلك، لا تظهر نقطة النهاية الاجتماع. 

تظهر علبة بريد Device Room في قائمة دعوة إجتماع Microsoft Teams، ولم يتم تكوين بعض التفاصيل بشكل صحيح.

لا يعرض Webex Control Hub معلومات الاجتماع أيضا.

الخطوة 1. انتقل إلى https لموقع إدارة O365 : مدير . مايكروسوفت . com و login بحساب مشرف.

الخطوة 2. انتقل إلى المستخدمين > المستخدمين النشطين قائمة.

الخطوة 3. حدد موقع حساب مستخدم منظم الاجتماع وقم بتوسيع تفاصيله.

الخطوة 4. انتقل إلى قسم التراخيص والتطبيقات داخل تفاصيل المستخدم للعثور على التراخيص المعينة له.

الخطوة 5. يجب تعيين الترخيص الاستكشافي ل Microsoft Teams لكل مستخدم على O365. في حالة عدم تعيين ذلك، لا يتم إرسال تفاصيل إجتماع MS Teams إلى تقويم الجهاز على Webex Control Hub.

الخطوة 6. تعيين الترخيص والاختبار.

الحالة 4. تم تعيين ترخيص MS Teams، ولكن لا يزال الاجتماع غير معروض على الجهاز

حتى بعد وضع التراخيص المناسبة، لا يتم عرض الاجتماع بعد على تقويم الجهاز مع نفس الشعار من Webex Control Hub:

الخطوة 1. انتقل إلى Webex Control Hub.

الخطوة 2. انتقل إلى الإدارة > مساحات العمل، للعثور على الجهاز المتأثر المدرج. 

الخطوة 3. افتح تفاصيل الجهاز، وحدد موقع قسم التقويم. تحقق من صحة عنوان البريد الإلكتروني الذي تم تكوينه لهذا الجهاز.

يجب أن يتطابق عنوان البريد الإلكتروني المعين للجهاز مع اسم عرض مساحة عمل الجهاز على Control Hub واسم المستخدم والبريد الإلكتروني على تكوين مستخدم O365. في حالة عدم تطابق هذه المعلومات، يتعذر على Control Hub تحديد الاجتماع وإعادة توجيهه إلى الجهاز المناسب.

ملاحظة: هذا الحقل ليس حساسا لحالة الأحرف. على أي حال، يجب أن تطابق تماما أي حرف أو رمز آخر.

التحقق من الصحة

مثال مع سجلات من سيناريو قابل للتطبيق:

عندما يكون كل شيء في موضعه ويعمل بشكل كامل، يمكنك التحقق من أن التنفيذ يعمل بشكل صحيح على ثلاث وجهات نظر مختلفة:

يظهر "تقويم الجهاز" الموجود على محور التحكم في Webex الاجتماع المجدول بتفاصيل إجتماع "البدء" و"النهاية" و"المدة" و"المنظم":

يعرض الجهاز الزر "واحد" للضغطة، بالإضافة إلى أيقونة MS Teams على لوحة اللمس:

وبالإضافة إلى ذلك، يمكن التحقق من هذا في ملف 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