Использование сети доставки содержимого Office 365 с SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online

Вы можете использовать встроенную сеть доставки содержимого (CDN) Office 365 для размещения статических ресурсов, чтобы повысить производительность страниц SharePoint Online.You can use the built-in Office 365 Content Delivery Network (CDN) to host static assets to provide better performance for your SharePoint Online pages. Сеть CDN Office 365 повышает производительность путем кэширования статических ресурсов ближе к браузерам, которые их запрашивают, что повышает скорость скачиваний и снижает задержку.The Office 365 CDN improves performance by caching static assets closer to the browsers requesting them, which helps to speed up downloads and reduce latency. Кроме того, CDN Office 365 использует протокол HTTP/2 для улучшения сжатия и http pipelining.Also, the Office 365 CDN uses the HTTP/2 protocol for improved compression and HTTP pipelining. Служба CDN Office 365 входит в состав подписки на SharePoint Online.The Office 365 CDN service is included as part of your SharePoint Online subscription.

Примечание

CdN Office 365 доступен только для клиентов в облаке Production (по всему миру).The Office 365 CDN is only available to tenants in the Production (worldwide) cloud. Клиенты в облаках правительства США, Китая и Германии в настоящее время не поддерживают CDN Office 365.Tenants in the US Government, China and Germany clouds do not currently support the Office 365 CDN.

Сети доставки содержимого Office 365 состоит из нескольких сетей CDN, позволяющих размещать статические ресурсы в нескольких расположениях или источниках и использовать их из глобальных высокоскоростных сетей.The Office 365 CDN is composed of multiple CDNs that allow you to host static assets in multiple locations, or origins, and serve them from global high-speed networks. В зависимости от типа содержимого, которое необходимо разместить в сети CDN Office 365, можно добавить общедоступные источники, закрытые источники или оба варианта.Depending on the kind of content you want to host in the Office 365 CDN, you can add public origins, private origins or both. Дополнительные сведения о различиях между государственными и частными происхождениями см. в дополнительных сведениях о том, должно ли каждое происхождение быть общедоступным или частным.See Choose whether each origin should be public or private for more information on the difference between public and private origins.

Концептуальная схема CDN Office 365Office 365 CDN conceptual diagram

Если вы уже знакомы с тем, как работают cdNs, необходимо выполнить только несколько действий, чтобы включить CDN Office 365 для клиента.If you are already familiar with the way that CDNs work, you only need to complete a few steps to enable the Office 365 CDN for your tenant. В этом разделе описывается, как.This topic describes how. Ознакомьтесь с информацией о том, как начать размещение статических активов.Read on for information about how to get started hosting your static assets.

Совет

Существуют другие cdNs, которые можно использовать с Office 365 для специализированных сценариев использования, но не обсуждаются в этой теме, так как они не находятся за рамками CDN Office 365.There are other Microsoft-hosted CDNs that can be used with Office 365 for specialized usage scenarios, but are not discussed in this topic because they fall outside the scope of the Office 365 CDN. Дополнительные сведения см. в других cdNs Microsoft.For more information, see Other Microsoft CDNs.

Возвращайся к планированию сети и настройке производительности для Office 365.Head back to Network planning and performance tuning for Office 365.

Обзор работы с CDN Office 365 в SharePoint OnlineOverview of working with the Office 365 CDN in SharePoint Online

Чтобы настроить CDN Office 365 для организации, выполните следующие основные действия:To set up the Office 365 CDN for your organization, you follow these basic steps:

После установки можно управлять CDN Office 365 с течением времени:Once you're done with setup, you can Manage the Office 365 CDN over time by:

  • Добавление, обновление и удаление активовAdding, updating, and removing assets
  • Добавление и удаление истоковAdding and removing origins
  • Настройка политик CDNConfiguring CDN policies
  • При необходимости отключение CDNIf necessary, disabling the CDN

Наконец, см. в выпуске Использование ресурсов CDN, чтобы узнать о доступе к вашим cdN-активам как из государственного, так и из частного происхождения.Finally, see Using your CDN assets to learn about accessing your CDN assets from both public and private origins.

Инструкции по решению распространенных проблем см. в инструкции по устранению неполадок cdN Office 365.See Troubleshooting the Office 365 CDN for guidance on resolving common issues.

Планирование развертывания CDN Office 365Plan for deployment of the Office 365 CDN

Перед развертыванием CDN Office 365 для клиента Office 365 необходимо учитывать следующие факторы в процессе планирования.Before you deploy the Office 365 CDN for your Office 365 tenant, you should consider the following factors as part of your planning process.

Определение статических активов, которые необходимо установить в CDNDetermine which static assets you want to host on the CDN

В общем, CDNs наиболее эффективны для размещения статических активов или активов, которые не очень часто изменяются.In general, CDNs are most effective for hosting static assets, or assets that don't change very often. Хорошим правилом является определение файлов, которые соответствуют некоторым или всем этим условиям:A good rule of thumb is to identify files that meet some or all of these conditions:

  • Статические файлы, встроенные в страницу (например, сценарии и изображения), которые могут иметь существенное инкрементное влияние на время загрузки страницы.Static files embedded in a page (like scripts and images) that may have a significant incremental impact on page load times
  • Большие файлы, такие как исполняемые и файлы установкиLarge files like executables and installation files
  • Библиотеки ресурсов, поддерживают клиентский кодResource libraries that support client-side code

Например, небольшие файлы, которые неоднократно запрашиваются, например изображения сайтов и сценарии, могут значительно повысить производительность отрисовки сайтов и постепенно снизить нагрузку на сайты SharePoint Online при добавлении их в cdN-источник.For example, small files that are repeatedly requested like site images and scripts can significantly improve site rendering performance and incrementally reduce the load on your SharePoint Online sites when you add them to a CDN origin. Более крупные файлы, такие как исполняемые установки, могут быть скачаны из CDN, что положительно сказывается на производительности и последующем снижении нагрузки на сайте SharePoint Online, даже если к ним не доступны так часто.Larger files such as installation executables can be downloaded from the CDN, delivering a positive performance impact and subsequent reduction of the load on your SharePoint Online site, even if they are not accessed as often.

Улучшение производительности на основе каждого файла зависит от многих факторов, включая близость клиента к ближайшей конечной точке CDN, временные условия в локальной сети и т. д.Performance improvement on a per-file basis is dependent on many factors, including the client's proximity to the nearest CDN endpoint, transient conditions on the local network, and so forth. Многие статические файлы довольно малы и могут быть загружены из Office 365 менее чем за секунду.Many static files are quite small, and can be downloaded from Office 365 in less than a second. Однако веб-страница может содержать множество встроенных файлов совокупным временем загрузки в несколько секунд.However, a web page may contain many embedded files with a cumulative download time of several seconds. Обслуживание этих файлов из CDN может значительно сократить общее время загрузки страницы.Serving these files from the CDN can significantly reduce the overall page load time. Узнайте, какие результаты обеспечивает CDN? в примере.See What performance gains does a CDN provide? for an example.

Определите, где нужно хранить свои активыDetermine where you want to store your assets

CDN извлекает ваши активы из расположения, называемого происхождением.The CDN fetches your assets from a location called an origin. Происхождение может быть веб-сайтОм SharePoint, библиотекой документов или папкой, доступной по URL-адресу.An origin can be a SharePoint site, document library or folder that is accessible by a URL. У вас есть большая гибкость при указании истоков для организации.You have great flexibility when you specify origins for your organization. Например, можно указать несколько источников или одно происхождение, куда необходимо поместить все ресурсы CDN.For example, you can specify multiple origins or a single origin where you want to put all your CDN assets. Вы можете выбрать общедоступные или частные истоки для вашей организации.You can choose to have both public or private origins for your organization. Большинство организаций будут выбирать для реализации сочетания этих двух.Most organizations will choose to implement a combination of the two.

Вы можете создать новый контейнер для истоков, таких как папки или библиотеки документов, и добавить файлы, которые необходимо сделать доступными из CDN.You can create new container for your origins such as folders or document libraries, and add files you want to make available from the CDN. Это хороший подход, если у вас есть определенный набор активов, которые вы хотите быть доступными из CDN, и хотите ограничить набор cdN-активов только этими файлами в контейнере.This is a good approach if you have a specific set of assets you want to be available from the CDN, and want to restrict the set of CDN assets to only those files in the container.

Вы также можете настроить существующую коллекцию сайтов, сайт, библиотеку или папку в качестве источника, что сделает все подходящие активы в контейнере доступными из CDN.You can also configure an existing site collection, site, library or folder as an origin, which will make all eligible assets in the container available from the CDN. Перед добавлением существующего контейнера в качестве источника важно убедиться, что вы осведомлены о его содержимом и разрешениях, чтобы не случайно подвергать ресурсы анонимному доступу или неавторизованным пользователям.Before you add an existing container as an origin, it's important to make sure you are aware of its contents and permissions so you do not inadvertently expose assets to anonymous access or unauthorized users.

Вы можете определить политики CDN, чтобы исключить содержимое в истоках из CDN.You can define CDN policies to exclude content in your origins from the CDN. Политики CDN исключают активы государственного или частного происхождения по атрибутам, таким как тип файла и классификация сайтов, и применяются для всех истоков cdnType (частных или общедоступных), которые указаны в политике.CDN policies exclude assets in public or private origins by attributes such as file type and site classification, and are applied to all origins of the CdnType (private or public) you specify in the policy. Например, если вы добавляете частное происхождение, состоящее из сайта с несколькими подмитами, можно определить политику, исключаемую сайты, помеченные как Конфиденциальные, чтобы содержимое сайтов с примененной классификацией не было подается из CDN.For example, if you add a private origin consisting of a site that contains multiple subsites, you can define a policy to exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN. Политика будет применяться к контенту из всех частных истоков, добавленных в CDN.The policy will apply to content from all private origins you have added to the CDN.

Имейте в виду, что чем больше количество истоков, тем больше влияние на время обработки запросов службой CDN.Keep in mind that the greater the number of origins, the greater the impact on the time it takes the CDN service to process requests. Рекомендуем максимально ограничить количество истоков.We recommend that you limit the number of origins as much as possible.

Выберите, должно ли каждое происхождение быть общедоступным или закрытым.Choose whether each origin should be public or private

При определении источника указывается, следует ли сделать его общедоступным или закрытым.When you identify an origin, you specify whether it should be made public or private. Доступ к активам CDN в общедоступных источниках анонимный, а контент CDN частного происхождения обеспечивается динамически созданными маркерами для большей безопасности.Access to CDN assets in public origins is anonymous, and CDN content in private origins is secured by dynamically generated tokens for greater security. Независимо от того, какой из вариантов вы выбираете, Корпорация Майкрософт делает все, что необходимо для вас, когда речь заходит об администрировании самого CDN.Regardless of which option you choose, Microsoft does all the heavy lifting for you when it comes to administration of the CDN itself. Кроме того, вы можете изменить свое решение позже, после того как вы настроите CDN и идентифицировали свои истоки.Also, you can change your mind later, after you've set up the CDN and identified your origins.

Как общедоступные, так и частные параметры обеспечивают аналогичные преимущества производительности, но каждый из них имеет уникальные атрибуты и преимущества.Both public and private options provide similar performance gains, but each has unique attributes and advantages.

Общедоступные истоки в CDN Office 365 доступны анонимно, а к общедоступным активам может получить доступ любой, у кого есть URL-адрес актива.Public origins within the Office 365 CDN are accessible anonymously, and hosted assets can be accessed by anyone who has the URL to the asset. Так как доступ к содержимому в общедоступных источниках является анонимным, следует использовать их только для кэширования неконфиденциального общего содержимого, например файлов JavaScript, скриптов, значков и изображений.Because access to content in public origins is anonymous, you should only use them to cache non-sensitive generic content such as JavaScript files, scripts, icons and images.

Частные истоки в CDN Office 365 предоставляют частный доступ к пользовательскому контенту, такому как библиотеки документов SharePoint Online, сайты и собственные изображения.Private origins within the Office 365 CDN provide private access to user content such as SharePoint Online document libraries, sites and proprietary images. Доступ к контенту частного происхождения обеспечивается динамически созданными маркерами, поэтому доступ к нему могут получить только пользователи с разрешениями на исходную библиотеку документов или расположение хранилища.Access to content in private origins is secured by dynamically generated tokens so it can only be accessed by users with permissions to the original document library or storage location. Частные истоки CDN Office 365 можно использовать только для контента SharePoint Online, а получить доступ к активам частного происхождения можно только через перенаправление с клиента SharePoint Online.Private origins in the Office 365 CDN can only be used for SharePoint Online content, and you can only access assets in private origins through redirection from your SharePoint Online tenant.

Подробнее о том, как работает доступ CDN к активам частного происхождения, читайте в публикации "Использование активов в частном происхождении".You can read more about how CDN access to assets in a private origin works in Using assets in private origins.

Атрибуты и преимущества размещения активов в общедоступных источникахAttributes and advantages of hosting assets in public origins

  • Ресурсы, предоставляемые из общедоступного источника, доступны всем анонимно.Assets exposed in a public origin are accessible by everyone anonymously.

    Важно!

    Никогда не следует разместить ресурсы, содержащие сведения о пользователях или которые считаются конфиденциальными для организации в публичном происхождении.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

  • Если удалить ресурс из общедоступного источника, он может оставаться доступным в кэше до 30 дней. Однако ссылки на ресурс в сети CDN станут недействительными в течение 15 минут.If you remove an asset from a public origin, the asset may continue to be available for up to 30 days from the cache; however, we will invalidate links to the asset in the CDN within 15 minutes.

  • При размещении таблиц стилей (CSS-файлов) в общедоступном источнике можно использовать в коде относительные пути и URI.When you host style sheets (CSS files) in a public origin, you can use relative paths and URIs within the code. Это означает, что вы можете ссылаться на расположение фоновых изображений и других объектов относительно расположения ресурса, который вызывает его.This means that you can reference the location of background images and other objects relative to the location of the asset that's calling it.

  • Хотя вы можете создать URL-адрес общего происхождения, следует действовать с осторожностью и убедиться, что вы используете свойство контекста страницы и следуйте указаниям для этого.While you can construct a public origin's URL, you should proceed with caution and ensure you utilize the page context property and follow the guidance for doing so. Это связано с тем, что если сеть CDN станет недоступна, то URL-адрес не будет автоматически указывать на вашу организацию в SharePoint Online, что может привести к неработоспособности ссылок и другим ошибкам.The reason for this is that if access to the CDN becomes unavailable, the URL will not automatically resolve to your organization in SharePoint Online and might result in broken links and other errors. Url-адрес также подлежит изменению, поэтому он не должен быть просто жестко закодироваться к текущему значению.The URL is also subject to change which is why it should not just be hard coded to its current value.

  • Типы файлов по умолчанию, включенные для общедоступных истоков, являются .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff и .woff2.The default file types that are included for public origins are .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff and .woff2. Можно указать дополнительные типы файлов.You can specify additional file types.

  • Можно настроить политику, чтобы исключить активы, которые были определены в классификациях сайтов, которые указаны.You can configure a policy to exclude assets that have been identified by site classifications that you specify. Например, вы можете исключать все ресурсы, отмеченные как "конфиденциальные" или "с ограниченным доступом", даже если они относятся к разрешенным типам файлов и находятся в общедоступном источнике.For example, you can choose to exclude all assets that are marked as "confidential" or "restricted" even if they are an allowed file type and are located in a public origin.

Атрибуты и преимущества размещения активов в частном происхожденииAttributes and advantages of hosting assets in private origins

  • Частные истоки можно использовать только для активов SharePoint Online.Private origins can only be used for SharePoint Online assets.

  • Пользователи могут получить доступ к активам частного происхождения только в том случае, если у них есть разрешения на доступ к контейнеру.Users can only access the assets from a private origin if they have permissions to access the container. Анонимный доступ к таким ресурсам запрещен.Anonymous access to these assets is prevented.

  • Активы частного происхождения должны быть переданы из клиента SharePoint Online.Assets in private origins must be referred from the SharePoint Online tenant. Прямой доступ к частным cdN-активам не работает.Direct access to private CDN assets does not work.

  • Если вы удалите актив из частного происхождения, актив может оставаться доступным в течение часа из кэша; однако в течение 15 минут после удаления актива ссылки на актив в CDN будут признаны недействительными.If you remove an asset from the private origin, the asset may continue to be available for up to an hour from the cache; however, we will invalidate links to the asset in the CDN within 15 minutes of the asset's removal.

  • По умолчанию для частных источников включены типы файлов GIF, ICO, JPEG, JPG, JS и PNG.The default file types that are included for private origins are .gif, .ico, .jpeg, .jpg, .js, and .png. Можно указать дополнительные типы файлов.You can specify additional file types.

  • Как и с общедоступными истоками, можно настроить политику, чтобы исключить активы, которые были определены классификациями сайтов, которые вы указываете, даже если вы используете поддиальды, чтобы включить все активы в папку или библиотеку документов.Just like with public origins, you can configure a policy to exclude assets that have been identified by site classifications that you specify even if you use wildcards to include all assets within a folder or document library.

Дополнительные сведения о том, зачем использовать CDN Office 365, общие концепции CDN и другие CDN Майкрософт, которые можно использовать с клиентом Office 365, см. в статью Content Delivery Networks.For more information about why to use the Office 365 CDN, general CDN concepts, and other Microsoft CDNs you can use with your Office 365 tenant, see Content Delivery Networks.

Происхождение CDN по умолчаниюDefault CDN origins

Если не указать обратное, Office 365 устанавливает для вас некоторые истоки по умолчанию, если вы включаете CDN Office 365.Unless you specify otherwise, Office 365 sets up some default origins for you when you enable the Office 365 CDN. Если изначально вы решите не добавлять их, вы можете добавить эти истоки после завершения установки.If you initially opt not to provision them, you can add these origins after you complete setup. Если вы не понимаете последствия пропуска установки истоков по умолчанию и не имеете для этого конкретной причины, вы должны разрешить их создавать, когда вы включаете CDN.Unless you understand the consequences of skipping the setup of default origins and have a specific reason for doing so, you should allow them to be created when you enable the CDN.

Частные истоки CDN по умолчанию:Default private CDN origins:

  • */userphoto.aspx*/userphoto.aspx
  • */siteassets*/siteassets

Общедоступные истоки CDN по умолчанию:Default public CDN origins:

  • */masterpage*/masterpage
  • */библиотека стилей*/style library
  • */clientsideassets*/clientsideassets

Примечание

clientsideassets — это общедоступный источник по умолчанию, который был добавлен в службу CDN Office 365 в декабре 2017 г.clientsideassets is a default public origin that was added to the Office 365 CDN service in December 2017. Это происхождение должно присутствовать для того, чтобы решения SharePoint Framework в CDN работали.This origin must be present in order for SharePoint Framework solutions in the CDN to work. Если вы включили CDN Office 365 до декабря 2017 г. или пропустили установку истоков по умолчанию при включении CDN, можно вручную добавить это начало.If you enabled the Office 365 CDN prior to December 2017, or if you skipped setup of default origins when you enabled the CDN, you can manually add this origin. Дополнительные сведения см. в раздел Моя клиентская веб-часть или решение SharePoint Framework не работает.For more information, see My client-side web part or SharePoint Framework solution isn't working.

Настройка и настройка CDN Office 365 с помощью оболочки управления SharePoint OnlineSet up and configure the Office 365 CDN by using the SharePoint Online Management Shell

Процедуры в этом разделе требуют, чтобы вы использовали оболочку управления SharePoint Online для подключения к SharePoint Online.The procedures in this section require you to use the SharePoint Online Management Shell to connect to SharePoint Online. Инструкции см. в статье Connect to SharePoint Online PowerShell.For instructions, see Connect to SharePoint Online PowerShell.

Выполните эти действия, чтобы настроить CDN для организации активов в SharePoint Online с помощью оболочки управления SharePoint Online.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the SharePoint Online Management Shell.

Щелкните, чтобы развернутьClick to expand

Включить организацию для использования CDN Office 365Enable your organization to use the Office 365 CDN

Прежде чем вносить изменения в параметры CDN клиента, необходимо получить текущее состояние закрытой конфигурации CDN в клиенте Office 365.Before you make changes to the tenant CDN settings, you should retrieve the current status of the private CDN configuration in your Office 365 tenant. Подключение к клиенту с помощью оболочки управления SharePoint Online:Connect to your tenant using the SharePoint Online Management Shell:

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

Теперь используйте комлет Get-SPOTenantCdnEnabled для получения параметров состояния CDN у клиента:Now use the Get-SPOTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Состояние CDN для указанного CdnType выводит на экран.The status of the CDN for the specified CdnType will output to the screen.

Используйте комлет Set-SPOTenantCdnEnabled, чтобы позволить организации использовать CDN Office 365.Use the Set-SPOTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Вы можете включить организацию для использования общедоступных истоков, частных и одновременно обоих.You can enable your organization to use public origins, private origins, or both at once. Можно также настроить CDN, чтобы пропустить настройку истоков по умолчанию при его впусте.You can also configure the CDN to skip the setup of default origins when you enable it. Вы всегда можете добавить эти истоки позже, как описано в этой теме.You can always add these origins later as described in this topic.

В Windows PowerShell SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Например, чтобы позволить организации использовать общедоступные и частные истоки, введите следующую команду:For example, to enable your organization to use both public and private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Чтобы позволить организации использовать как общедоступные, так и частные истоки, но пропустить настройку истоков по умолчанию, введите следующую команду:To enable your organization to use both public and private origins but skip setting up the default origins, type the following command:

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

Сведения о происхождении по умолчанию, которые предусмотрены по умолчанию при встройки CDN Office 365, и о потенциальном влиянии пропуска установки истоков по умолчанию см. в истоках CDN по умолчанию.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Чтобы позволить организации использовать общедоступные истоки, введите следующую команду:To enable your organization to use public origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Чтобы позволить организации использовать частные истоки, введите следующую команду:To enable your organization to use private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Дополнительные сведения об этом комлете см. в этой ленте Set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Измените список типов файлов, чтобы включить их в CDN Office 365 (необязательный)Change the list of file types to include in the Office 365 CDN (Optional)

Совет

При определении типов файлов с помощью комлета Set-SPOTenantCdnPolicy переопределяется определенный список.When you define file types by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Если вы хотите добавить в список дополнительные типы файлов, сначала используйте этот список, чтобы узнать, какие типы файлов уже разрешены, и включите их в список вместе с новыми.If you want to add additional file types to the list, use the cmdlet first to find out what file types are already allowed and include them in the list along with your new ones.

Для определения типов статических файлов, которые могут быть организованы государственным и частным происхождением в CDN, используйте коммюлет Set-SPOTenantCdnPolicy.Use the Set-SPOTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. По умолчанию разрешены общие типы активов, например .css, .gif, .jpg и .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

В Windows PowerShell SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Например, чтобы включить CDN для хозяйских файлов .css и .png, необходимо ввести команду:For example, to enable the CDN to host .css and .png files, you would enter the command:

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

Чтобы узнать, какие типы файлов в настоящее время разрешены CDN, используйте cmdlet Get-SPOTenantCdnPolicies:To see what file types are currently allowed by the CDN, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Дополнительные сведения об этих cmdlets см. в set-SPOTenantCdnPolicy и Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Измените список классификаций сайтов, которые необходимо исключить из CDN Office 365 (необязательный)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Совет

При исключении классификации сайтов с помощью комлета Set-SPOTenantCdnPolicy переопределяется определенный список.When you exclude site classifications by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Если вы хотите исключить дополнительные классификации сайтов, сначала используйте cmdlet, чтобы узнать, какие классификации уже исключены, а затем добавить их вместе с новыми.If you want to exclude additional site classifications, use the cmdlet first to find out what classifications are already excluded and then add them along with your new ones.

Чтобы исключить классификации сайтов, которые не должны быть доступны в сети CDN, используйте командлет Set-SPOTenantCdnPolicy.Use the Set-SPOTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. По умолчанию не исключаются никакие классификации сайтов.By default, no site classifications are excluded.

В Windows PowerShell SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Чтобы узнать, какие классификации сайтов в настоящее время ограничены, используйте см. в рубриках Get-SPOTenantCdnPolicies:To see what site classifications are currently restricted, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Свойства, которые будут возвращены: IncludeFileExtensions, ExcludeRestrictedSiteClassifications и ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Свойство IncludeFileExtensions содержит список расширений файлов, которые будут подаваться из CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Примечание

Расширения файлов по умолчанию отличаются между общедоступными и закрытыми.The default file extensions are different between public and private.

Свойство ExcludeRestrictedSiteClassifications содержит классификации сайтов, которые необходимо исключить из CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Например, можно исключить сайты, помеченные как Конфиденциальные, чтобы содержимое сайтов с применяемой классификацией не обслуживалось из CDN.For example, you can exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN.

Свойство ExcludeIfNoScriptDisabled исключает контент из CDN на основе параметров атрибута NoScript на уровне сайта.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. По умолчанию для атрибута NoScript устанавливается значение Включено для современных сайтов и отключено для классических сайтов.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Это зависит от параметров клиента.This depends on your tenant settings.

Дополнительные сведения об этих cmdlets см. в set-SPOTenantCdnPolicy и Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Добавление источника для ваших активовAdd an origin for your assets

Чтобы определить происхождение, используйте кодлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define an origin. Вы можете определить несколько источников.You can define multiple origins. Источник — это URL-адрес, указывающий на библиотеку или папку в SharePoint, содержащую ресурсы, которые требуется размещать в сети CDN.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

Важно!

Никогда не следует разместить ресурсы, содержащие сведения о пользователях или которые считаются конфиденциальными для организации в публичном происхождении.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

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

Значение пути это относительный путь к библиотеке или папке, которая содержит активы.The value of path is the relative path to the library or folder that contains the assets. Помимо относительных путей, можно использовать подстановочные знаки.You can use wildcards in addition to relative paths. Origins поддерживает подкарды, предварительно заранее заранее примыкает к URL-адресу.Origins support wildcards prepended to the URL. Это позволяет создавать истоки, охватывающие несколько сайтов.This allows you to create origins that span multiple sites. Например, чтобы включить все активы в папку masterpages для всех сайтов в качестве общедоступных в cdN, введите следующую команду:For example, to include all of the assets in the masterpages folder for all of your sites as a public origin within the CDN, type the following command:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Модификатор под диктовки * может использоваться только в начале пути и будет соответствовать всем сегментам URL-адресов по / указанному URL-адресу.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Путь может указать на библиотеку документов, папку или сайт.The path can point to a document library, folder or site. Например, путь */site1 будет соответствовать всем библиотекам документов на сайте.For example, the path */site1 will match all the document libraries under the site.

Можно добавить происхождение с определенным относительным путем.You can add an origin with a specific relative path. Невозможно добавить начало с помощью полного пути.You cannot add an origin using the full path.

В этом примере добавляется частное происхождение библиотеки siteassets на определенном сайте:This example adds a private origin of the siteassets library on a specific site:

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

В этом примере добавляется частное происхождение папки1 в библиотеке ресурсов сайтов коллекции сайтов:This example adds a private origin of the folder1 folder in the site collection's site assets library:

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

Если на пути есть пробел, можно либо окружить путь двойными кавычками, либо заменить пространство url-адресом, кодировка которого составляет %20.If there is a space in the path, you can either surround the path in double quotes or replace the space with the URL encoding %20. В следующих примерах добавлено частное происхождение папки 1 в библиотеке ресурсов сайтов коллекции сайтов:The following examples add a private origin of the folder 1 folder in the site collection's site assets library:

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

Дополнительные сведения об этой команде и ее синтаксис см. в обзоре Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Примечание

В частных источниках ресурсы, общие для происхождения, должны иметь крупную версию, опубликованную до того, как к ним можно получить доступ из CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка общедоступных страниц и библиотеки стилей для SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Обычно эти истоки устанавливаются для вас по умолчанию, когда вы включаете CDN Office 365.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Однако, если вы хотите включить их вручную, выполните эти действия.However, if you want to enable them manually, follow these steps.

  • Чтобы определить библиотеку стилей как публичное происхождение, используйте смедлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Для определения магистральных страниц как общедоступных страниц используйте смедлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Дополнительные сведения об этой команде и ее синтаксис см. в обзоре Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка частного происхождения для активов сайта, страниц сайта и публикации изображений для SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Чтобы определить папку активов сайта как частное происхождение, используйте смлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Чтобы определить папку страниц сайта как частное происхождение, используйте кодлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Чтобы определить папку изображений публикации как частное происхождение, используйте кодлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Дополнительные сведения об этой команде и ее синтаксис см. в обзоре Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка частного происхождения для коллекции сайтов для SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Чтобы определить коллекцию сайтов как частное происхождение, используйте смлет Add-SPOTenantCdnOrigin.Use the Add-SPOTenantCdnOrigin cmdlet to define a site collection as a private origin. Например,For example:

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

Дополнительные сведения об этой команде и ее синтаксис см. в обзоре Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Вы можете увидеть ожидаемое сообщение Конфигурация, которое ожидается по мере подключения клиента SharePoint Online к службе CDN.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Это может занять до 15 минут.This can take up to 15 minutes.

Управление CDN Office 365Manage the Office 365 CDN

После настройки CDN можно внести изменения в конфигурацию при обновлении контента или изменении потребностей, как описано в этом разделе.Once you've set up the CDN, you can make changes to your configuration as you update content or as your needs change, as described in this section.

Добавление, обновление или удаление активов из CDN Office 365Add, update, or remove assets from the Office 365 CDN

После завершения действий по настройке можно добавлять новые активы и обновлять или удалять существующие активы, когда захотите.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Просто внести изменения в ресурсы в папке или библиотеке SharePoint, которые вы определили в качестве источника.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. При добавлении нового актива он сразу же будет доступен через CDN.If you add a new asset, it is available through the CDN immediately. Однако при обновлении актива для распространения и распространения новой копии в CDN может занять до 15 минут.However, if you update the asset, it will take up to 15 minutes for the new copy to propagate and become available in the CDN.

Если вам нужно получить расположение источника, можно использовать комлет Get-SPOTenantCdnOrigins.If you need to retrieve the location of the origin, you can use the Get-SPOTenantCdnOrigins cmdlet. Сведения об использовании этого комлета см. в сайте Get-SPOTenantCdnOrigins.For information on how to use this cmdlet, see Get-SPOTenantCdnOrigins.

Удаление источника из CDN Office 365Remove an origin from the Office 365 CDN

Вы можете удалить доступ к папке или библиотеке SharePoint, которые были определены в качестве источника.You can remove access to a folder or SharePoint library that you identified as an origin. Для этого используйте комлет Remove-SPOTenantCdnOrigin.To do this, use the Remove-SPOTenantCdnOrigin cmdlet.

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

Сведения об использовании этого cmdlet см. в см. в этой ленте Remove-SPOTenantCdnOrigin.For information on how to use this cmdlet, see Remove-SPOTenantCdnOrigin.

Изменение источника в CDN Office 365Modify an origin in the Office 365 CDN

Вы не можете изменить созданное происхождение.You cannot modify an origin you've created. Вместо этого удалите начало и добавьте новый.Instead, remove the origin and then add a new one. Дополнительные сведения см. в статью Удаление источника из CDN Office 365 и добавление источника для ваших активов.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Отключение CDN Office 365Disable the Office 365 CDN

Чтобы отключить CDN для организации, используйте комлет Set-SPOTenantCdnEnabled.Use the Set-SPOTenantCdnEnabled cmdlet to disable the CDN for your organization. Если для CDN включены как общедоступные, так и частные истоки, необходимо выполнить этот код дважды, как показано в следующих примерах.If you have both the public and private origins enabled for the CDN, you need to run the cmdlet twice as shown in the following examples.

Чтобы отключить использование общедоступных истоков в CDN, введите следующую команду:To disable use of public origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Чтобы отключить использование личных истоков в CDN, введите следующую команду:To disable use of the private origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Дополнительные сведения об этом комлете см. в этой ленте Set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Настройка и настройка CDN Office 365 с помощью PnP PowerShellSet up and configure the Office 365 CDN by using PnP PowerShell

Процедуры в этом разделе требуют, чтобы вы использовали PnP PowerShell для подключения к SharePoint Online.The procedures in this section require you to use PnP PowerShell to connect to SharePoint Online. Инструкции см. в инструкции "Начало работы с PnP PowerShell".For instructions, see Getting started with PnP PowerShell.

Выполните эти действия, чтобы настроить CDN для хозяйского хозяйского актива в SharePoint Online с помощью PnP PowerShell.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using PnP PowerShell.

Щелкните, чтобы развернутьClick to expand

Включить организацию для использования CDN Office 365Enable your organization to use the Office 365 CDN

Прежде чем вносить изменения в параметры CDN клиента, необходимо получить текущее состояние закрытой конфигурации CDN в клиенте Office 365.Before you make changes to the tenant CDN settings, you should retrieve the current status of the private CDN configuration in your Office 365 tenant. Подключение к клиенту с помощью PnP PowerShell:Connect to your tenant using PnP PowerShell:

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

Теперь используйте комлет Get-PnPTenantCdnEnabled для получения параметров состояния CDN у клиента:Now use the Get-PnPTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Состояние CDN для указанного CdnType выводит на экран.The status of the CDN for the specified CdnType will output to the screen.

Используйте комлет Set-PnPTenantCdnEnabled, чтобы позволить организации использовать CDN Office 365.Use the Set-PnPTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Вы можете включить организацию для использования общедоступных и частных истоков одновременно.You can enable your organization to use public origins, private origins, or both at at the same time. Можно также настроить CDN, чтобы пропустить настройку истоков по умолчанию при его впусте.You can also configure the CDN to skip the setup of default origins when you enable it. Вы всегда можете добавить эти истоки позже, как описано в этой теме.You can always add these origins later as described in this topic.

В PnP PowerShell:In PnP PowerShell:

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

Например, чтобы позволить организации использовать общедоступные и частные истоки, введите следующую команду:For example, to enable your organization to use both public and private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Чтобы позволить организации использовать как общедоступные, так и частные истоки, но пропустить настройку истоков по умолчанию, введите следующую команду:To enable your organization to use both public and private origins but skip setting up the default origins, type the following command:

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

Сведения о происхождении по умолчанию, которые предусмотрены по умолчанию при встройки CDN Office 365, и о потенциальном влиянии пропуска установки истоков по умолчанию см. в истоках CDN по умолчанию.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Чтобы позволить организации использовать общедоступные истоки, введите следующую команду:To enable your organization to use public origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Чтобы позволить организации использовать частные истоки, введите следующую команду:To enable your organization to use private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Дополнительные сведения об этом комлете см. в дополнительных сведениях set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Измените список типов файлов, чтобы включить их в CDN Office 365 (необязательный)Change the list of file types to include in the Office 365 CDN (Optional)

Совет

При определении типов файлов с помощью комлета Set-PnPTenantCdnPolicy переопределяется определенный список.When you define file types by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Если вы хотите добавить в список дополнительные типы файлов, сначала используйте этот список, чтобы узнать, какие типы файлов уже разрешены, и включите их в список вместе с новыми.If you want to add additional file types to the list, use the cmdlet first to find out what file types are already allowed and include them in the list along with your new ones.

Для определения типов статических файлов, которые могут быть организованы государственными и частными истоками в CDN, используйте коммюлет Set-PnPTenantCdnPolicy.Use the Set-PnPTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. По умолчанию разрешены общие типы активов, например .css, .gif, .jpg и .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

В PnP PowerShell:In PnP PowerShell:

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

Например, чтобы включить CDN для хозяйских файлов .css и .png, необходимо ввести команду:For example, to enable the CDN to host .css and .png files, you would enter the command:

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

Чтобы узнать, какие типы файлов в настоящее время разрешены CDN, используйте cmdlet Get-PnPTenantCdnPolicies:To see what file types are currently allowed by the CDN, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Дополнительные сведения об этих cmdlets см. в set-PnPTenantCdnPolicy и Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Измените список классификаций сайтов, которые необходимо исключить из CDN Office 365 (необязательный)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Совет

При исключении классификаций сайтов с помощью комлета Set-PnPTenantCdnPolicy переопределяется определенный список.When you exclude site classifications by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Если вы хотите исключить дополнительные классификации сайтов, сначала используйте cmdlet, чтобы узнать, какие классификации уже исключены, а затем добавить их вместе с новыми.If you want to exclude additional site classifications, use the cmdlet first to find out what classifications are already excluded and then add them along with your new ones.

Используйте комлет Set-PnPTenantCdnPolicy, чтобы исключить классификации сайтов, которые не требуется делать доступными в CDN.Use the Set-PnPTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. По умолчанию не исключаются никакие классификации сайтов.By default, no site classifications are excluded.

В PnP PowerShell:In PnP PowerShell:

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

Чтобы узнать, какие классификации сайтов в настоящее время ограничены, используйте кодлет Get-PnPTenantCdnPolicies:To see what site classifications are currently restricted, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Свойства, которые будут возвращены: IncludeFileExtensions, ExcludeRestrictedSiteClassifications и ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Свойство IncludeFileExtensions содержит список расширений файлов, которые будут подаваться из CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Примечание

Расширения файлов по умолчанию отличаются между общедоступными и закрытыми.The default file extensions are different between public and private.

Свойство ExcludeRestrictedSiteClassifications содержит классификации сайтов, которые необходимо исключить из CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Например, можно исключить сайты, помеченные как Конфиденциальные, чтобы содержимое сайтов с применяемой классификацией не обслуживалось из CDN.For example, you can exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN.

Свойство ExcludeIfNoScriptDisabled исключает контент из CDN на основе параметров атрибута NoScript на уровне сайта.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. По умолчанию для атрибута NoScript устанавливается значение Включено для современных сайтов и отключено для классических сайтов.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Это зависит от параметров клиента.This depends on your tenant settings.

Дополнительные сведения об этих cmdlets см. в set-PnPTenantCdnPolicy и Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Добавление источника для ваших активовAdd an origin for your assets

Чтобы определить происхождение, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define an origin. Вы можете определить несколько источников.You can define multiple origins. Источник — это URL-адрес, указывающий на библиотеку или папку в SharePoint, содержащую ресурсы, которые требуется размещать в сети CDN.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

Важно!

Никогда не следует разместить ресурсы, содержащие сведения о пользователях или которые считаются конфиденциальными для организации в публичном происхождении.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

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

Значение пути это относительный путь к библиотеке или папке, которая содержит активы.The value of path is the relative path to the library or folder that contains the assets. Помимо относительных путей, можно использовать подстановочные знаки.You can use wildcards in addition to relative paths. Origins поддерживает подкарды, предварительно заранее заранее примыкает к URL-адресу.Origins support wildcards prepended to the URL. Это позволяет создавать истоки, охватывающие несколько сайтов.This allows you to create origins that span multiple sites. Например, чтобы включить все активы в папку masterpages для всех сайтов в качестве общедоступных в cdN, введите следующую команду:For example, to include all of the assets in the masterpages folder for all of your sites as a public origin within the CDN, type the following command:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Модификатор под диктовки * может использоваться только в начале пути и будет соответствовать всем сегментам URL-адресов по / указанному URL-адресу.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Путь может указать на библиотеку документов, папку или сайт.The path can point to a document library, folder or site. Например, путь */site1 будет соответствовать всем библиотекам документов на сайте.For example, the path */site1 will match all the document libraries under the site.

Можно добавить происхождение с определенным относительным путем.You can add an origin with a specific relative path. Невозможно добавить начало с помощью полного пути.You cannot add an origin using the full path.

В этом примере добавляется частное происхождение библиотеки ресурсов сайта на определенном сайте:This example adds a private origin of the site assets library on a specific site:

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

В этом примере добавляется частное происхождение папки1 в библиотеке ресурсов сайтов коллекции сайтов:This example adds a private origin of the folder1 folder in the site collection's site assets library:

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

Если на пути есть пробел, можно либо окружить путь двойными кавычками, либо заменить пространство url-адресом, кодировка которого составляет %20.If there is a space in the path, you can either surround the path in double quotes or replace the space with the URL encoding %20. В следующих примерах добавлено частное происхождение папки 1 в библиотеке ресурсов сайтов коллекции сайтов:The following examples add a private origin of the folder 1 folder in the site collection's site assets library:

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

Дополнительные сведения об этой команде и ее синтаксис см. в добавлении-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Примечание

В частных источниках ресурсы, общие для происхождения, должны иметь крупную версию, опубликованную до того, как к ним можно получить доступ из CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка общедоступных страниц и библиотеки стилей для SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Обычно эти истоки устанавливаются для вас по умолчанию, когда вы включаете CDN Office 365.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Однако, если вы хотите включить их вручную, выполните эти действия.However, if you want to enable them manually, follow these steps.

  • Чтобы определить библиотеку стилей как общедоступный, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Для определения магистральных страниц как общедоступных страниц используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Дополнительные сведения об этой команде и ее синтаксис см. в добавлении-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка частного происхождения для активов сайта, страниц сайта и публикации изображений для SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Чтобы определить папку активов сайта как частное происхождение, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Чтобы определить папку страниц сайта как частное происхождение, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Чтобы определить папку изображений публикации как частное происхождение, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Дополнительные сведения об этой команде и ее синтаксис см. в добавлении-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Это может занять до 15 минут.This can take up to 15 minutes.

Пример: Настройка частного происхождения для коллекции сайтов для SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Чтобы определить коллекцию сайтов как частное происхождение, используйте кодлет Add-PnPTenantCdnOrigin.Use the Add-PnPTenantCdnOrigin cmdlet to define a site collection as a private origin. Например,For example:

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

Дополнительные сведения об этой команде и ее синтаксис см. в добавлении-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

После запуска команды система синхронизирует конфигурацию через центр обработки данных.Once you've run the command, the system synchronizes the configuration across the datacenter. Вы можете увидеть ожидаемое сообщение Конфигурация, которое ожидается по мере подключения клиента SharePoint Online к службе CDN.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Это может занять до 15 минут.This can take up to 15 minutes.

Управление CDN Office 365Manage the Office 365 CDN

После настройки CDN можно внести изменения в конфигурацию при обновлении контента или изменении потребностей, как описано в этом разделе.Once you've set up the CDN, you can make changes to your configuration as you update content or as your needs change, as described in this section.

Добавление, обновление или удаление активов из CDN Office 365Add, update, or remove assets from the Office 365 CDN

После завершения действий по настройке можно добавлять новые активы и обновлять или удалять существующие активы, когда захотите.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Просто внести изменения в ресурсы в папке или библиотеке SharePoint, которые вы определили в качестве источника.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. При добавлении нового актива он сразу же будет доступен через CDN.If you add a new asset, it is available through the CDN immediately. Однако при обновлении актива для распространения и распространения новой копии в CDN может занять до 15 минут.However, if you update the asset, it will take up to 15 minutes for the new copy to propagate and become available in the CDN.

Если вам нужно получить расположение источника, можно использовать комлет Get-PnPTenantCdnOrigin.If you need to retrieve the location of the origin, you can use the Get-PnPTenantCdnOrigin cmdlet. Сведения об использовании этого комлета см. в сайте Get-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Get-PnPTenantCdnOrigin.

Удаление источника из CDN Office 365Remove an origin from the Office 365 CDN

Вы можете удалить доступ к папке или библиотеке SharePoint, которые были определены в качестве источника.You can remove access to a folder or SharePoint library that you identified as an origin. Для этого используйте комлет Remove-PnPTenantCdnOrigin.To do this, use the Remove-PnPTenantCdnOrigin cmdlet.

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

Сведения о том, как использовать этот комлет, см. в этой брошюре Remove-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Remove-PnPTenantCdnOrigin.

Изменение источника в CDN Office 365Modify an origin in the Office 365 CDN

Вы не можете изменить созданное происхождение.You cannot modify an origin you've created. Вместо этого удалите начало и добавьте новый.Instead, remove the origin and then add a new one. Дополнительные сведения см. в статью Удаление источника из CDN Office 365 и добавление источника для ваших активов.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Отключение CDN Office 365Disable the Office 365 CDN

Чтобы отключить CDN для организации, используйте комлет Set-PnPTenantCdnEnabled.Use the Set-PnPTenantCdnEnabled cmdlet to disable the CDN for your organization. Если для CDN включены как общедоступные, так и частные истоки, необходимо выполнить этот код дважды, как показано в следующих примерах.If you have both the public and private origins enabled for the CDN, you need to run the cmdlet twice as shown in the following examples.

Чтобы отключить использование общедоступных истоков в CDN, введите следующую команду:To disable use of public origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Чтобы отключить использование личных истоков в CDN, введите следующую команду:To disable use of the private origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Дополнительные сведения об этом комлете см. в дополнительных сведениях set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Установка и настройка сети CDN Office 365 с помощью интерфейса командной строки Office 365:Set up and configure the Office 365 CDN using the Office 365 CLI

Процедуры в этом разделе требуют установки CLI Office 365.The procedures in this section require that you have installed the Office 365 CLI. Далее подключите клиента Office 365 с помощью команды входа.Next, connect to your Office 365 tenant using the login command.

Выполните эти действия, чтобы настроить CDN для пребывания активов в SharePoint Online с помощью CLI Office 365.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the Office 365 CLI.

Щелкните, чтобы развернутьClick to expand

Включить CDN Office 365Enable the Office 365 CDN

Вы можете управлять состоянием сети CDN Office 365 в клиенте с помощью команды spo cdn set.You can manage the state of the Office 365 CDN in your tenant using the spo cdn set command.

Чтобы включить в клиенте общедоступную сеть CDN Office 365, выполните следующую команду:To enable the Office 365 Public CDN in your tenant execute:

spo cdn set --type Public --enabled true

Чтобы включить CDN SharePoint Office 365, выполните:To enable the Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Просмотр текущего состояния сети CDN Office 365View the current status of the Office 365 CDN

Чтобы проверить, включен или отключен определенный тип CDN Office 365, используйте команду spo cdn get.To check if the particular type of Office 365 CDN is enabled or disabled, use the spo cdn get command.

Чтобы проверить, включена ли общедоступная сеть CDN Office 365, выполните следующую команду:To check if the Office 365 Public CDN is enabled, execute:

spo cdn get --type Public

Просмотр истоков CDN Office 365View the Office 365 CDN origins

Чтобы просмотреть список настроенных в данный момент общедоступных источников CDN Office 365, выполните следующую команду:To view the currently configured Office 365 Public CDN origins execute:

spo cdn origin list --type Public

Сведения о происхождении по умолчанию, которые будут предусмотрены по умолчанию при внии CDN Office 365, см. в истоках CDN по умолчанию.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Добавление источника CDN Office 365Add an Office 365 CDN origin

Важно!

Никогда не следует разместить ресурсы, которые считаются конфиденциальными для организации, в библиотеку документов SharePoint, настроенную как общедоступный источник.You should never place resources that are considered sensitive to your organization in a SharePoint document library configured as a public origin.

Чтобы определить источник CDN, используйте команду spo cdn origin add.Use the spo cdn origin add command to define a CDN origin. Вы можете определить несколько источников.You can define multiple origins. Источник — это URL-адрес, указывающий на библиотеку или папку в SharePoint, содержащую ресурсы, которые требуется размещать в сети CDN.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

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

Где path находится относительный путь к папке с активами.Where path is the relative path to the folder that contains the assets. Помимо относительных путей, можно использовать подстановочные знаки.You can use wildcards in addition to relative paths.

Чтобы включить все активы в Галерею основных страниц всех сайтов как общедоступные, выполните:To include all assets in the Master Page Gallery of all sites as a public origin, execute:

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

Чтобы настроить частный источник для определенного семейства веб-сайтов, выполните следующую команду:To configure a private origin for a specific site collection, execute:

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

Примечание

После добавления источника CDN может понадобиться до 15 минут, чтобы получить файлы через службу CDN.After adding a CDN origin, it might take up to 15 minutes for you to be able to retrieve files via the CDN service. Вы можете проверить, включен ли тот или иной источник, с помощью команды spo cdn origin list.You can verify if the particular origin has already been enabled using the spo cdn origin list command.

Удаление источника CDN Office 365Remove an Office 365 CDN origin

Чтобы удалить источник CDN для указанного типа CDN, используйте команду spo cdn origin remove.Use the spo cdn origin remove command to remove a CDN origin for the specified CDN type.

Чтобы удалить общедоступный источник из конфигурации CDN, выполните:To remove a public origin from the CDN configuration, execute:

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

Примечание

Удаление происхождения CDN не влияет на файлы, хранимые в любой библиотеке документов, соответствующие этому происхождению.Removing a CDN origin doesn't affect the files stored in any document library matching that origin. Если эти активы ссылались с помощью URL-адреса SharePoint, SharePoint автоматически переключается на исходный URL-адрес, указывав на библиотеку документов.If these assets have been referenced using their SharePoint URL, SharePoint will automatically switch back to the original URL pointing to the document library. Если же ссылки на активы были указаны с помощью общедоступных URL-адресов CDN, то удаление источника перебьет ссылку, и вам потребуется вручную изменить их.If, however, assets have been referenced using a public CDN URL, then removing the origin will break the link and you will need to manually change them.

Изменение происхождения CDN Office 365Modify an Office 365 CDN origin

Изменить имеющийся источник CDN невозможно.It's not possible to modify an existing CDN origin. Вместо этого следует удалить определенный ранее источник CDN с помощью команды spo cdn origin remove и добавить новый с помощью команды spo cdn origin add.Instead, you should remove the previously defined CDN origin using the spo cdn origin remove command and add a new one using the spo cdn origin add command.

Измените типы файлов, чтобы включить их в CDN Office 365Change the types of files to include in the Office 365 CDN

По умолчанию в CDN включаются следующие типы файлов: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff и .woff2.By default, the following file types are included in the CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff and .woff2. Если требуется включить в сеть CDN дополнительные типы файлов, вы можете изменить конфигурацию CDN с помощью команды spo cdn policy set.If you need to include additional file types in the CDN, you can change the CDN configuration using the spo cdn policy set command.

Примечание

При изменении списка типов файлов перезаписывается текущий список.When changing the list of file types, you overwrite the currently defined list. Если требуется включить дополнительные типы файлов, сперва используйте команду spo cdn policy list, чтобы узнать, какие типы файлов настроены в текущий момент.If you want to include additional file types, first use the spo cdn policy list command to find out which file types are currently configured.

Чтобы добавить тип файла JSON в список типов файлов по умолчанию, включенных в общедоступный CDN, выполните:To add the JSON file type to the default list of file types included in the public CDN, execute:

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

Изменение списка классификаций сайтов, которые требуется исключить из сети CDN Office 365Change the list of site classifications you want to exclude from the Office 365 CDN

Чтобы исключить классификации сайтов, которые не должны быть доступны в сети CDN, используйте команду spo cdn policy set.Use the spo cdn policy set command to exclude site classifications that you do not want to make available over the CDN. По умолчанию не исключаются никакие классификации сайтов.By default, no site classifications are excluded.

Примечание

При изменении списка исключаемых классификаций сайтов перезаписывается текущий список.When changing the list of excluded site classifications, you overwrite the currently defined list. Если требуется исключить дополнительные классификации сайтов, сперва используйте команду spo cdn policy list, чтобы узнать, какие классификации настроены в текущий момент.If you want to exclude additional classifications, first use the spo cdn policy list command to find out which classifications are currently configured.

Чтобы исключить сайты, классифицируются как HBI из общедоступных CDN, выполнитеTo exclude sites classified as HBI from the public CDN, execute

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

Отключение CDN Office 365Disable the Office 365 CDN

Чтобы отключить сеть CDN Office 365, используйте команду spo cdn set. Пример:To disable the Office 365 CDN use the spo cdn set command, for example:

spo cdn set --type Public --enabled false

Использование ресурсов CDNUsing your CDN assets

Теперь, когда вы включили CDN и настроенные истоки и политики, можно приступить к использованию ресурсов CDN.Now that you have enabled the CDN and configured origins and policies, you can begin using your CDN assets.

Этот раздел поможет вам понять, как использовать URL-адреса CDN на страницах и контенте SharePoint, чтобы SharePoint перенаправляла запросы на активы как государственного, так и частного происхождения в CDN.This section will help you understand how to use CDN URLs in your SharePoint pages and content so that SharePoint redirects requests for assets in both public and private origins to the CDN.

Сведения об использовании CDN для размещения клиентских веб-частей см. в разделе Host your client-side web part from Office 365 CDN (Hello World part 4).For information on how to use the CDN for hosting client-side web parts, see the topic Host your client-side web part from Office 365 CDN (Hello World part 4).

Примечание

Если вы добавим папку ClientSideAssets в частный список истоков CDN, пользовательские веб-части, на которые будет организовано CDN, не будут отрисовки.If you add the ClientSideAssets folder to the private CDN origins list, CDN-hosted custom web parts will fail to render. Файлы, используемые веб-частями SPFX, могут использовать только общедоступные CDN, а папка ClientSideAssets является по умолчанию для общедоступных CDN.Files used by SPFX web parts can only utilize the public CDN and the ClientSideAssets folder is a default origin for public CDN.

Чтобы использовать добавленные в источник ресурсы, просто обновив ссылки на исходный файл с помощью пути к файлу в начале.To use assets that you have added to an origin, you simply update links to the original file with the path to the file in the origin.

  • Изменить страницу или контент, содержащий ссылки на активы, добавленные в источник.Edit the page or content that contains links to assets you have added to an origin. Вы также можете использовать один из нескольких методов глобального поиска и замены ссылок на веб-сайт или коллекцию сайтов, если вы хотите обновить ссылку на данный актив везде, где он появится.You can also use one of several methods to globally search and replace links across an enter site or site collection if you want to update the link to a given asset everywhere it appears.
  • Для каждой ссылки на актив в источнике замените путь путем к файлу в происхождении CDN.For each link to an asset in an origin, replace the path with the path to the file in the CDN origin. Можно использовать относительные пути.You can use relative paths.
  • Сохранение страницы или контента.Save the page or content.

Например, рассмотрим изображение /site/SiteAssets/images/image.png, которое вы скопировали в папку библиотеки документов /site/CDN_origins/public/.For example, consider the image /site/SiteAssets/images/image.png, which you have copied to the document library folder /site/CDN_origins/public/. Чтобы использовать актив CDN, замените исходный путь к расположению файла изображений путем к источнику, чтобы сделать новый URL-адрес /site/CDN_origins/public/image.png.To use the CDN asset, replace the original path to the image file location with the path to the origin to make the new URL /site/CDN_origins/public/image.png.

Если вы хотите использовать полный URL-адрес актива вместо относительного пути, сострой ссылку так:If you want to use the full URL to the asset instead of a relative path, construct the link like so:

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

Примечание

В общем, не следует жестко кодировать URL-адреса непосредственно к активам в CDN.In general, you should not hardcode URLs directly to assets in the CDN. Однако при необходимости можно вручную создавать URL-адреса для активов в общедоступных источниках.However, you can manually construct URLs for assets in public origins if needed. Дополнительные сведения см. в выпуске Url-адресов CDN hardcoding для общедоступных активов.For more information, see Hardcoding CDN URLs for public assets.

Чтобы узнать о том, как убедиться в том, что ресурсы обслуживаются из CDN, см. в руб. Как подтвердить, что ресурсы обслуживаются cdN? в деле устранения неполадок cdN Office 365.To learn about how to verify that assets are being served from the CDN, see How do I confirm that assets are being served by the CDN? in Troubleshooting the Office 365 CDN.

Использование ресурсов в общедоступных источникахUsing assets in public origins

Функция публикации в SharePoint Online автоматически переписывала URL-адреса активов, хранимых в общедоступных источниках, в их эквиваленты CDN, чтобы активы обслуживались из службы CDN вместо SharePoint.The Publishing feature in SharePoint Online automatically rewrites URLs of assets stored in public origins to their CDN equivalents so that assets are served from the CDN service instead of SharePoint.

Если ваше происхождение находится на сайте с включенной функцией Публикации, а активы, которые необходимо разгрузить в CDN, находятся в одной из следующих категорий, SharePoint автоматически переписывание URL-адресов для активов в происхождении при условии, что актив не был исключен политикой CDN.If your origin is in a site with the Publishing feature enabled, and the assets you want to offload to the CDN are in one of the following categories, SharePoint will automatically rewrite URLs for assets in the origin, provided that the asset has not been excluded by a CDN policy.

Ниже представлен обзор ссылок, которые автоматически заменяет функция публикации в SharePoint.The following is an overview of which links are automatically rewritten by the SharePoint Publishing feature:

  • URL-адреса IMG-, LINK- и CSS-файлов в HTML-откликах классической страницы публикации.IMG/LINK/CSS URLs in classic publishing page HTML responses
    • Это относится и к изображениям, добавленным авторами в HTML-содержимом страницы.This includes images added by authors within the HTML content of a page
  • URL-адреса изображений в веб-части "Слайд-шоу библиотеки рисунков".Picture Library SlideShow webpart image URLs
  • Поля изображений в результатах работы REST API SPList (RenderListDataAsStream).Image fields in SPList REST API (RenderListDataAsStream) results
    • Используйте новое свойство ImageFieldsToTryRewriteToCdnUrls для предоставления разделенного запятой списка полейUse the new property ImageFieldsToTryRewriteToCdnUrls to provide a comma separated list of fields
    • Поддерживает поля гиперссылки и поля PublishingImageSupports hyperlink fields and PublishingImage fields
  • Renditions изображений SharePointSharePoint image renditions

Следующая схема иллюстрирует рабочий процесс, когда SharePoint получает запрос на страницу, содержащую активы из общего происхождения.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a public origin.

Схема рабочего процесса: ирисовка активов CDN Office 365 из общего происхожденияWorkflow diagram: Retrieving Office 365 CDN assets from a public origin

Совет

Если вы хотите отключить автоматическое переписывание определенных URL-адресов на странице, вы можете проверить страницу и добавить параметр строки запроса? NoAutoReWrites=true в конце каждой ссылки, отключаемой.If you want to disable auto-rewriting for specific URLs on a page, you can check out the page and add the query string parameter ?NoAutoReWrites=true to the end of each link you want to disable.

Создание URL-адресов CDN для общедоступных активовConstructing CDN URLs for public assets

Если функция Публикации не включена для общего происхождения или актив не является одним из типов ссылок, поддерживаемых функцией автоматического перезаписи службы CDN, можно вручную создать URL-адреса для расположения ресурсов CDN и использовать эти URL-адреса в контенте.If the Publishing feature is not enabled for a public origin, or the asset is not one of the link types supported by the auto-rewrite feature of the CDN service, you can manually construct URLs to the CDN location of the assets and use these URLs in your content.

Примечание

Нельзя жестко кодировать или создавать URL-адреса CDN для активов частного происхождения, так как необходимый маркер доступа, формирующий последний раздел URL-адреса, создается во время запроса ресурса.You cannot hardcode or construct CDN URLs to assets in a private origin because the required access token that forms the last section of the URL is generated at the time the resource is requested. Вы можете создать URL-адрес для общедоступных CDN, и URL-адрес не должен быть жестко закодироваться, так как он подлежит изменению.You can construct the URL for Public CDN and the URL should not be hard coded as it is subject to change.

Для общедоступных ресурсов CDN формат URL-адресов будет выглядеть следующим образом:For public CDN assets, the URL format will look like the following:

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

Замените TenantHostName именем клиента.Replace TenantHostName with your tenant name. Пример.Example:

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

Примечание

Свойство контекста страницы должно использоваться для построения префикса вместо жесткого кодирования https://publiccdn.sharepointonline.com ".The page context property should be used to construct the prefix instead of hard coding "https://publiccdn.sharepointonline.com". URL-адрес подлежит изменению и не должен быть жестко закодироваться.The URL is subject to change and should not be hard coded. Если вы используете шаблоны отображения с помощью Classic SharePoint Online, вы можете использовать свойство "window._spPageContextInfo.publicCdnBaseUrl" в шаблоне отображения для префикса URL-адреса.If you are using display templates with Classic SharePoint Online then you can use the property "window._spPageContextInfo.publicCdnBaseUrl" in your display template for the prefix of the URL. Если вы являетсяе веб-частями SPFx для современной и классической SharePoint, вы можете использовать свойство this.context.pageContext.legacyPageContext.publicCdnBaseUrl" (this.context.pageContext.legacyPageContext.publicCdnBaseUrl).If you are SPFx web parts for modern and classic SharePoint the you can utilize the property "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". При этом будет предоставляться префикс, чтобы если он был изменен, то реализация обновляется вместе с ним.This will provide the prefix so that if it is changed then your implementation will update with it. В качестве примера для SPFx URL-адрес можно построить с помощью свойства "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "relativeURL для элемента".As an example for SPFx, the URL can be constructed using the property "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL for the item". См. в тексте Использование CDN в клиентском коде, который является частью серии производительности 1 сезонаPlease see Using CDN in Client-side code which is part of the season 1 performance series

Использование активов в частном происхожденииUsing assets in private origins

Для использования активов в частном происхождении не требуется дополнительная конфигурация.No additional configuration is required to use assets in private origins. SharePoint Online автоматически переписывал URL-адреса для активов частного происхождения, поэтому запросы на эти активы всегда будут подаваться из CDN.SharePoint Online automatically rewrites URLs for assets in private origins so requests for those assets will always be served from the CDN. Невозможно вручную создавать URL-адреса для активов CDN в частном происхождении, так как эти URL-адреса содержат маркеры, которые должны быть автоматически созданы SharePoint Online во время запроса актива.You cannot manually build URLs to CDN assets in private origins because these URLs contain tokens that must be auto-generated by SharePoint Online at the time the asset is requested.

Доступ к активам частного происхождения защищен динамически созданными маркерами на основе разрешений пользователей на происхождение с оговорками, описанными в следующих разделах.Access to assets in private origins is protected by dynamically generated tokens based on user permissions to the origin, with the caveats described in the following sections. Пользователи должны иметь по крайней мере доступ к истокам для отображения контента cdN.Users must have at least read access to the origins for the CDN to render content.

Следующая схема иллюстрирует рабочий процесс, когда SharePoint получает запрос на страницу, содержащую активы частного происхождения.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a private origin.

Схема рабочего процесса: ирисовка активов CDN Office 365 из частного происхожденияWorkflow diagram: Retrieving Office 365 CDN assets from a private origin

Авторизация на основе маркеров в частном происхожденииToken-based authorization in private origins

Доступ к активам частного происхождения в CDN Office 365 предоставляется маркерами, созданными SharePoint Online.Access to assets in private origins in the Office 365 CDN is granted by tokens generated by SharePoint Online. Пользователям, у которых уже есть разрешение на доступ к папке или библиотеке, назначенной происхождением, автоматически выдают маркеры, которые позволяют пользователю получать доступ к файлу на основе уровня разрешений.Users who already have permission to access to the folder or library designated by the origin are automatically granted tokens that permit the user to access the file based on their permission level. Эти маркеры доступа действительны в течение 30-90 минут после их получения, чтобы предотвратить атаки повтора маркеров.These access tokens are valid for 30 to 90 minutes after they are generated to help prevent token replay attacks.

После получения маркера доступа SharePoint Online возвращает клиенту настраиваемый URI, содержащий два параметра авторизации (маркер авторизации края) и овсяный (маркер авторизации происхождения).Once the access token is generated, SharePoint Online returns a custom URI to the client containing two authorization parameters eat (edge authorization token) and oat (origin authorization token). Структура каждого маркера —< времени действия в формате времени эпохи >__<'secure signature'>.The structure of each token is <'expiration time in Epoch time format'>__<'secure signature'>. Например,For example:

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

Примечание

Любой, кто владеет маркером, может получить доступ к ресурсу cdN.Anyone in possession of the token can access the resource in the CDN. Однако URL-адреса, содержащие эти маркеры доступа, делятся только по HTTPS, поэтому если URL-адрес явно не будет доступен конечному пользователю до истечения срока действия маркера, актив будет недоступен для неавторизованных пользователей.However, URLs containing these access tokens are only shared over HTTPS, so unless the URL is explicitly shared by an end user before the token expires, the asset won't be accessible to unauthorized users.

Разрешения на уровне элементов не поддерживаются для активов в частном происхожденииItem-level permissions are not supported for assets in private origins

Важно отметить, что SharePoint Online не поддерживает разрешения на уровне элементов для активов частного происхождения.It is important to note that SharePoint Online does not support item-level permissions for assets in private origins. Например, для файла, расположенного по адресу, пользователи имеют эффективный доступ к файлу с учетом https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg следующих условий:For example, for a file located at https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg, users have effective access to the file given the following conditions:

UserUser РазрешенияPermissions Эффективный доступEffective access
Пользователь 1User 1 Имеет доступ к папке1Has access to folder1 Доступ к image1.jpg из CDNCan access image1.jpg from the CDN
Пользователь 2User 2 Не имеет доступа к папке1Does not have access to folder1 Не удается image1.jpg из CDNCannot access image1.jpg from the CDN
Пользователь 3User 3 Не имеет доступа к папке1, но имеет явное разрешение на доступ к image1.jpg в SharePoint OnlineDoes not have access to folder1, but is granted explicit permission to access image1.jpg in SharePoint Online Можно получить доступ к image1.jpg непосредственно из SharePoint Online, но не из CDNCan access the asset image1.jpg directly from SharePoint Online, but not from the CDN
Пользователь 4User 4 Имеет доступ к папке1, но ему явно было отказано в доступе к image1.jpg SharePoint OnlineHas access to folder1, but has been explicitly denied access to image1.jpg in SharePoint Online Не удается получить доступ к активу из SharePoint Online, но может получить доступ к активу из CDN, несмотря на то, что ему было отказано в доступе к файлу в SharePoint OnlineCannot access the asset from SharePoint Online, but can access the asset from the CDN despite being denied access to the file in SharePoint Online

Устранение неполадок cdN Office 365Troubleshooting the Office 365 CDN

Как подтвердить, что ресурсы обслуживаются cdN?How do I confirm that assets are being served by the CDN?

После того как вы добавили ссылки на ресурсы CDN на страницу, вы можете подтвердить, что актив обслуживается из CDN, просматривая страницу, щелкнув правой кнопкой мыши по изображению после отрисовки и просмотрев URL-адрес изображения.Once you have added links to CDN assets to a page, you can confirm that the asset is being served from the CDN by browsing to the page, right clicking on the image once it has rendered and reviewing the image URL.

Вы также можете использовать средства разработчика браузера для просмотра URL-адреса для каждого актива на странице или с помощью средства трассировки сторонних сетей.You can also use your browser's developer tools to view the URL for each asset on a page, or use a third party network trace tool.

Примечание

Если вы используете сетевой инструмент, например Fiddler, чтобы протестировать свои активы вне отрисовки актива со страницы SharePoint, необходимо вручную добавить загонщика ссылок "Referer:" в запрос GET, где URL-адрес является корневым URL-адресом клиента https://yourdomain.sharepoint.com SharePoint Online.If you use a network tool such as Fiddler to test your assets outside of rendering the asset from a SharePoint page, you must manually add the referer header "Referer: https://yourdomain.sharepoint.com" to the GET request where the URL is the root URL of your SharePoint Online tenant.

Невозможно протестировать URL-адреса CDN непосредственно в веб-браузере, так как должен быть ссылщик из SharePoint Online.You cannot test CDN URLs directly in a web browser because you must have a referer coming from SharePoint Online. Однако если добавить URL-адрес актива CDN на страницу SharePoint, а затем открыть страницу в браузере, на странице будет отрисован актив CDN.However, if you add the CDN asset URL to a SharePoint page and then open the page in a browser, you will see the CDN asset rendered on the page.

Дополнительные сведения об использовании средств разработчика в браузере Microsoft Edge см. в веб-сайте Microsoft Edge Developer Tools.For more information on using the developer tools in the Microsoft Edge browser, see Microsoft Edge Developer Tools.

Чтобы просмотреть короткое видео, размещенное на youTube-канале Шаблоны и практики разработчика SharePoint, демонстрирующее, как убедиться, что ваш CDN работает, см. в раздел Проверка использования CDNи обеспечение оптимального подключения к сети.To watch a short video hosted in the SharePoint Developer Patterns and Practices YouTube channel demonstrating how to verify that your CDN is working, please see Verifying your CDN usage and ensuring optimal network connectivity.

Почему недоступны активы нового происхождения?Why are assets from a new origin unavailable?

Активы нового происхождения не будут сразу доступны для использования, так как для регистрации требуется время для распространения через CDN и для отправки активов из происхождения в хранилище CDN.Assets in new origins will not immediately be available for use, as it takes time for the registration to propagate through the CDN and for the assets to be uploaded from the origin to CDN storage. Время, необходимое для того, чтобы активы были доступны в CDN, зависит от того, сколько ресурсов и размеров файлов.The time required for assets to be available in the CDN depends on how many assets and the files sizes.

Моя клиентская веб-часть или решение SharePoint Framework не работаютMy client-side web part or SharePoint Framework solution isn't working

Когда вы включаете CDN Office 365 для общедоступных истоков, служба CDN автоматически создает эти истоки по умолчанию:When you enable the Office 365 CDN for public origins, the CDN service automatically creates these default origins:

  • */MASTERPAGE*/MASTERPAGE
  • */STYLE LIBRARY*/STYLE LIBRARY
  • */CLIENTSIDEASSETS*/CLIENTSIDEASSETS

Если происхождение */clientsideassets отсутствует, решения SharePoint Framework сбой, и не создаются предупреждения или сообщения об ошибке.If the */clientsideassets origin is missing, SharePoint Framework solutions will fail, and no warning or error messages are generated. Это происхождение может быть пропущено либо из-за включения CDN с параметром -NoDefaultOrigins, заданным $true, либо потому, что происхождение было удалено вручную. This origin may be missing either because the CDN was enabled with the -NoDefaultOrigins parameter set to $true, or because the origin was manually deleted.

Вы можете проверить, какие истоки присутствуют со следующей командой PowerShell:You can check to see which origins are present with the following PowerShell command:

Get-SPOTenantCdnOrigins -CdnType Public

Или вы можете проверить cLI Office 365:Or you can check with the Office 365 CLI:

spo cdn origin list

Чтобы добавить начало в PowerShell:To add the origin in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Чтобы добавить источник в CLI Office 365:To add the origin in the Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Какие модули PowerShell и оболочки CLI необходимы для работы с CDN Office 365?What PowerShell modules and CLI shells do I need to work with the Office 365 CDN?

Вы можете работать с CDN Office 365 с помощью модуля PowerShell командной оболочки SharePoint Online или CLI Office 365.You can choose to work with the Office 365 CDN using either the SharePoint Online Management Shell PowerShell module or the Office 365 CLI.

См. такжеSee also

Сети доставки содержимогоContent Delivery Networks

Планирование сети и настройка производительности для Office 365Network planning and performance tuning for Office 365

Серия производительности SharePoint — видеосерия CDN Office 365SharePoint Performance Series - Office 365 CDN video series