مشاركة عبر

استخدام شبكة تسليم المحتوى Office 365 (CDN) مع SharePoint Online

  • مقالة

يمكنك استخدام شبكة تسليم المحتوى Office 365 المضمنة (CDN) لاستضافة الأصول الثابتة لتوفير أداء أفضل لصفحات SharePoint Online. يعمل Office 365 CDN على تحسين الأداء عن طريق التخزين المؤقت للأصول الثابتة الأقرب إلى المستعرضات التي تطلبها، مما يساعد على تسريع التنزيلات وتقليل زمن الانتقال. أيضا، يستخدم Office 365 CDN بروتوكول HTTP/2 لتحسين الضغط وتوجيه HTTP. يتم تضمين خدمة Office 365 CDN كجزء من اشتراك SharePoint Online.

الحذر

نظرا لأن الصور تدار الآن تلقائيا في شبكة تسليم المحتوى الخاصة المدارة بواسطة خدمة SharePoint Online، فإن شبكة تسليم المحتوى الخاصة المكونة يدويا قيد الإهمال. يعني هذا السلوك أن العملاء لم يعودوا بحاجة إلى تكوين CDN خاص. تظل الممارسة الموصى بها دون تغيير حيث تتم استضافة الصور عبر شبكة تسليم المحتوى الخاصة المدارة بواسطة الخدمة تلقائيا. يستمر توفر شبكة تسليم المحتوى العامة لجميع أنواع الملفات الأخرى (على سبيل المثال، CSS وJS). يحتاج العملاء الذين يستخدمون شبكة تسليم المحتوى الخاصة لأنواع الملفات بخلاف الصور إلى نقل هذه الملفات إلى شبكة تسليم المحتوى العامة. نوصي ب CDN العام لهذه الأنواع من الملفات لتحسين الأداء.

ملاحظة

لا يتوفر Office 365 CDN إلا للمستأجرين في سحابة الإنتاج (في جميع أنحاء العالم). لا يدعم المستأجرون في سحابة حكومة الولايات المتحدة والصين حاليا Office 365 CDN.

يتكون Office 365 CDN من شبكات CDN متعددة تسمح لك باستضافة أصول ثابتة في مواقع أو أصول متعددة، وخدمتها من شبكات عالمية عالية السرعة. اعتمادا على نوع المحتوى الذي تريد استضافته في Office 365 CDN، يمكنك إضافة أصول عامة أو أصول خاصة أو كليهما. راجع اختيار ما إذا كان يجب أن يكون كل أصل عاما أو خاصا لمزيد من المعلومات حول الفرق بين الأصول العامة والخاصة.

Office 365 الرسم التخطيطي المفاهيمي ل CDN.

إذا كنت على دراية بالفعل بالطريقة التي تعمل بها شبكات CDN، فستحتاج فقط إلى إكمال بضع خطوات لتمكين Office 365 CDN للمستأجر الخاص بك. توضح هذه المقالة كيفية القيام بذلك. تابع القراءة للحصول على معلومات حول كيفية البدء في استضافة أصولك الثابتة.

تلميح

هناك شبكات CDN أخرى مستضافة من Microsoft يمكن استخدامها مع Office 365 لسيناريوهات الاستخدام المتخصصة، ولكن لم تتم مناقشتها في هذا الموضوع لأنها تقع خارج نطاق شبكة تسليم المحتوى Office 365. لمزيد من المعلومات، راجع شبكات تسليم المحتوى الأخرى من Microsoft.

ارجع إلى تخطيط الشبكة وضبط الأداء Office 365.

نظرة عامة حول العمل مع Office 365 CDN في SharePoint Online

لإعداد Office 365 CDN لمؤسستك، اتبع الخطوات الأساسية التالية:

بمجرد الانتهاء من الإعداد، يمكنك إدارة Office 365 CDN بمرور الوقت عن طريق:

  • إضافة الأصول وتحديثها وإزالتها
  • إضافة الأصول وإزالتها
  • تكوين نهج CDN
  • إذا لزم الأمر، تعطيل CDN

وأخيرا، راجع استخدام أصول CDN الخاصة بك للتعرف على الوصول إلى أصول CDN الخاصة بك من الأصول العامة والخاصة على حد سواء.

راجع استكشاف أخطاء Office 365 CDN وإصلاحها للحصول على إرشادات حول حل المشكلات الشائعة.

التخطيط لتوزيع شبكة تسليم المحتوى Office 365

قبل توزيع Office 365 CDN لمستأجر Office 365 الخاص بك، يجب مراعاة العوامل التالية كجزء من عملية التخطيط الخاصة بك.

تحديد الأصول الثابتة التي تريد استضافتها على شبكة تسليم المحتوى

بشكل عام، تعد شبكات تسليم المحتوى أكثر فعالية لاستضافة الأصول الثابتة أو الأصول التي لا تتغير في كثير من الأحيان. قاعدة جيدة من الإبهام هي تحديد الملفات التي تفي ببعض أو كل هذه الشروط:

  • الملفات الثابتة المضمنة في صفحة (مثل البرامج النصية والصور) التي قد يكون لها تأثير كبير على أوقات تحميل الصفحة.
  • ملفات كبيرة مثل الملفات التنفيذية وملفات التثبيت.
  • مكتبات الموارد التي تدعم التعليمات البرمجية من جانب العميل.

على سبيل المثال، يمكن أن تؤدي إضافة الملفات الصغيرة المطلوبة بشكل متكرر (صور الموقع والبرامج النصية) إلى أصل CDN إلى تحسين أداء عرض الموقع بشكل كبير وتقليل الحمل على مواقع SharePoint Online بشكل متزايد. يمكن تنزيل الملفات الأكبر (الملفات التنفيذية للتثبيت) من CDN، ما يؤدي إلى تأثير إيجابي على الأداء وتقليل الحمل اللاحق على موقع SharePoint Online، حتى إذا لم يتم الوصول إليها في كثير من الأحيان.

يعتمد تحسين الأداء على أساس كل ملف على العديد من العوامل، بما في ذلك قرب العميل من أقرب نقطة نهاية CDN، والظروف العابرة على الشبكة المحلية، وما إلى ذلك. العديد من الملفات الثابتة صغيرة، ويمكن تنزيلها من Office 365 في أقل من ثانية. ومع ذلك، قد تحتوي صفحة ويب على العديد من الملفات المضمنة مع وقت تنزيل تراكمي لعدة ثوان. يمكن أن تؤدي خدمة هذه الملفات من CDN إلى تقليل وقت تحميل الصفحة الإجمالي بشكل كبير. راجع ما هي مكاسب الأداء التي توفرها شبكة تسليم المحتوى؟ على سبيل المثال.

تحديد المكان الذي تريد تخزين أصولك فيه

تجلب شبكة تسليم المحتوى أصولك من موقع يسمى الأصل. يمكن أن يكون الأصل عبارة عن موقع SharePoint أو مكتبة مستندات أو مجلد يمكن الوصول إليه بواسطة عنوان URL. لديك مرونة كبيرة عند تحديد الأصول لمؤسستك. على سبيل المثال، يمكنك تحديد أصول متعددة أو أصل واحد حيث تريد وضع جميع أصول CDN الخاصة بك. يمكنك اختيار الحصول على أصول عامة أو خاصة لمؤسستك. تختار معظم المؤسسات تنفيذ مزيج من الاثنين.

يمكنك إنشاء حاوية جديدة لأصولك مثل المجلدات أو مكتبات المستندات وإضافة الملفات التي تريد توفيرها من CDN. هذا نهج جيد لمجموعة معينة من الأصول التي تريد أن تكون متاحة من CDN، وتريد تقييد مجموعة أصول CDN لتلك الملفات فقط في الحاوية.

يمكنك أيضا تكوين مجموعة مواقع مشتركة أو موقع أو مكتبة أو مجلد موجود كأصل، ما يجعل جميع الأصول المؤهلة في الحاوية متاحة من CDN. قبل إضافة حاوية موجودة كأصل، من المهم التأكد من أنك على دراية بمحتوياتها وأذوناتها حتى لا تعرض الأصول عن غير قصد للوصول المجهول أو المستخدمين غير المصرح لهم.

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

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

اختيار ما إذا كان يجب أن يكون كل أصل عاما أو خاصا

عند تحديد أصل، يمكنك تحديد ما إذا كان يجب جعله عاما أو خاصا. الوصول إلى أصول CDN في الأصول العامة مجهول، ويتم تأمين محتوى CDN في الأصول الخاصة بواسطة الرموز المميزة التي تم إنشاؤها ديناميكيا لمزيد من الأمان. بغض النظر عن الخيار الذي تختاره، تقوم Microsoft بكل الأحمال الثقيلة نيابة عنك عندما يتعلق الأمر بإدارة CDN نفسها. يمكنك أيضا تغيير رأيك لاحقا، بعد إعداد CDN وتحديد أصولك.

يوفر كل من الخيارات العامة والخاصة مكاسب أداء مماثلة، ولكن لكل منها سمات ومزايا فريدة.

يمكن الوصول إلى الأصول العامة داخل Office 365 CDN بشكل مجهول، ويمكن الوصول إلى الأصول المستضافة من قبل أي شخص لديه عنوان URL للأصل. نظرا لأن الوصول إلى المحتوى في الأصول العامة مجهول، يجب عليك استخدامه فقط لتخزين المحتوى العام غير المهم مثل ملفات JavaScript والبرامج النصية والأيقونات والصور مؤقتا.

توفر الأصول الخاصة داخل Office 365 CDN وصولا خاصا إلى محتوى المستخدم مثل مكتبات مستندات SharePoint Online والمواقع والصور الخاصة. يتم تأمين الوصول إلى المحتوى في الأصول الخاصة بواسطة الرموز المميزة التي تم إنشاؤها ديناميكيا بحيث يمكن الوصول إليها فقط من قبل المستخدمين الذين لديهم أذونات لمكتبة المستندات الأصلية أو موقع التخزين الأصلي. يمكن استخدام الأصول الخاصة في Office 365 CDN فقط لمحتوى SharePoint Online، ويمكنك فقط الوصول إلى الأصول في الأصول الخاصة من خلال إعادة التوجيه من مستأجر SharePoint Online.

يمكنك قراءة المزيد حول كيفية عمل وصول CDN إلى الأصول في أصل خاص في استخدام الأصول في الأصول الخاصة.

سمات ومزايا استضافة الأصول في الأصول العامة

  • يمكن للجميع الوصول إلى الأصول المكشوفة في الأصل العام بشكل مجهول.

    هام

    يجب عدم وضع الموارد التي تحتوي على معلومات المستخدم أو التي تعتبر حساسة لمؤسستك في أصل عام.

  • إذا قمت بإزالة أصل من أصل عام، فقد يستمر توفر الأصل لمدة تصل إلى 30 يوما من ذاكرة التخزين المؤقت؛ ومع ذلك، نقوم بإبطال الارتباطات إلى الأصل في CDN في غضون 15 دقيقة.

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

  • بينما يمكنك إنشاء عنوان URL للأصل العام، يجب المتابعة بحذر، واستخدام خاصية سياق الصفحة، واتباع الإرشادات للقيام بذلك. إذا أصبح الوصول إلى CDN غير متوفر، فلن يتم حل عنوان URL تلقائيا لمؤسستك في SharePoint Online وقد يؤدي إلى ارتباطات مقطوعة وأخطاء أخرى. يخضع عنوان URL أيضا للتغيير، لذلك لا يجب أن تصعب تعليمته البرمجية على القيمة الحالية.

  • أنواع الملفات الافتراضية المضمنة في الأصول العامة هي: .cssو .eot.gifو .icoو .jpeg.woff.jpg.svg.js.map.png.ttf..woff2 يمكنك تحديد أنواع ملفات إضافية.

  • يمكنك تكوين نهج لاستبعاد الأصول استنادا إلى تصنيفات الموقع المحددة. على سبيل المثال، يمكنك استبعاد جميع الأصول التي تم وضع علامة عليها على أنها "سرية" أو "مقيدة"، حتى إذا كانت من أنواع الملفات المسموح بها وتقع في أصل عام.

سمات ومزايا استضافة الأصول في الأصول الخاصة

  • يمكن استخدام الأصول الخاصة فقط لأصول SharePoint Online.

  • يمكن للمستخدمين الوصول إلى الأصول من أصل خاص فقط إذا كان لديهم أذونات للوصول إلى الحاوية. يتم منع الوصول المجهول إلى هذه الأصول.

  • يجب الإشارة إلى الأصول في الأصول الخاصة من مستأجر SharePoint Online. لا يعمل الوصول المباشر إلى أصول CDN الخاصة.

  • إذا قمت بإزالة أصل من الأصل الخاص، فقد يستمر توفر الأصل لمدة تصل إلى ساعة من ذاكرة التخزين المؤقت. ولكن الروابط إلى الأصل في شبكة تسليم المحتوى غير صالحة في غضون 15 دقيقة من إزالة الأصل.

  • أنواع الملفات الافتراضية المضمنة للأصول الخاصة هي .gif .ico .jpeg .jpg .js .png. يمكنك تحديد أنواع ملفات إضافية.

  • تماما كما هو الحال مع الأصول العامة، يمكنك تكوين نهج لاستبعاد الأصول التي تحددها تصنيفات المواقع التي تحددها حتى إذا كنت تستخدم أحرف البدل لتضمين جميع الأصول داخل مجلد أو مكتبة مستندات.

لمزيد من المعلومات حول سبب استخدام Office 365 CDN ومفاهيم CDN العامة وشبكات تسليم المحتوى الأخرى من Microsoft التي يمكنك استخدامها مع مستأجر Office 365، راجع شبكات تسليم المحتوى.

أصول CDN الافتراضية

ما لم تحدد خلاف ذلك، Office 365 إعداد بعض الأصول الافتراضية لك عند تمكين Office 365 CDN. إذا اخترت في البداية عدم توفيرها، يمكنك إضافة هذه الأصول بعد إكمال الإعداد. ما لم تفهم عواقب تخطي إعداد الأصول الافتراضية ولديك سبب محدد للقيام بذلك، يجب السماح بإنشائها عند تمكين CDN.

أصول CDN الخاصة الافتراضية:

  • */siteassets

أصول CDN العامة الافتراضية:

  • */الصفحة الرئيسية
  • */مكتبة الأنماط
  • */clientsideassets

ملاحظة

clientsideassets هو أصل عام افتراضي تمت إضافته إلى خدمة Office 365 CDN في ديسمبر 2017. يجب أن يكون هذا الأصل موجودا لكي تعمل الحلول إطار عمل SharePoint في CDN. إذا قمت بتمكين Office 365 CDN قبل ديسمبر 2017، أو إذا تخطيت إعداد الأصول الافتراضية عند تمكين CDN، يمكنك إضافة هذا الأصل يدويا. لمزيد من المعلومات، راجع جزء الويب الخاص بي من جانب العميل أو إطار عمل SharePoint الحل لا يعمل.

إعداد وتكوين Office 365 CDN باستخدام SharePoint Online Management Shell

تتطلب منك الإجراءات الواردة في هذا القسم استخدام SharePoint Online Management Shell للاتصال ب SharePoint Online. للحصول على الإرشادات، راجع الاتصال ب SharePoint Online PowerShell.

أكمل هذه الخطوات لإعداد شبكة تسليم المحتوى وتكوينها لاستضافة أصولك في SharePoint Online باستخدام SharePoint Online Management Shell.

تحديد للتوسيع

تمكين مؤسستك من استخدام Office 365 CDN

قبل إجراء تغييرات على إعدادات CDN للمستأجر، يجب استرداد الحالة الحالية لتكوين CDN الخاص في مستأجر Office 365. اتصل بالمستأجر باستخدام SharePoint Online Management Shell:

Connect-SPOService -Url https://contoso-admin.sharepoint.com

استخدم الآن الأمر Cmdlet Get-SPOTenantCdnEnabled لاسترداد إعدادات حالة CDN من المستأجر:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

تظهر حالة CDN ل CdnType المحدد على الشاشة.

استخدم الأمر cmdlet Set-SPOTenantCdnEnabled لتمكين مؤسستك من استخدام Office 365 CDN. يمكنك تمكين مؤسستك من استخدام الأصول العامة أو الأصول الخاصة أو كليهما في وقت واحد. يمكنك أيضا تكوين CDN لتخطي إعداد الأصول الافتراضية عند تمكينها. يمكنك دائما إضافة هذه الأصول لاحقا كما هو موضح في هذه المقالة.

في Windows PowerShell ل SharePoint Online:

Set-SPOTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true

على سبيل المثال، لتمكين مؤسستك من استخدام الأصول العامة والخاصة، اكتب الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

لتمكين مؤسستك من استخدام الأصول العامة والخاصة ولكن تخطي إعداد الأصول الافتراضية، اكتب الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins

راجع أصول CDN الافتراضية للحصول على معلومات حول الأصول التي يتم توفيرها بشكل افتراضي عند تمكين Office 365 CDN، والتأثير المحتمل لتخطي إعداد الأصول الافتراضية.

لتمكين مؤسستك من استخدام الأصول العامة، اكتب الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

لتمكين مؤسستك من استخدام الأصول الخاصة، اكتب الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

لمزيد من المعلومات حول أمر cmdlet هذا، راجع Set-SPOTenantCdnEnabled.

تغيير قائمة أنواع الملفات لتضمينها في Office 365 CDN (اختياري)

تلميح

عند تعريف أنواع الملفات باستخدام الأمر Cmdlet Set-SPOTenantCdnPolicy ، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت تريد إضافة أنواع ملفات إضافية إلى القائمة، فاستخدم cmdlet أولا لمعرفة أنواع الملفات المسموح بها بالفعل وتضمينها في القائمة مع أنواع الملفات الجديدة.

استخدم الأمر Cmdlet Set-SPOTenantCdnPolicy لتعريف أنواع الملفات الثابتة التي يمكن استضافتها بواسطة الأصول العامة والخاصة في CDN. بشكل افتراضي، يسمح بأنواع الأصول الشائعة، على سبيل المثال .css .gif .jpg .js.

في Windows PowerShell ل SharePoint Online:

Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"

على سبيل المثال، لتمكين CDN من استضافة ملفات .css وملفات .png، يمكنك إدخال الأمر :

Set-SPOTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"

لمعرفة أنواع الملفات المسموح بها حاليا بواسطة CDN، استخدم الأمر Cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

لمزيد من المعلومات حول أوامر cmdlets هذه، راجع Set-SPOTenantCdnPolicy و Get-SPOTenantCdnPolicies.

تغيير قائمة تصنيفات المواقع التي تريد استبعادها من Office 365 CDN (اختياري)

تلميح

عند استبعاد تصنيفات المواقع باستخدام الأمر Cmdlet Set-SPOTenantCdnPolicy ، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت ترغب في استبعاد تصنيفات مواقع إضافية، فاستخدم الأمر cmdlet أولا لمعرفة التصنيفات التي تم استبعادها بالفعل ثم إضافتها مع التصنيفات الجديدة.

استخدم الأمر Cmdlet Set-SPOTenantCdnPolicy لاستبعاد تصنيفات المواقع التي لا تريد توفيرها عبر CDN. بشكل افتراضي، لا يتم استبعاد تصنيفات الموقع.

في Windows PowerShell ل SharePoint Online:

Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications  -PolicyValue "<Comma-separated list of site classifications >"

لمعرفة تصنيفات المواقع المقيدة حاليا، استخدم الأمر Cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

الخصائص التي تم إرجاعها هي IncludeFileExtensions و ExcludeRestrictedSiteClassifications و ExcludeIfNoScriptDisabled.

تحتوي الخاصية IncludeFileExtensions على قائمة ملحقات الملفات التي يتم تقديمها من CDN.

ملاحظة

تختلف ملحقات الملفات الافتراضية بين العامة والخاصة.

تحتوي الخاصية ExcludeRestrictedSiteClassifications على تصنيفات الموقع التي تريد استبعادها من CDN. على سبيل المثال، يمكنك استبعاد المواقع التي تم وضع علامة عليها على أنها سرية بحيث لا يتم تقديم المحتوى من المواقع التي تم تطبيق هذا التصنيف عليها من CDN.

تستبعد الخاصية ExcludeIfNoScriptDisabled المحتوى من CDN استنادا إلى إعدادات السمة NoScript على مستوى الموقع. بشكل افتراضي، يتم تعيين السمة NoScript إلى ممكن للمواقع الحديثةومعطلة للمواقع الكلاسيكية . يعتمد هذا على إعدادات المستأجر.

لمزيد من المعلومات حول أوامر cmdlets هذه، راجع Set-SPOTenantCdnPolicy و Get-SPOTenantCdnPolicies.

إضافة أصل لأصولك

استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف أصل. يمكنك تحديد أصول متعددة. الأصل هو عنوان URL يشير إلى مكتبة SharePoint أو مجلد يحتوي على الأصول التي تريد استضافتها بواسطة CDN.

هام

يجب عدم وضع الموارد التي تحتوي على معلومات المستخدم أو التي تعتبر حساسة لمؤسستك في أصل عام.

Add-SPOTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>

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

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • يمكن استخدام معدل حرف البدل */ فقط في بداية المسار، ويطابق جميع مقاطع عنوان URL ضمن عنوان URL المحدد.
  • يمكن أن يشير المسار إلى مكتبة مستندات أو مجلد أو موقع. على سبيل المثال، يتطابق المسار */site1 مع جميع مكتبات المستندات ضمن الموقع.

يمكنك إضافة أصل بمسار نسبي معين. لا يمكنك إضافة أصل باستخدام المسار الكامل.

يضيف هذا المثال أصل خاص لمكتبة siteassets على موقع معين:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

يضيف هذا المثال أصل خاص للمجلد folder1 في مكتبة أصول المواقع المشتركة لمجموعة المواقع المشتركة:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1

إذا كانت هناك مسافة في المسار، يمكنك إما إحاطة المسار بعلامات اقتباس مزدوجة أو استبدال المساحة برمز URL ٪20. تضيف الأمثلة التالية أصلا خاصا للمجلد 1 في مكتبة أصول المواقع المشتركة لمجموعة المواقع المشتركة:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-SPOTenantCdnOrigin.

ملاحظة

في الأصول الخاصة، يجب أن يكون للأصول التي تتم مشاركتها من أصل إصدار رئيسي منشور قبل أن يمكن الوصول إليها من CDN.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل عام للصفحات الرئيسية ومكتبة الأنماط ل SharePoint Online

عادة، يتم إعداد هذه الأصول لك بشكل افتراضي عند تمكين Office 365 CDN. ومع ذلك، إذا كنت تريد تمكينها يدويا، فاتبع هذه الخطوات.

  • استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف مكتبة الأنماط كأصل عام.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف الصفحات الرئيسية كأصل عام.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-SPOTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل خاص لأصول الموقع وصفحات الموقع وصور النشر ل SharePoint Online

  • استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف مجلد أصول الموقع كأصل خاص.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف مجلد صفحات الموقع كأصل خاص.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف مجلد صور النشر كأصل خاص.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-SPOTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل خاص لمجموعة مواقع مشتركة ل SharePoint Online

استخدم Add-SPOTenantCdnOrigin cmdlet لتعريف مجموعة مواقع مشتركة كأصل خاص. على سبيل المثال:

Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-SPOTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد ترى رسالة التكوين المعلقة . هذه الرسالة متوقعة أثناء اتصال مستأجر SharePoint Online بخدمة CDN. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

إدارة شبكة تسليم المحتوى Office 365

بعد إعداد CDN، يمكنك إجراء تغييرات على التكوين أثناء تحديث المحتوى أو مع تغير احتياجاتك، كما هو موضح في هذا القسم.

إضافة أصول أو تحديثها أو إزالتها من Office 365 CDN

بعد إكمال خطوات الإعداد، يمكنك إضافة أصول جديدة وتحديث الأصول الموجودة أو إزالتها متى أردت. ما عليك سوى إجراء التغييرات على الأصول الموجودة في المجلد أو مكتبة SharePoint التي حددتها كأصل. إذا قمت بإضافة أصل جديد، فإنه متاح من خلال CDN على الفور. ومع ذلك، إذا قمت بتحديث الأصل، يستغرق نشر النسخة الجديدة وإتاحتها في CDN ما يصل إلى 15 دقيقة.

إذا كنت بحاجة إلى استرداد موقع الأصل، يمكنك استخدام Cmdlet Get-SPOTenantCdnOrigins . للحصول على معلومات حول كيفية استخدام cmdlet هذا، راجع Get-SPOTenantCdnOrigins.

إزالة أصل من Office 365 CDN

يمكنك إزالة الوصول إلى مجلد أو مكتبة SharePoint التي حددتها كأصل باستخدام الأمر Remove-SPOTenantCdnOrigin cmdlet.

Remove-SPOTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>

للحصول على معلومات حول كيفية استخدام cmdlet هذا، راجع Remove-SPOTenantCdnOrigin.

تعديل أصل في Office 365 CDN

لا يمكنك تعديل أصل بعد إنشائه. بدلا من ذلك، قم بإزالة الأصل ثم إضافة أصل جديد. لمزيد من المعلومات، راجع لإزالة أصل من Office 365 CDNوإضافة أصل لأصولك.

تعطيل Office 365 CDN

استخدم الأمر Cmdlet Set-SPOTenantCdnEnabled لتعطيل CDN لمؤسستك. إذا كان لديك كل من الأصول العامة والخاصة الممكنة ل CDN، فستحتاج إلى تشغيل cmdlet مرتين كما هو موضح في الأمثلة التالية.

لتعطيل استخدام الأصول العامة في CDN، أدخل الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

لتعطيل استخدام الأصول الخاصة في CDN، أدخل الأمر التالي:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

لمزيد من المعلومات حول أمر cmdlet هذا، راجع Set-SPOTenantCdnEnabled.

إعداد وتكوين Office 365 CDN باستخدام PnP PowerShell

تتطلب منك الإجراءات الواردة في هذا القسم استخدام PnP PowerShell للاتصال ب SharePoint Online. للحصول على إرشادات، راجع بدء استخدام PnP PowerShell.

أكمل هذه الخطوات لإعداد وتكوين CDN لاستضافة أصولك في SharePoint Online باستخدام PnP PowerShell.

تحديد للتوسيع

تمكين مؤسستك من استخدام Office 365 CDN

قبل إجراء تغييرات على إعدادات CDN للمستأجر، يجب استرداد الحالة الحالية لتكوين CDN الخاص في مستأجر Office 365. الاتصال بالمستأجر الخاص بك باستخدام PnP PowerShell:

Connect-PnPOnline -Url https://contoso-admin.sharepoint.com -UseWebLogin

استخدم الآن Get-PnPTenantCdnEnabled cmdlet لاسترداد إعدادات حالة CDN من المستأجر:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

تظهر حالة CDN ل CdnType المحدد على الشاشة.

استخدم الأمر cmdlet Set-PnPTenantCdnEnabled لتمكين مؤسستك من استخدام Office 365 CDN. يمكنك تمكين مؤسستك من استخدام الأصول العامة أو الأصول الخاصة أو كليهما في نفس الوقت. يمكنك أيضا تكوين CDN لتخطي إعداد الأصول الافتراضية عند تمكينها. يمكنك دائما إضافة هذه الأصول لاحقا كما هو موضح في هذه المقالة.

في PnP PowerShell:

Set-PnPTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true

على سبيل المثال، لتمكين مؤسستك من استخدام الأصول العامة والخاصة، اكتب الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

لتمكين مؤسستك من استخدام الأصول العامة والخاصة ولكن تخطي إعداد الأصول الافتراضية، اكتب الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins

راجع أصول CDN الافتراضية للحصول على معلومات حول الأصول التي يتم توفيرها بشكل افتراضي عند تمكين Office 365 CDN، والتأثير المحتمل لتخطي إعداد الأصول الافتراضية.

لتمكين مؤسستك من استخدام الأصول العامة، اكتب الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

لتمكين مؤسستك من استخدام الأصول الخاصة، اكتب الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

لمزيد من المعلومات حول cmdlet هذا، راجع Set-PnPTenantCdnEnabled.

تغيير قائمة أنواع الملفات لتضمينها في Office 365 CDN (اختياري)

تلميح

عند تعريف أنواع الملفات باستخدام الأمر Cmdlet Set-PnPTenantCdnPolicy ، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت تريد إضافة أنواع ملفات إضافية إلى القائمة، فاستخدم cmdlet أولا لمعرفة أنواع الملفات المسموح بها بالفعل وتضمينها في القائمة مع أنواع الملفات الجديدة.

استخدم الأمر Cmdlet Set-PnPTenantCdnPolicy لتعريف أنواع الملفات الثابتة التي يمكن استضافتها بواسطة الأصول العامة والخاصة في CDN. بشكل افتراضي، يسمح بأنواع الأصول الشائعة، على سبيل المثال .css .gif .jpg .js.

في PnP PowerShell:

Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"

على سبيل المثال، لتمكين CDN من استضافة ملفات .css وملفات .png، يمكنك إدخال الأمر :

Set-PnPTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"

لمعرفة أنواع الملفات المسموح بها حاليا بواسطة CDN، استخدم Cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

لمزيد من المعلومات حول أوامر cmdlets هذه، راجع Set-PnPTenantCdnPolicy و Get-PnPTenantCdnPolicies.

تغيير قائمة تصنيفات المواقع التي تريد استبعادها من Office 365 CDN (اختياري)

تلميح

عند استبعاد تصنيفات المواقع باستخدام الأمر Cmdlet Set-PnPTenantCdnPolicy ، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت ترغب في استبعاد تصنيفات مواقع إضافية، فاستخدم الأمر cmdlet أولا لمعرفة التصنيفات التي تم استبعادها بالفعل ثم إضافتها مع التصنيفات الجديدة.

استخدم الأمر Cmdlet Set-PnPTenantCdnPolicy لاستبعاد تصنيفات المواقع التي لا تريد توفيرها عبر CDN. بشكل افتراضي، لا يتم استبعاد تصنيفات الموقع.

في PnP PowerShell:

Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications  -PolicyValue "<Comma-separated list of site classifications>"

لمعرفة تصنيفات المواقع المقيدة حاليا، استخدم الأمر Cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

الخصائص التي تم إرجاعها هي IncludeFileExtensions و ExcludeRestrictedSiteClassifications و ExcludeIfNoScriptDisabled.

تحتوي الخاصية IncludeFileExtensions على قائمة ملحقات الملفات التي يتم تقديمها من CDN.

ملاحظة

تختلف ملحقات الملفات الافتراضية بين العامة والخاصة.

تحتوي الخاصية ExcludeRestrictedSiteClassifications على تصنيفات الموقع التي تريد استبعادها من CDN. على سبيل المثال، يمكنك استبعاد المواقع التي تم وضع علامة عليها على أنها سرية بحيث لا يتم تقديم المحتوى من المواقع التي تم تطبيق هذا التصنيف عليها من CDN.

تستبعد الخاصية ExcludeIfNoScriptDisabled المحتوى من CDN استنادا إلى إعدادات السمة NoScript على مستوى الموقع. بشكل افتراضي، يتم تعيين السمة NoScript إلى ممكن للمواقع الحديثةومعطلة للمواقع الكلاسيكية . يعتمد هذا على إعدادات المستأجر.

لمزيد من المعلومات حول أوامر cmdlets هذه، راجع Set-PnPTenantCdnPolicy و Get-PnPTenantCdnPolicies.

إضافة أصل لأصولك

استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف أصل. يمكنك تحديد أصول متعددة. الأصل هو عنوان URL يشير إلى مكتبة SharePoint أو مجلد يحتوي على الأصول التي تريد استضافتها بواسطة CDN.

هام

يجب عدم وضع الموارد التي تحتوي على معلومات المستخدم أو التي تعتبر حساسة لمؤسستك في أصل عام.

Add-PnPTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>

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

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • يمكن استخدام معدل حرف البدل */ فقط في بداية المسار، ويطابق جميع مقاطع عنوان URL ضمن عنوان URL المحدد.
  • يمكن أن يشير المسار إلى مكتبة مستندات أو مجلد أو موقع. على سبيل المثال، يتطابق المسار */site1 مع جميع مكتبات المستندات ضمن الموقع.

يمكنك إضافة أصل بمسار نسبي معين. لا يمكنك إضافة أصل باستخدام المسار الكامل.

يضيف هذا المثال أصل خاص لمكتبة أصول الموقع على موقع معين:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

يضيف هذا المثال أصل خاص للمجلد folder1 في مكتبة أصول المواقع المشتركة لمجموعة المواقع المشتركة:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1

إذا كانت هناك مسافة في المسار، يمكنك إما إحاطة المسار بعلامات اقتباس مزدوجة أو استبدال المساحة برمز URL ٪20. تضيف الأمثلة التالية أصلا خاصا للمجلد 1 في مكتبة أصول المواقع المشتركة لمجموعة المواقع المشتركة:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-PnPTenantCdnOrigin.

ملاحظة

في الأصول الخاصة، يجب أن يكون للأصول المشتركة من الأصل إصدار رئيسي منشور قبل الوصول إليها من CDN.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل عام للصفحات الرئيسية ومكتبة الأنماط ل SharePoint Online

عادة، يتم إعداد هذه الأصول لك بشكل افتراضي عند تمكين Office 365 CDN. ومع ذلك، إذا كنت تريد تمكينها يدويا، فاتبع هذه الخطوات.

  • استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف مكتبة الأنماط كأصل عام.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف الصفحات الرئيسية كأصل عام.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-PnPTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل خاص لأصول الموقع وصفحات الموقع وصور النشر ل SharePoint Online

  • استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف مجلد أصول الموقع كأصل خاص.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف مجلد صفحات الموقع كأصل خاص.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف مجلد نشر الصور كأصل خاص.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-PnPTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

مثال: تكوين أصل خاص لمجموعة مواقع مشتركة ل SharePoint Online

استخدم Add-PnPTenantCdnOrigin cmdlet لتعريف مجموعة مواقع مشتركة كأصل خاص. على سبيل المثال:

Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets

لمزيد من المعلومات حول هذا الأمر وبناء الجملة الخاص به، راجع Add-PnPTenantCdnOrigin.

بعد تشغيل الأمر، يقوم النظام بمزامنة التكوين عبر مركز البيانات. قد ترى رسالة التكوين المعلقة . هذه النتيجة متوقعة مع اتصال مستأجر SharePoint Online بخدمة CDN. قد تستغرق هذه النتيجة ما يصل إلى 15 دقيقة.

إدارة شبكة تسليم المحتوى Office 365

بعد إعداد CDN، يمكنك إجراء تغييرات على التكوين أثناء تحديث المحتوى أو مع تغير احتياجاتك، كما هو موضح في هذا القسم.

إضافة أصول أو تحديثها أو إزالتها من Office 365 CDN

بعد إكمال خطوات الإعداد، يمكنك إضافة أصول جديدة وتحديث الأصول الموجودة أو إزالتها متى أردت. ما عليك سوى إجراء التغييرات على الأصول الموجودة في المجلد أو مكتبة SharePoint التي حددتها كأصل. إذا قمت بإضافة أصل جديد، فإنه متاح من خلال CDN على الفور. ومع ذلك، إذا قمت بتحديث الأصل، يستغرق نشر النسخة الجديدة وإتاحتها في CDN ما يصل إلى 15 دقيقة.

إذا كنت بحاجة إلى استرداد موقع الأصل، يمكنك استخدام Cmdlet Get-PnPTenantCdnOrigin . للحصول على معلومات حول كيفية استخدام cmdlet هذا، راجع Get-PnPTenantCdnOrigin.

إزالة أصل من Office 365 CDN

يمكنك إزالة الوصول إلى مجلد أو مكتبة SharePoint التي حددتها كأصل. لاتخاذ هذا الإجراء، استخدم الأمر Remove-PnPTenantCdnOrigin cmdlet.

Remove-PnPTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>

للحصول على معلومات حول كيفية استخدام cmdlet هذا، راجع Remove-PnPTenantCdnOrigin.

تعديل أصل في Office 365 CDN

لا يمكنك تعديل أصل بعد إنشائه. بدلا من ذلك، قم بإزالة الأصل ثم إضافة أصل جديد. لمزيد من المعلومات، راجع لإزالة أصل من Office 365 CDNوإضافة أصل لأصولك.

تعطيل Office 365 CDN

استخدم الأمر Cmdlet Set-PnPTenantCdnEnabled لتعطيل CDN لمؤسستك. إذا كان لديك كل من الأصول العامة والخاصة الممكنة ل CDN، فستحتاج إلى تشغيل cmdlet مرتين كما هو موضح في الأمثلة التالية.

لتعطيل استخدام الأصول العامة في CDN، أدخل الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

لتعطيل استخدام الأصول الخاصة في CDN، أدخل الأمر التالي:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

لمزيد من المعلومات حول cmdlet هذا، راجع Set-PnPTenantCdnEnabled.

إعداد وتكوين Office 365 CDN باستخدام CLI ل Microsoft 365

تتطلب الإجراءات الواردة في هذا القسم CLI ل Microsoft 365. اتصل بمستأجر Office 365 باستخدام أمر تسجيل الدخول.

أكمل هذه الخطوات لإعداد شبكة تسليم المحتوى وتكوينها لاستضافة أصولك في SharePoint Online باستخدام CLI ل Microsoft 365.

تحديد للتوسيع

تمكين Office 365 CDN

يمكنك إدارة حالة Office 365 CDN في المستأجر الخاص بك باستخدام الأمر spo cdn set.

لتمكين Office 365 Public CDN في المستأجر الخاص بك، قم بتشغيل الأمر التالي:

m365 spo cdn set --type Public --enabled true

لتمكين Office 365 SharePoint CDN، قم بتشغيل الأمر التالي:

m365 spo cdn set --type Private --enabled true

عرض الحالة الحالية Office 365 CDN

للتحقق مما إذا كان نوع معين من Office 365 CDN ممكنا أو معطلا، استخدم الأمر spo cdn get.

للتحقق مما إذا كان Office 365 Public CDN ممكنا، قم بتشغيل الأمر التالي:

m365 spo cdn get --type Public

عرض أصول Office 365 CDN

لعرض أصول شبكة تسليم المحتوى العامة التي تم تكوينها حاليا Office 365، قم بتشغيل الأمر التالي:

m365 spo cdn origin list --type Public

راجع أصول CDN الافتراضية للحصول على معلومات حول الأصول التي يتم توفيرها بشكل افتراضي عند تمكين Office 365 CDN.

إضافة أصل Office 365 CDN

هام

يجب ألا تضع أبدا الموارد التي تعتبر حساسة لمؤسستك في مكتبة مستندات SharePoint تم تكوينها كأصل عام.

استخدم الأمر spo cdn origin add لتعريف أصل CDN. يمكنك تحديد أصول متعددة. الأصل هو عنوان URL يشير إلى مكتبة أو مجلد SharePoint يحتوي على الأصول التي تريد أن تستضيفها شبكة تسليم المحتوى.

m365 spo cdn origin add --type [Public | Private] --origin <path>

أين path هو المسار النسبي إلى المجلد الذي يحتوي على الأصول. يمكنك استخدام أحرف البدل بالإضافة إلى المسارات النسبية.

لتضمين كافة الأصول في معرض الصفحات الرئيسية لجميع المواقع كأصل عام، قم بتشغيل الأمر التالي:

m365 spo cdn origin add --type Public --origin */masterpage

لتكوين أصل خاص لمجموعة مواقع مشتركة معينة، قم بتشغيل الأمر التالي:

m365 spo cdn origin add --type Private --origin sites/site1/siteassets

ملاحظة

بعد إضافة أصل CDN، قد يستغرق الأمر ما يصل إلى 15 دقيقة لتتمكن من استرداد الملفات عبر خدمة CDN. يمكنك التحقق مما إذا كان الأصل المعين قد تم تمكينه بالفعل باستخدام الأمر spo cdn origin list .

إزالة أصل Office 365 CDN

استخدم الأمر spo cdn origin remove لإزالة أصل CDN لنوع CDN المحدد.

لإزالة أصل عام من تكوين CDN، قم بتشغيل الأمر التالي:

m365 spo cdn origin remove --type Public --origin */masterpage

ملاحظة

لا تؤثر إزالة أصل CDN على الملفات المخزنة في أي مكتبة مستندات تطابق الأصل. إذا تم الرجوع إلى هذه الأصول باستخدام عنوان URL ل SharePoint الخاص بها، فيتحول SharePoint تلقائيا إلى عنوان URL الأصلي الذي يشير إلى مكتبة المستندات. إذا تمت الإشارة إلى الأصول باستخدام عنوان URL عام ل CDN، فإن إزالة الأصل تؤدي إلى قطع الارتباط، وتحتاج إلى تغييرها يدويا.

تعديل أصل Office 365 CDN

لا يمكن تعديل أصل CDN موجود. بدلا من ذلك، يجب إزالة أصل CDN المحدد مسبقا باستخدام spo cdn origin remove الأمر وإضافة أصل جديد باستخدام spo cdn origin add الأمر .

تغيير أنواع الملفات لتضمينها في Office 365 CDN

بشكل افتراضي، يتم تضمين أنواع الملفات التالية في CDN: .cssو .gif.eotو .icoو..woff2.jpeg.jpg.js.map.png.svg.ttf.woff إذا كنت بحاجة إلى تضمين أنواع ملفات إضافية في CDN، يمكنك تغيير تكوين CDN باستخدام الأمر spo cdn policy set .

ملاحظة

عند تغيير قائمة أنواع الملفات، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت تريد تضمين أنواع ملفات إضافية، فاستخدم أولا أمر قائمة نهج spo cdn لمعرفة أنواع الملفات التي تم تكوينها حاليا.

لإضافة نوع ملف JSON إلى القائمة الافتراضية أنواع الملفات المضمنة في CDN العام، قم بتشغيل الأمر التالي:

m365 spo cdn policy set --type Public --policy IncludeFileExtensions --value "CSS,EOT,GIF,ICO,JPEG,JPG,JS,MAP,PNG,SVG,TTF,WOFF,JSON"

تغيير قائمة تصنيفات المواقع التي تريد استبعادها من Office 365 CDN

استخدم الأمر spo cdn policy set لاستبعاد تصنيفات المواقع التي لا تريد توفيرها عبر CDN. بشكل افتراضي، لا يتم استبعاد تصنيفات الموقع.

ملاحظة

عند تغيير قائمة تصنيفات المواقع المستبعدة، يمكنك الكتابة فوق القائمة المعرفة حاليا. إذا كنت ترغب في استبعاد تصنيفات إضافية، فاستخدم أولا أمر قائمة نهج spo cdn لمعرفة التصنيفات التي تم تكوينها حاليا.

لاستبعاد المواقع المصنفة على أنها HBI من CDN العام، قم بتشغيل الأمر التالي:

m365 spo cdn policy set --type Public --policy ExcludeRestrictedSiteClassifications --value "HBI"

تعطيل Office 365 CDN

لتعطيل Office 365 CDN، استخدم spo cdn set الأمر، على سبيل المثال:

m365 spo cdn set --type Public --enabled false

استخدام أصول CDN الخاصة بك

الآن بعد أن قمت بتمكين CDN والأصول والنهج المكونة، يمكنك البدء في استخدام أصول CDN الخاصة بك.

يساعدك هذا القسم على فهم كيفية استخدام عناوين URL ل CDN في صفحات SharePoint والمحتوى بحيث يعيد SharePoint توجيه طلبات الأصول في كل من الأصول العامة والخاصة إلى CDN.

للحصول على معلومات حول كيفية استخدام CDN لاستضافة أجزاء ويب من جانب العميل، راجع المقالة استضافة جزء ويب من جانب العميل من Office 365 CDN (مرحبًا بالعالم الجزء 4).

ملاحظة

إذا أضفت مجلد ClientSideAssets إلى قائمة أصول CDN الخاصة ، فسيفشل عرض أجزاء ويب المخصصة المستضافة على CDN. يمكن للملفات المستخدمة من قبل أجزاء ويب SPFX استخدام CDN العام فقط ومجلد ClientSideAssets هو أصل افتراضي ل CDN العام.

لاستخدام الأصول التي أضفتها إلى أصل، ما عليك سوى تحديث الارتباطات إلى الملف الأصلي مع المسار إلى الملف في الأصل.

  • قم بتحرير الصفحة أو المحتوى الذي يحتوي على ارتباطات إلى الأصول التي أضفتها إلى أصل. يمكنك أيضا استخدام إحدى الطرق المتعددة للبحث عن الارتباطات واستبدالها عالميا عبر موقع إدخال أو مجموعة مواقع مشتركة إذا كنت تريد تحديث الارتباط إلى أصل معين في كل مكان يظهر فيه.
  • لكل ارتباط إلى أصل في أصل، استبدل المسار بالمسار إلى الملف في أصل CDN. يمكنك استخدام المسارات النسبية.
  • احفظ الصفحة أو المحتوى.

على سبيل المثال، ضع في اعتبارك الصورة /site/SiteAssets/images/image.png، التي نسختها إلى مجلد مكتبة المستندات /site/CDN_origins/public/. لاستخدام أصل CDN، استبدل المسار الأصلي بموقع ملف الصورة بالمسار إلى الأصل لجعل عنوان URL الجديد /site/CDN_origins/public/image.png.

إذا كنت تريد استخدام عنوان URL الكامل للأصل بدلا من مسار نسبي، فنشئ الارتباط على النحو التالي:

https://<TenantHostName>.sharepoint.com/sites/site/CDN_origins/public/image.png

ملاحظة

بشكل عام، يجب عدم تشفير عناوين URL مباشرة إلى الأصول في CDN. ومع ذلك، يمكنك إنشاء عناوين URL يدويا للأصول في الأصول العامة إذا لزم الأمر. لمزيد من المعلومات، راجع عناوين URL ل CDN للترميز الثابت للأصول العامة.

للتعرف على كيفية التحقق من أن الأصول يتم تقديمها من شبكة تسليم المحتوى، راجع كيف أعمل التأكد من أن الأصول يتم تقديمها بواسطة CDN؟ في استكشاف أخطاء شبكة تسليم المحتوى Office 365 وإصلاحها.

استخدام الأصول في الأصول العامة

تعيد ميزة النشر في SharePoint Online تلقائيا كتابة عناوين URL للأصول المخزنة في الأصول العامة إلى مكافئات CDN الخاصة بها بحيث يتم تقديم الأصول من خدمة CDN بدلا من SharePoint.

إذا كان أصلك في موقع مع تمكين ميزة النشر، وكانت الأصول التي تريد إلغاء تحميلها إلى CDN في إحدى الفئات التالية، يعيد SharePoint تلقائيا كتابة عناوين URL للأصول في الأصل، إذا لم يتم استبعاد الأصل بواسطة نهج CDN.

المثال التالي هو نظرة عامة حيث تتم إعادة كتابة الارتباطات تلقائيا بواسطة ميزة نشر SharePoint:

  • عناوين URL ل IMG/LINK/CSS في استجابات HTML لصفحة النشر الكلاسيكية.
    • يتضمن ذلك الصور التي أضافها الكتاب ضمن محتوى HTML للصفحة.
  • عناوين URL لصورة جزء ويب لمكتبة الصور.
  • حقول الصور في نتائج SPList REST API (RenderListDataAsStream).
    • استخدم الخاصية الجديدة ImageFieldsToTryRewriteToCdnUrls لتوفير قائمة مفصولة بفواصل من الحقول.
    • يدعم حقول الارتباط التشعبي وحقول PublishingImage.
  • تسليمات صور SharePoint.

يوضح الرسم التخطيطي التالي سير العمل عندما يتلقى SharePoint طلبا لصفحة تحتوي على أصول من أصل عام.

رسم تخطيطي لسير العمل: استرداد أصول CDN Office 365 من أصل عام.

تلميح

إذا كنت ترغب في تعطيل إعادة الكتابة التلقائية لعناوين URL معينة على صفحة، يمكنك سحب الصفحة وإضافة معلمة سلسلة الاستعلام ؟ NoAutoReWrites=true إلى نهاية كل ارتباط تريد تعطيله.

إنشاء عناوين URL ل CDN للأصول العامة

إذا لم يتم تمكين ميزة النشر لأصل عام، أو لم يكن الأصل أحد أنواع الارتباطات التي تدعمها ميزة إعادة الكتابة التلقائية لخدمة CDN، يمكنك إنشاء عناوين URL يدويا إلى موقع CDN للأصول واستخدام عناوين URL هذه في المحتوى الخاص بك.

ملاحظة

لا يمكنك ترميز عناوين URL ل CDN أو إنشائها إلى الأصول في أصل خاص لأنه يتم إنشاء رمز الوصول المطلوب الذي يشكل القسم الأخير من عنوان URL في وقت طلب المورد. يمكنك إنشاء عنوان URL ل PUBLIC CDN ويجب ألا يكون عنوان URL مشفرا لأنه عرضة للتغيير.

بالنسبة لأصول CDN العامة، يبدو تنسيق عنوان URL مثل المثال التالي:

https://publiccdn.sharepointonline.com/<TenantHostName>/sites/site/library/asset.png

استبدل TenantHostName باسم المستأجر الخاص بك. على سبيل المثال:

https://publiccdn.sharepointonline.com/contoso.sharepoint.com/sites/site/library/asset.png

ملاحظة

استخدم خاصية سياق الصفحة لإنشاء البادئة بدلا من الترميز https://publiccdn.sharepointonline.comالثابت ، لأن عنوان URL عرضة للتغيير. إذا كنت تستخدم قوالب العرض مع SharePoint Online الكلاسيكي، يمكنك استخدام الخاصية window._spPageContextInfo.publicCdnBaseUrl في قالب العرض الخاص بك لبادئة عنوان URL. إذا كنت تستخدم أجزاء ويب SPFx ل SharePoint الحديث والكلاسيكي، يمكنك استخدام الخاصية this.context.pageContext.legacyPageContext.publicCdnBaseUrl، والتي توفر أيضا البادئة. إذا تغيرت البادئة، يتم تحديث التنفيذ معها.

كمثال على SPFx، يمكنك إنشاء عنوان URL باستخدام الخاصية this.context.pageContext.legacyPageContext.publicCdnBaseUrlhost - //relativeURL for the item - - - . لمزيد من المعلومات، راجع الفيديو باستخدام CDN في التعليمات البرمجية من جانب العميل، وهو جزء من سلسلة الأداء الموسم 1.

استخدام الأصول في الأصول الخاصة

لا يلزم تكوين إضافي لاستخدام الأصول في الأصول الخاصة. يعيد SharePoint Online كتابة عناوين URL تلقائيا للأصول في الأصول الخاصة بحيث يتم دائما تقديم طلبات هذه الأصول من CDN. لا يمكنك إنشاء عناوين URL يدويا لأصول CDN في الأصول الخاصة لأن عناوين URL هذه تحتوي على رموز مميزة يجب إنشاؤها تلقائيا بواسطة SharePoint Online في وقت طلب الأصل.

يتم حماية الوصول إلى الأصول في الأصول الخاصة من خلال الرموز المميزة التي تم إنشاؤها ديناميكيا استنادا إلى أذونات المستخدم للأصل، مع التحذيرات الموضحة في الأقسام التالية. يجب أن يكون لدى المستخدمين حق الوصول للقراءة على الأقل إلى أصول CDN لعرض المحتوى.

يوضح الرسم التخطيطي التالي سير العمل عندما يتلقى SharePoint طلبا لصفحة تحتوي على أصول من أصل خاص.

رسم تخطيطي لسير العمل: استرداد أصول CDN Office 365 من أصل خاص.

التخويل المستند إلى الرمز المميز في الأصول الخاصة

يتم منح الوصول إلى الأصول في الأصول الخاصة في Office 365 CDN بواسطة الرموز المميزة التي تم إنشاؤها بواسطة SharePoint Online. يتم منح المستخدمين الذين لديهم إذن بالفعل للوصول إلى المجلد أو المكتبة المعينة بواسطة الأصل تلقائيا الرموز المميزة التي تسمح للمستخدم بالوصول إلى الملف استنادا إلى مستوى الأذونات الخاص بهم. هذه الرموز المميزة للوصول صالحة لمدة 30 إلى 90 دقيقة بعد إنشائها للمساعدة في منع هجمات إعادة تشغيل الرمز المميز.

بمجرد إنشاء الرمز المميز للوصول، يقوم SharePoint Online بإرجاع URI مخصص للعميل يحتوي على معلمتي تخويل تأكلان (رمز تخويل الحافة) و oat (رمز تخويل الأصل). بنية كل رمز مميز هي <"وقت انتهاء الصلاحية بتنسيق وقت Epoch">__<"توقيع آمن".> على سبيل المثال:

https://privatecdn.sharepointonline.com/contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg?eat=1486154359_cc59042c5c55c90b26a2775323c7c8112718431228fe84d568a3795a63912840&oat=1486154359_7d73c2e3ba4b7b1f97242332900616db0d4ffb04312

ملاحظة

يمكن لأي شخص يمتلك الرمز المميز الوصول إلى المورد في CDN. ومع ذلك، تتم مشاركة عناوين URL التي تحتوي على رموز الوصول المميزة هذه فقط عبر HTTPS، لذلك ما لم تتم مشاركة عنوان URL بشكل صريح من قبل المستخدم النهائي قبل انتهاء صلاحية الرمز المميز، فلن يمكن للمستخدمين غير المصرح لهم الوصول إلى الأصل.

الأذونات على مستوى العنصر غير مدعومة للأصول في الأصول الخاصة

من المهم ملاحظة أن SharePoint Online لا يدعم الأذونات على مستوى العنصر للأصول في الأصول الخاصة. على سبيل المثال، بالنسبة لملف موجود في https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg، يمكن للمستخدمين الوصول الفعال إلى الملف نظرا للشروط التالية:

User الأذونات الوصول الفعال
المستخدم 1 لديه حق الوصول إلى folder1 يمكنه الوصول إلى image1.jpg من CDN
المستخدم 2 ليس لديه حق الوصول إلى folder1 لا يمكن الوصول إلى image1.jpg من CDN
المستخدم 3 ليس لديه حق الوصول إلى folder1، ولكن يتم منحه إذنا صريحا للوصول إلى image1.jpg في SharePoint Online يمكنه الوصول إلى image1.jpg الأصل مباشرة من SharePoint Online، ولكن ليس من CDN
المستخدم 4 لديه حق الوصول إلى folder1، ولكن تم رفض الوصول صراحة إلى image1.jpg في SharePoint Online لا يمكن الوصول إلى الأصل من SharePoint Online، ولكن يمكنه الوصول إلى الأصل من شبكة تسليم المحتوى على الرغم من رفض الوصول إلى الملف في SharePoint Online

استكشاف أخطاء شبكة تسليم المحتوى Office 365 وإصلاحها

كيف أعمل تأكيد أن الأصول تخدمها شبكة تسليم المحتوى؟

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

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

ملاحظة

إذا كنت تستخدم أداة شبكة مثل Fiddler لاختبار أصولك خارج عرض الأصل من صفحة SharePoint، فيجب عليك إضافة رأس المرجع "المرجع: https://yourdomain.sharepoint.com" يدويا إلى طلب GET حيث يكون عنوان URL هو عنوان URL الجذر لمستأجر SharePoint Online.

لا يمكنك اختبار عناوين URL ل CDN مباشرة في مستعرض ويب لأنه يجب أن يكون لديك محيل قادم من SharePoint Online. ومع ذلك، إذا أضفت عنوان URL لأصل CDN إلى صفحة SharePoint ثم فتحت الصفحة في مستعرض، فسيتم عرض أصل CDN على الصفحة.

لمزيد من المعلومات حول استخدام أدوات المطور في مستعرض Microsoft Edge، راجع أدوات مطور Microsoft Edge.

لمشاهدة فيديو قصير مستضاف في قناة SharePoint Developer Patterns and Practices YouTube التي توضح كيفية التحقق من عمل CDN، راجع التحقق من استخدام CDN وضمان الاتصال الأمثل بالشبكة.

لماذا الأصول من أصل جديد غير متوفرة؟

لن تكون الأصول في الأصول الجديدة متاحة للاستخدام على الفور، حيث يستغرق التسجيل وقتا للنشر عبر CDN وللاصول التي سيتم تحميلها من الأصل إلى تخزين CDN. يعتمد الوقت المطلوب لتوفير الأصول في شبكة تسليم المحتوى على عدد الأصول وأحجام الملفات.

لا يعمل جزء الويب الخاص بي من جانب العميل أو حل إطار عمل SharePoint

عند تمكين Office 365 CDN للأصول العامة، تقوم خدمة CDN تلقائيا بإنشاء هذه الأصول الافتراضية:

  • */MASTERPAGE
  • */مكتبة الأنماط
  • */CLIENTSIDEASSETS

إذا كان أصل */clientsideassets مفقودا، إطار عمل SharePoint تفشل الحلول، ولا يتم إنشاء رسائل تحذير أو خطأ. قد يكون هذا الأصل مفقودا إما لأنه تم تمكين CDN مع تعيين المعلمة -NoDefaultOrigins إلى $true، أو لأنه تم حذف الأصل يدويا.

يمكنك التحقق لمعرفة الأصول الموجودة باستخدام أمر PowerShell التالي:

Get-SPOTenantCdnOrigins -CdnType Public

أو يمكنك التحقق من CLI ل Microsoft 365:

m365 spo cdn origin list

لإضافة الأصل في PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

لإضافة الأصل باستخدام CLI ل Microsoft 365:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

ما هي وحدات PowerShell النمطية وقذائف CLI التي أحتاجها للعمل مع Office 365 CDN؟

يمكنك اختيار العمل مع Office 365 CDN باستخدام الوحدة النمطية SharePoint Online Management Shell PowerShell أو CLI ل Microsoft 365.

راجع أيضًا

شبكات تسليم المحتوى

تخطيط الشبكة وضبط الأداء Office 365

سلسلة أداء SharePoint - سلسلة فيديو Office 365 CDN