Utilisation du réseau de distribution de contenu Office 365 avec SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online

Vous pouvez utiliser le réseau de distribution de contenu Office 365 intégré pour héberger des ressources statiques afin d’améliorer les performances de vos pages 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. Le réseau de distribution de contenu Office 365 améliore les performances en procédant à la mise en cache des ressources statiques au plus près des navigateurs qui les demandent, ce qui permet d’accélérer les téléchargements et de réduire la latence.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. En outre, le Office 365 CDN utilise le protocole HTTP/2 pour améliorer la compression et le pipelining HTTP.Also, the Office 365 CDN uses the HTTP/2 protocol for improved compression and HTTP pipelining. Le réseau de distribution de contenu Office 365 est inclus dans votre abonnement SharePoint Online.The Office 365 CDN service is included as part of your SharePoint Online subscription.

Notes

Le Office 365 CDN est uniquement disponible pour les clients dans le cloud de production (dans le monde).The Office 365 CDN is only available to tenants in the Production (worldwide) cloud. Les locataires du gouvernement des États-Unis, de la Chine et de l’Allemagne ne sont actuellement pas en charge Office 365 CDN.Tenants in the US Government, China and Germany clouds do not currently support the Office 365 CDN.

Le réseau de distribution de contenu Office 365 est composé de plusieurs réseaux de distribution de contenu qui vous permettent d’héberger des ressources statiques à différents emplacements (ou origines) et de les servir à partir de réseaux à haut débit mondiaux.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. Selon le type de contenu que vous souhaitez héberger sur le réseau de distribution de contenu Office 365, vous pouvez ajouter des origines publiques, privées ou les deux.Depending on the kind of content you want to host in the Office 365 CDN, you can add public origins, private origins or both. Pour plus d’informations sur la différence entre les origines publique et privée, voir Choisir si chaque origine doit être publique ou privée.See Choose whether each origin should be public or private for more information on the difference between public and private origins.

Office 365 CDN diagramme conceptuelOffice 365 CDN conceptual diagram

Si vous connaissez déjà le mode de travail des CDN, vous ne devez effectuer que quelques étapes pour activer le Office 365 CDN pour votre client.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. Cette rubrique décrit comment.This topic describes how. Lisez la suite pour savoir comment commencer à héberger vos ressources statiques.Read on for information about how to get started hosting your static assets.

Conseil

Il existe d’autres CDN hébergés par Microsoft qui peuvent être utilisés avec Office 365 pour des scénarios d’utilisation spécialisés, mais qui ne sont pas abordés dans cette rubrique, car ils n’entrent pas dans le cadre du Office 365 CDN.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. Pour plus d’informations, voir autres CDN Microsoft.For more information, see Other Microsoft CDNs.

Revenir à la planification réseau et au réglagedes performances pour Office 365 .Head back to Network planning and performance tuning for Office 365.

Vue d’ensemble de l’utilisation Office 365 CDN dans SharePoint OnlineOverview of working with the Office 365 CDN in SharePoint Online

Pour configurer les Office 365 CDN pour votre organisation, suivez les étapes de base suivantes :To set up the Office 365 CDN for your organization, you follow these basic steps:

Une fois l’installation terminée, vous pouvez gérer les Office 365 CDN au fil du temps en :Once you're done with setup, you can Manage the Office 365 CDN over time by:

  • Ajout, mise à jour et suppression d’élémentsAdding, updating, and removing assets
  • Ajout et suppression d’originesAdding and removing origins
  • Configuration des stratégies CDN de sécuritéConfiguring CDN policies
  • Si nécessaire, désactivez le CDNIf necessary, disabling the CDN

Enfin, voir Utiliser vos ressources CDN pour en savoir plus sur l’accès à vos ressources CDN à partir d’origines publiques et privées.Finally, see Using your CDN assets to learn about accessing your CDN assets from both public and private origins.

Voir Résolution des problèmes Office 365 CDN pour obtenir des conseils sur la résolution des problèmes courants.See Troubleshooting the Office 365 CDN for guidance on resolving common issues.

Planifier le déploiement du Office 365 CDNPlan for deployment of the Office 365 CDN

Avant de déployer le Office 365 CDN pour votre client Office 365, vous devez prendre en compte les facteurs suivants dans le cadre de votre processus de planification.Before you deploy the Office 365 CDN for your Office 365 tenant, you should consider the following factors as part of your planning process.

Déterminez les ressources statiques que vous souhaitez héberger sur le CDNDetermine which static assets you want to host on the CDN

En règle générale, les CDN sont plus efficaces pour héberger des ressources statiques ou des ressources qui ne changent pas très souvent.In general, CDNs are most effective for hosting static assets, or assets that don't change very often. Une bonne règle de base consiste à identifier les fichiers qui répondent à une partie ou à l’ensemble de ces conditions :A good rule of thumb is to identify files that meet some or all of these conditions:

  • Fichiers statiques incorporés dans une page (tels que des scripts et des images) qui peuvent avoir un impact incrémentielle significatif sur les temps de chargement des pagesStatic files embedded in a page (like scripts and images) that may have a significant incremental impact on page load times
  • Fichiers de grande taille tels que les fichiers exécutables et d’installationLarge files like executables and installation files
  • Bibliothèques de ressources qui la prise en charge du code côté clientResource libraries that support client-side code

Par exemple, les petits fichiers qui sont demandés à plusieurs reprises comme des images de site et des scripts peuvent améliorer considérablement les performances de rendu du site et réduire de manière incrémentielle la charge sur vos sites SharePoint Online lorsque vous les ajoutez à une origine 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. Les fichiers plus volumineux tels que les fichiers exécutables d’installation peuvent être téléchargés à partir du CDN, ce qui a un impact positif sur les performances et réduit la charge sur votre site SharePoint Online, même s’ils ne sont pas accessibles aussi souvent.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.

L’amélioration des performances par fichier dépend de nombreux facteurs, notamment la proximité du client avec le point de terminaison CDN le plus proche, les conditions temporaires sur le réseau local, etc.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. De nombreux fichiers statiques sont relativement petits et peuvent être téléchargés à partir Office 365 en moins d’une seconde.Many static files are quite small, and can be downloaded from Office 365 in less than a second. Toutefois, une page web peut contenir de nombreux fichiers incorporés avec un temps de téléchargement cumulé de plusieurs secondes.However, a web page may contain many embedded files with a cumulative download time of several seconds. Le fait de servir ces fichiers à partir CDN réduire considérablement le temps de chargement global de la page.Serving these files from the CDN can significantly reduce the overall page load time. Voir quels gains de performances un CDN fournir ? pour obtenir un exemple.See What performance gains does a CDN provide? for an example.

Déterminer l’endroit où vous souhaitez stocker vos biensDetermine where you want to store your assets

Le CDN récupère vos biens à partir d’un emplacement appelé origine.The CDN fetches your assets from a location called an origin. Une origine peut être un site SharePoint, une bibliothèque de documents ou un dossier accessible par une URL.An origin can be a SharePoint site, document library or folder that is accessible by a URL. Vous avez une grande flexibilité lorsque vous spécifiez des origines pour votre organisation.You have great flexibility when you specify origins for your organization. Par exemple, vous pouvez spécifier plusieurs origines ou une origine unique où vous souhaitez placer toutes vos ressources CDN ressources.For example, you can specify multiple origins or a single origin where you want to put all your CDN assets. Vous pouvez choisir d’avoir des origines publiques ou privées pour votre organisation.You can choose to have both public or private origins for your organization. La plupart des organisations choisiront d’implémenter une combinaison des deux.Most organizations will choose to implement a combination of the two.

Vous pouvez créer un conteneur pour vos origines, telles que des dossiers ou des bibliothèques de documents, et ajouter des fichiers que vous souhaitez rendre disponibles à partir du 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. Il s’agit d’une bonne approche si vous avez un ensemble spécifique de ressources que vous souhaitez être disponible à partir du CDN et que vous souhaitez limiter l’ensemble de ressources CDN uniquement à ces fichiers dans le conteneur.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.

Vous pouvez également configurer une collection de sites, un site, une bibliothèque ou un dossier existant en tant qu’origine, ce qui rend tous les biens éligibles dans le conteneur disponibles à partir du 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. Avant d’ajouter un conteneur existant en tant qu’origine, il est important de vous assurer de connaître son contenu et ses autorisations afin de ne pas exposer par inadvertance des biens à un accès anonyme ou à des utilisateurs non autorisés.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.

Vous pouvez définir des stratégies CDN pour exclure le contenu de vos origines du CDN.You can define CDN policies to exclude content in your origins from the CDN. CDN excluent les biens des origines publiques ou privées par des attributs tels que le type de fichier et la classification de site et sont appliquées à toutes les origines du CdnType (privé ou public) que vous spécifiez dans la stratégie.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. Par exemple, si vous ajoutez une origine privée constituée d’un site qui contient plusieurs sous-sites, vous pouvez définir une stratégie pour exclure les sites marqués comme confidentiels afin que le contenu des sites avec cette classification appliquée ne soit pas servi à partir du 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. La stratégie s’applique au contenu de toutes les origines privées que vous avez ajoutées au CDN.The policy will apply to content from all private origins you have added to the CDN.

N’oubliez pas que plus le nombre d’origines est élevé, plus l’impact sur le temps qu’il faut au service CDN pour traiter les demandes est important.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. Nous vous recommandons de limiter autant que possible le nombre d’origines.We recommend that you limit the number of origins as much as possible.

Choisir si chaque origine doit être publique ou privéeChoose whether each origin should be public or private

Lorsque vous identifiez une origine, vous spécifiez si elle doit être rendue publique ou privée.When you identify an origin, you specify whether it should be made public or private. L’accès CDN ressources d’origines publiques est anonyme et CDN contenu des origines privées est sécurisé par des jetons générés dynamiquement pour une sécurité accrue.Access to CDN assets in public origins is anonymous, and CDN content in private origins is secured by dynamically generated tokens for greater security. Quelle que soit l’option que vous choisissez, Microsoft s’charge de toutes les opérations importantes pour vous en ce qui concerne l’administration du CDN lui-même.Regardless of which option you choose, Microsoft does all the heavy lifting for you when it comes to administration of the CDN itself. En outre, vous pouvez changer d’avis ultérieurement, après avoir CDN et identifié vos origines.Also, you can change your mind later, after you've set up the CDN and identified your origins.

Les options publiques et privées offrent des gains de performances similaires, mais chacune possède des attributs et des avantages uniques.Both public and private options provide similar performance gains, but each has unique attributes and advantages.

Les origines publiques au sein Office 365 CDN sont accessibles de manière anonyme et les ressources hébergées sont accessibles par toute personne ayant l’URL de la bien.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. Comme l’accès au contenu des origines publiques est anonyme, vous ne devez l’utiliser que pour mettre en cache du contenu générique non sensible, comme des scripts, des icônes, des images et des fichiers 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.

Les origines privées au sein Office 365 CDN fournissent un accès privé au contenu utilisateur, tel que SharePoint bibliothèques de documents, sites et images propriétaires en ligne.Private origins within the Office 365 CDN provide private access to user content such as SharePoint Online document libraries, sites and proprietary images. L’accès au contenu dans les origines privées est sécurisé par des jetons générés dynamiquement afin que seuls les utilisateurs ayant des autorisations d’accès à la bibliothèque de documents ou à l’emplacement de stockage d’origine y accèdent.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. Les origines privées dans le Office 365 CDN ne peuvent être utilisées que pour le contenu SharePoint Online, et vous pouvez uniquement accéder aux ressources des origines privées via la redirection à partir de votre client 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.

Vous pouvez en savoir plus sur CDN’accès aux biens d’une origine privée fonctionne dans Utilisation de biens dans les origines privées.You can read more about how CDN access to assets in a private origin works in Using assets in private origins.

Attributs et avantages de l’hébergement de biens dans les origines publiquesAttributes and advantages of hosting assets in public origins

  • Les ressources exposées dans une origine publique sont accessibles par tout le monde de manière anonyme.Assets exposed in a public origin are accessible by everyone anonymously.

    Important

    Vous ne devez jamais placer dans une origine publique des ressources qui contiennent des informations utilisateur ou qui sont considérées comme sensibles à votre organisation.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

  • Si vous supprimez une ressource d’une origine publique, celle-ci reste disponible pendant un maximum de 30 jours à partir du cache. Cependant, nous rendons les liens vers la ressource dans le CDN non valides dans les 15 minutes.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.

  • Lorsque vous hébergez des feuilles de style (fichiers CSS) depuis une origine publique, vous pouvez utiliser les URI et les chemins d’accès relatifs dans le code.When you host style sheets (CSS files) in a public origin, you can use relative paths and URIs within the code. Cela signifie que vous pouvez faire référence à l’emplacement d’images d’arrière-plan et d’autres objets de manière relative, par rapport à l’emplacement de la ressource qui les appelle.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.

  • Bien que vous pouvez construire l’URL d’une origine publique, vous devez continuer avec précaution et vous assurer d’utiliser la propriété de contexte de page et de suivre les instructions pour ce faire.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. En effet, si l’accès au CDN devient indisponible, l’URL ne renverra pas automatiquement à votre organisation dans SharePoint Online, ce qui pourrait générer des liens défectueux et d’autres erreurs.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. L’URL est également sujette à modification, c’est pourquoi elle ne doit pas simplement être codée en dur à sa valeur actuelle.The URL is also subject to change which is why it should not just be hard coded to its current value.

  • Les types de fichiers par défaut inclus pour les origines publiques sont .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff et .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. Vous pouvez spécifier des types de fichiers supplémentaires.You can specify additional file types.

  • Vous pouvez configurer une stratégie pour exclure les biens qui ont été identifiés par les classifications de site que vous spécifiez.You can configure a policy to exclude assets that have been identified by site classifications that you specify. Par exemple, vous pouvez choisir d’exclure toutes les ressources marquées comme « confidentiel » ou « accès réservé », même s’il s’agit d’un type de fichier autorisé et qu’elles ont une origine publique.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.

Attributs et avantages de l’hébergement de biens dans des origines privéesAttributes and advantages of hosting assets in private origins

  • Les origines privées ne peuvent être utilisées que pour SharePoint en ligne.Private origins can only be used for SharePoint Online assets.

  • Les utilisateurs ne peuvent accéder aux biens qu’à partir d’une origine privée s’ils sont autorisés à accéder au conteneur.Users can only access the assets from a private origin if they have permissions to access the container. Vous êtes protégé contre l’accès anonyme à ces ressources.Anonymous access to these assets is prevented.

  • Les biens d’origine privée doivent être référents à partir du client SharePoint Online.Assets in private origins must be referred from the SharePoint Online tenant. L’accès direct aux ressources CDN privées ne fonctionne pas.Direct access to private CDN assets does not work.

  • Si vous supprimez un bien de l’origine privée, il se peut qu’il reste disponible jusqu’à une heure à partir du cache . toutefois, nous invalidons les liens vers la CDN dans les 15 minutes suivant sa suppression.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.

  • Les types de fichier par défaut inclus pour les origines privées sont les suivants : .gif, .ico, .jpeg, .jpg, .js et .png.The default file types that are included for private origins are .gif, .ico, .jpeg, .jpg, .js, and .png. Vous pouvez spécifier des types de fichiers supplémentaires.You can specify additional file types.

  • Comme pour les origines publiques, vous pouvez configurer une stratégie pour exclure les biens qui ont été identifiés par des classifications de site que vous spécifiez, même si vous utilisez des caractères génériques pour inclure tous les biens dans un dossier ou une bibliothèque de documents.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.

Pour plus d’informations sur l’utilisation des concepts de Office 365 CDN, de CDN général et d’autres CDN Microsoft que vous pouvez utiliser avec votre client Office 365, voir Réseaux de distribution de contenu.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.

Origines CDN par défautDefault CDN origins

Sauf indication contraire, Office 365 définit des origines par défaut lorsque vous activez l’Office 365 CDN.Unless you specify otherwise, Office 365 sets up some default origins for you when you enable the Office 365 CDN. Si vous décidez initialement de ne pas les configurer, vous pouvez ajouter ces origines une fois l’installation terminée.If you initially opt not to provision them, you can add these origins after you complete setup. Sauf si vous comprenez les conséquences de l’ignorer de la configuration des origines par défaut et que vous en avez une raison spécifique, vous devez autoriser leur création lorsque vous activez l’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.

Origines des CDN privées par défaut :Default private CDN origins:

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

Origines des CDN public par défaut :Default public CDN origins:

  • */masterpage*/masterpage
  • */style library*/style library
  • */clientsideassets*/clientsideassets

Notes

clientsideassets est une origine publique par défaut qui a été ajoutée au service Office 365 CDN en décembre 2017.clientsideassets is a default public origin that was added to the Office 365 CDN service in December 2017. Cette origine doit être présente pour que les solutions SharePoint Framework dans le CDN fonctionnent.This origin must be present in order for SharePoint Framework solutions in the CDN to work. Si vous avez activé le Office 365 CDN avant décembre 2017, ou si vous avez ignoré la configuration des origines par défaut lorsque vous avez activé le CDN, vous pouvez ajouter manuellement cette origine.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. Pour plus d’informations, voir Mon part Web Part côté client ou SharePoint Framework solution ne fonctionne pas.For more information, see My client-side web part or SharePoint Framework solution isn't working.

Configurer l’Office 365 CDN à l’aide de SharePoint Online Management ShellSet up and configure the Office 365 CDN by using the SharePoint Online Management Shell

Les procédures de cette section nécessitent l’utilisation de SharePoint Online Management Shell pour vous connecter à SharePoint Online.The procedures in this section require you to use the SharePoint Online Management Shell to connect to SharePoint Online. Pour plus d’informations, voir Connect to SharePoint Online PowerShell.For instructions, see Connect to SharePoint Online PowerShell.

Pour configurer et configurer le CDN pour héberger vos ressources dans SharePoint Online à l’aide de SharePoint Online Management Shell, effectuer ces étapes.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the SharePoint Online Management Shell.

Cliquez pour développerClick to expand

Permettre à votre organisation d’utiliser le Office 365 CDNEnable your organization to use the Office 365 CDN

Avant d’apporter des modifications aux paramètres de CDN client, vous devez récupérer l’état actuel de la configuration CDN privée dans votre client Office 365 client.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. Connecter à votre client à l’aide de SharePoint Online Management Shell :Connect to your tenant using the SharePoint Online Management Shell:

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

À présent, utilisez la cmdlet Get-SPOTenantCdnEnabled pour récupérer les paramètres CDN’état du client :Now use the Get-SPOTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

L’état du CDN pour le CdnType spécifié est produit à l’écran.The status of the CDN for the specified CdnType will output to the screen.

Utilisez la cmdlet Set-SPOTenantCdnEnabled pour permettre à votre organisation d’utiliser le Office 365 CDN.Use the Set-SPOTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Vous pouvez permettre à votre organisation d’utiliser des origines publiques, des origines privées ou les deux à la fois.You can enable your organization to use public origins, private origins, or both at once. Vous pouvez également configurer le CDN pour ignorer la configuration des origines par défaut lorsque vous l’activez.You can also configure the CDN to skip the setup of default origins when you enable it. Vous pouvez toujours ajouter ces origines ultérieurement, comme décrit dans cette rubrique.You can always add these origins later as described in this topic.

Dans Windows PowerShell pour SharePoint Online :In Windows PowerShell for SharePoint Online:

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

Par exemple, pour permettre à votre organisation d’utiliser des origines publiques et privées, tapez la commande suivante :For example, to enable your organization to use both public and private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Pour permettre à votre organisation d’utiliser des origines publiques et privées, mais ignorer la configuration des origines par défaut, tapez la commande suivante :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

Voir 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.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.

Pour permettre à votre organisation d’utiliser des origines publiques, tapez la commande suivante :To enable your organization to use public origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Pour permettre à votre organisation d’utiliser des origines privées, tapez la commande suivante :To enable your organization to use private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Pour plus d’informations sur cette cmdlet, voir Set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Modifier la liste des types de fichiers à inclure dans le Office 365 CDN (facultatif)Change the list of file types to include in the Office 365 CDN (Optional)

Conseil

Lorsque vous définissez des types de fichiers à l’aide de la cmdlet Set-SPOTenantCdnPolicy, vous devez supprimer la liste actuellement définie.When you define file types by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Si vous souhaitez ajouter des types de fichiers supplémentaires à la liste, utilisez d’abord la cmdlet pour connaître les types de fichiers qui sont déjà autorisés et les inclure dans la liste avec vos nouveaux.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.

La cmdlet Set-SPOTenantCdnPolicy permet de définir des types de fichiers statiques qui peuvent être hébergés par des origines publiques et privées dans le CDN.Use the Set-SPOTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Par défaut, les types de ressources courants sont autorisés, par exemple .css, .gif, .jpg et .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

Dans Windows PowerShell pour SharePoint Online :In Windows PowerShell for SharePoint Online:

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

Par exemple, pour activer la CDN héberger les fichiers .css et .png, entrez la commande :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"

Pour voir les types de fichiers actuellement autorisés par le CDN, utilisez la cmdlet Get-SPOTenantCdnPolicies :To see what file types are currently allowed by the CDN, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Pour plus d’informations sur ces cmdlets, voir Set-SPOTenantCdnPolicy et Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Modifier la liste des classifications de site que vous souhaitez exclure du Office 365 CDN (facultatif)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Conseil

Lorsque vous excluez les classifications de site à l’aide de la cmdlet Set-SPOTenantCdnPolicy, vous devez supprimer la liste actuellement définie.When you exclude site classifications by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Si vous souhaitez exclure des classifications de site supplémentaires, utilisez d’abord l’cmdlet pour connaître les classifications qui sont déjà exclues, puis ajoutez-les avec vos nouvelles classifications.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.

Utilisez la cmdlet Set-SPOTenantCdnPolicy pour exclure les classifications de site que vous ne souhaitez pas rendre disponibles via le CDN.Use the Set-SPOTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Par défaut, aucune classification de site n’est exclue.By default, no site classifications are excluded.

Dans Windows PowerShell pour SharePoint Online :In Windows PowerShell for SharePoint Online:

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

Pour voir quelles classifications de site sont actuellement restreintes, utilisez la cmdlet Get-SPOTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Les propriétés qui seront renvoyées sont IncludeFileExtensions, ExcludeRestrictedSiteClassifications et ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

La propriété IncludeFileExtensions contient la liste des extensions de fichier qui seront servies à partir du CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Notes

Les extensions de fichier par défaut sont différentes entre public et privé.The default file extensions are different between public and private.

La propriété ExcludeRestrictedSiteClassifications contient les classifications de site que vous souhaitez exclure du CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Par exemple, vous pouvez exclure les sites marqués comme confidentiels afin que le contenu des sites avec cette classification ne soit pas servi à partir du 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.

La propriété ExcludeIfNoScriptDisabled exclut le contenu du CDN en fonction des paramètres d’attribut NoScript au niveau du site.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Par défaut, l’attribut NoScript est activé pour les sites modernes et désactivé pour les sites classiques. By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Cela dépend des paramètres de votre client.This depends on your tenant settings.

Pour plus d’informations sur ces cmdlets, voir Set-SPOTenantCdnPolicy et Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Ajouter une origine pour vos ressourcesAdd an origin for your assets

Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir une origine.Use the Add-SPOTenantCdnOrigin cmdlet to define an origin. Vous pouvez définir plusieurs origines.You can define multiple origins. L’origine est une URL pointant vers un dossier ou une bibliothèque SharePoint qui contient les ressources qui doivent être hébergées par le 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.

Important

Vous ne devez jamais placer dans une origine publique des ressources qui contiennent des informations utilisateur ou qui sont considérées comme sensibles à votre organisation.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>

La valeur du chemin d’accès est le chemin d’accès relatif à la bibliothèque ou au dossier qui contient les biens.The value of path is the relative path to the library or folder that contains the assets. Vous pouvez utiliser des caractères génériques en plus des chemins d’accès relatifs.You can use wildcards in addition to relative paths. Les origines peuvent prendre en charge les caractères génériques qui sont précédés de l’URL.Origins support wildcards prepended to the URL. Cela vous permet de créer des origines qui s’étendent sur plusieurs sites.This allows you to create origins that span multiple sites. Par exemple, pour inclure toutes les ressources dans le dossier masterpages de tous vos sites en tant qu’origine publique dans le CDN, tapez la commande suivante :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
  • Le modificateur générique * ne peut être utilisé qu’au début du chemin d’accès et correspond à tous les segments d’URL sous / l’URL spécifiée.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Le chemin d’accès peut pointer vers une bibliothèque de documents, un dossier ou un site.The path can point to a document library, folder or site. Par exemple, le chemin d’accès */site1 correspond à toutes les bibliothèques de documents sous le site.For example, the path */site1 will match all the document libraries under the site.

Vous pouvez ajouter une origine avec un chemin d’accès relatif spécifique.You can add an origin with a specific relative path. Vous ne pouvez pas ajouter une origine à l’aide du chemin d’accès complet.You cannot add an origin using the full path.

Cet exemple ajoute une origine privée de la bibliothèque siteassets sur un site spécifique :This example adds a private origin of the siteassets library on a specific site:

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

Cet exemple ajoute une origine privée du dossier folder1 dans la bibliothèque de biens de site de la collection de sites :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

S’il y a un espace dans le chemin d’accès, vous pouvez soit entourer le chemin d’accès entre guillemets doubles, soit remplacer l’espace par l’URL encodant %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. Les exemples suivants ajoutent une origine privée du dossier 1 dans la bibliothèque de biens de site de la collection de sites :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"

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Notes

Dans les origines privées, les biens partagés à partir d’une origine doivent avoir une version majeure publiée avant d’être accessibles à partir du CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : Configurer une origine publique pour vos pages maîtres et pour votre bibliothèque de styles pour SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normalement, ces origines sont définies pour vous par défaut lorsque vous activez la Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Toutefois, si vous souhaitez les activer manuellement, suivez ces étapes.However, if you want to enable them manually, follow these steps.

  • Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir la bibliothèque de styles en tant qu’origine publique.Use the Add-SPOTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir les pages maîtres en tant qu’origine publique.Use the Add-SPOTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : configurer une origine privée pour les ressources de votre site, les pages de site et les images de publication pour SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir le dossier des ressources du site en tant qu’origine privée.Use the Add-SPOTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir le dossier des pages de site en tant qu’origine privée.Use the Add-SPOTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir le dossier d’images de publication en tant qu’origine privée.Use the Add-SPOTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : Configurer une origine privée pour une collection de sites pour SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Utilisez la cmdlet Add-SPOTenantCdnOrigin pour définir une collection de sites en tant qu’origine privée.Use the Add-SPOTenantCdnOrigin cmdlet to define a site collection as a private origin. Par exemple :For example:

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

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Vous pouvez voir un message de configuration en attente qui est attendu lorsque le client SharePoint Online se connecte au service CDN client.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Gérer les Office 365 CDNManage the Office 365 CDN

Une fois que vous avez CDN, vous pouvez apporter des modifications à votre configuration lorsque vous mettez à jour le contenu ou que vos besoins changent, comme décrit dans cette section.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.

Ajouter, mettre à jour ou supprimer des ressources du Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Une fois que vous avez terminé les étapes de configuration, vous pouvez ajouter de nouvelles ressources et mettre à jour ou supprimer des biens existants à tout moment.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Il vous suffit d’apporter vos modifications aux ressources du dossier ou de la bibliothèque SharePoint que vous avez identifiée comme origine.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Si vous ajoutez une nouvelle valeur, elle est disponible via le CDN immédiatement.If you add a new asset, it is available through the CDN immediately. Toutefois, si vous mettez à jour le bien, la propagation de la nouvelle copie et sa mise à disposition dans le CDN prennent jusqu’à 15 minutes.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.

Si vous devez récupérer l’emplacement de l’origine, vous pouvez utiliser la cmdlet Get-SPOTenantCdnOrigins.If you need to retrieve the location of the origin, you can use the Get-SPOTenantCdnOrigins cmdlet. Pour plus d’informations sur l’utilisation de cette cmdlet, voir Get-SPOTenantCdnOrigins.For information on how to use this cmdlet, see Get-SPOTenantCdnOrigins.

Supprimer une origine du Office 365 CDNRemove an origin from the Office 365 CDN

Vous pouvez supprimer l’accès à un dossier ou une bibliothèque SharePoint que vous avez identifié comme origine.You can remove access to a folder or SharePoint library that you identified as an origin. Pour ce faire, utilisez la cmdlet Remove-SPOTenantCdnOrigin.To do this, use the Remove-SPOTenantCdnOrigin cmdlet.

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

Pour plus d’informations sur l’utilisation de cette cmdlet, voir Remove-SPOTenantCdnOrigin.For information on how to use this cmdlet, see Remove-SPOTenantCdnOrigin.

Modifier une origine dans le Office 365 CDNModify an origin in the Office 365 CDN

Vous ne pouvez pas modifier une origine que vous avez créée.You cannot modify an origin you've created. Supprimez plutôt l’origine, puis ajoutez-en une nouvelle.Instead, remove the origin and then add a new one. Pour plus d’informations, voir Pour supprimer une origine du Office 365 CDN et pour ajouter une origine pour vos ressources.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Désactiver le Office 365 CDNDisable the Office 365 CDN

Utilisez la cmdlet Set-SPOTenantCdnEnabled pour désactiver l’CDN pour votre organisation.Use the Set-SPOTenantCdnEnabled cmdlet to disable the CDN for your organization. Si les origines publique et privée sont activées pour le CDN, vous devez exécuter l’cmdlet deux fois comme indiqué dans les exemples suivants.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.

Pour désactiver l’utilisation des origines publiques dans le CDN, entrez la commande suivante :To disable use of public origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Pour désactiver l’utilisation des origines privées dans le CDN, entrez la commande suivante :To disable use of the private origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Pour plus d’informations sur cette cmdlet, voir Set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Installer et configurer le Office 365 CDN à l’aide de PowerShell PnPSet up and configure the Office 365 CDN by using PnP PowerShell

Les procédures de cette section exigent que vous utilisez PnP PowerShell pour vous connecter à SharePoint Online.The procedures in this section require you to use PnP PowerShell to connect to SharePoint Online. Pour obtenir des instructions, voir La mise en place de PowerShell PnP.For instructions, see Getting started with PnP PowerShell.

Effectuer ces étapes pour configurer le CDN pour héberger vos ressources dans SharePoint Online à l’aide de PowerShell PnP.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using PnP PowerShell.

Cliquez pour développerClick to expand

Permettre à votre organisation d’utiliser le Office 365 CDNEnable your organization to use the Office 365 CDN

Avant d’apporter des modifications aux paramètres de CDN client, vous devez récupérer l’état actuel de la configuration CDN privée dans votre client Office 365 client.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. Connecter votre client à l’aide de PowerShell PnP :Connect to your tenant using PnP PowerShell:

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

À présent, utilisez la cmdlet Get-PnPTenantCdnEnabled pour récupérer les paramètres d’CDN du client :Now use the Get-PnPTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

L’état du CDN pour le CdnType spécifié est produit à l’écran.The status of the CDN for the specified CdnType will output to the screen.

La cmdlet Set-PnPTenantCdnEnabled permet à votre organisation d’utiliser les Office 365 CDN.Use the Set-PnPTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Vous pouvez permettre à votre organisation d’utiliser des origines publiques, des origines privées ou les deux en même temps.You can enable your organization to use public origins, private origins, or both at at the same time. Vous pouvez également configurer le CDN pour ignorer la configuration des origines par défaut lorsque vous l’activez.You can also configure the CDN to skip the setup of default origins when you enable it. Vous pouvez toujours ajouter ces origines ultérieurement, comme décrit dans cette rubrique.You can always add these origins later as described in this topic.

Dans PowerShell PnP :In PnP PowerShell:

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

Par exemple, pour permettre à votre organisation d’utiliser des origines publiques et privées, tapez la commande suivante :For example, to enable your organization to use both public and private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Pour permettre à votre organisation d’utiliser des origines publiques et privées, mais ignorer la configuration des origines par défaut, tapez la commande suivante :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

Voir 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.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.

Pour permettre à votre organisation d’utiliser des origines publiques, tapez la commande suivante :To enable your organization to use public origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Pour permettre à votre organisation d’utiliser des origines privées, tapez la commande suivante :To enable your organization to use private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Pour plus d’informations sur cette cmdlet, voir Set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Modifier la liste des types de fichiers à inclure dans le Office 365 CDN (facultatif)Change the list of file types to include in the Office 365 CDN (Optional)

Conseil

Lorsque vous définissez des types de fichiers à l’aide de la cmdlet Set-PnPTenantCdnPolicy, vous devez supprimer la liste actuellement définie.When you define file types by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Si vous souhaitez ajouter des types de fichiers supplémentaires à la liste, utilisez d’abord la cmdlet pour connaître les types de fichiers qui sont déjà autorisés et les inclure dans la liste avec vos nouveaux.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.

La cmdlet Set-PnPTenantCdnPolicy permet de définir des types de fichiers statiques qui peuvent être hébergés par des origines publiques et privées dans le CDN.Use the Set-PnPTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Par défaut, les types de ressources courants sont autorisés, par exemple .css, .gif, .jpg et .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

Dans PowerShell PnP :In PnP PowerShell:

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

Par exemple, pour activer la CDN héberger les fichiers .css et .png, entrez la commande :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"

Pour voir les types de fichiers actuellement autorisés par le CDN, utilisez l’cmdlet Get-PnPTenantCdnPolicies :To see what file types are currently allowed by the CDN, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Pour plus d’informations sur ces cmdlets, voir Set-PnPTenantCdnPolicy et Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Modifier la liste des classifications de site que vous souhaitez exclure du Office 365 CDN (facultatif)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Conseil

Lorsque vous excluez les classifications de site à l’aide de l’cmdlet Set-PnPTenantCdnPolicy, vous devez supprimer la liste actuellement définie.When you exclude site classifications by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Si vous souhaitez exclure des classifications de site supplémentaires, utilisez d’abord l’cmdlet pour connaître les classifications qui sont déjà exclues, puis ajoutez-les avec vos nouvelles classifications.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.

La cmdlet Set-PnPTenantCdnPolicy permet d’exclure les classifications de site que vous ne souhaitez pas rendre disponibles sur le CDN.Use the Set-PnPTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Par défaut, aucune classification de site n’est exclue.By default, no site classifications are excluded.

Dans PowerShell PnP :In PnP PowerShell:

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

Pour voir quelles classifications de site sont actuellement restreintes, utilisez l’cmdlet Get-PnPTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Les propriétés qui seront renvoyées sont IncludeFileExtensions, ExcludeRestrictedSiteClassifications et ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

La propriété IncludeFileExtensions contient la liste des extensions de fichier qui seront servies à partir du CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Notes

Les extensions de fichier par défaut sont différentes entre public et privé.The default file extensions are different between public and private.

La propriété ExcludeRestrictedSiteClassifications contient les classifications de site que vous souhaitez exclure du CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Par exemple, vous pouvez exclure les sites marqués comme confidentiels afin que le contenu des sites avec cette classification ne soit pas servi à partir du 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.

La propriété ExcludeIfNoScriptDisabled exclut le contenu du CDN en fonction des paramètres d’attribut NoScript au niveau du site.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Par défaut, l’attribut NoScript est activé pour les sites modernes et désactivé pour les sites classiques. By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Cela dépend des paramètres de votre client.This depends on your tenant settings.

Pour plus d’informations sur ces cmdlets, voir Set-PnPTenantCdnPolicy et Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Ajouter une origine pour vos ressourcesAdd an origin for your assets

Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir une origine.Use the Add-PnPTenantCdnOrigin cmdlet to define an origin. Vous pouvez définir plusieurs origines.You can define multiple origins. L’origine est une URL pointant vers un dossier ou une bibliothèque SharePoint qui contient les ressources qui doivent être hébergées par le 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.

Important

Vous ne devez jamais placer dans une origine publique des ressources qui contiennent des informations utilisateur ou qui sont considérées comme sensibles à votre organisation.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>

La valeur du chemin d’accès est le chemin d’accès relatif à la bibliothèque ou au dossier qui contient les biens.The value of path is the relative path to the library or folder that contains the assets. Vous pouvez utiliser des caractères génériques en plus des chemins d’accès relatifs.You can use wildcards in addition to relative paths. Les origines peuvent prendre en charge les caractères génériques qui sont précédés de l’URL.Origins support wildcards prepended to the URL. Cela vous permet de créer des origines qui s’étendent sur plusieurs sites.This allows you to create origins that span multiple sites. Par exemple, pour inclure toutes les ressources dans le dossier masterpages de tous vos sites en tant qu’origine publique dans le CDN, tapez la commande suivante :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
  • Le modificateur générique * ne peut être utilisé qu’au début du chemin d’accès et correspond à tous les segments d’URL sous / l’URL spécifiée.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Le chemin d’accès peut pointer vers une bibliothèque de documents, un dossier ou un site.The path can point to a document library, folder or site. Par exemple, le chemin d’accès */site1 correspond à toutes les bibliothèques de documents sous le site.For example, the path */site1 will match all the document libraries under the site.

Vous pouvez ajouter une origine avec un chemin d’accès relatif spécifique.You can add an origin with a specific relative path. Vous ne pouvez pas ajouter une origine à l’aide du chemin d’accès complet.You cannot add an origin using the full path.

Cet exemple ajoute une origine privée de la bibliothèque de biens de site sur un site spécifique :This example adds a private origin of the site assets library on a specific site:

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

Cet exemple ajoute une origine privée du dossier folder1 dans la bibliothèque de biens de site de la collection de sites :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

S’il y a un espace dans le chemin d’accès, vous pouvez soit entourer le chemin d’accès entre guillemets doubles, soit remplacer l’espace par l’URL encodant %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. Les exemples suivants ajoutent une origine privée du dossier 1 dans la bibliothèque de biens de site de la collection de sites :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"

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Notes

Dans les origines privées, les biens partagés à partir d’une origine doivent avoir une version majeure publiée avant d’être accessibles à partir du CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : Configurer une origine publique pour vos pages maîtres et pour votre bibliothèque de styles pour SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normalement, ces origines sont définies pour vous par défaut lorsque vous activez la Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Toutefois, si vous souhaitez les activer manuellement, suivez ces étapes.However, if you want to enable them manually, follow these steps.

  • Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir la bibliothèque de styles en tant qu’origine publique.Use the Add-PnPTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir les pages maîtres en tant qu’origine publique.Use the Add-PnPTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : configurer une origine privée pour les ressources de votre site, les pages de site et les images de publication pour SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • La cmdlet Add-PnPTenantCdnOrigin permet de définir le dossier des ressources du site comme une origine privée.Use the Add-PnPTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir le dossier des pages de site comme une origine privée.Use the Add-PnPTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir le dossier d’images de publication en tant qu’origine privée.Use the Add-PnPTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Exemple : Configurer une origine privée pour une collection de sites pour SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Utilisez la cmdlet Add-PnPTenantCdnOrigin pour définir une collection de sites en tant qu’origine privée.Use the Add-PnPTenantCdnOrigin cmdlet to define a site collection as a private origin. Par exemple :For example:

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

Pour plus d’informations sur cette commande et sa syntaxe, voir Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Une fois que vous avez exécuté la commande, le système synchronise la configuration dans le centre de données.Once you've run the command, the system synchronizes the configuration across the datacenter. Vous pouvez voir un message de configuration en attente qui est attendu lorsque le client SharePoint Online se connecte au service CDN client.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Cela peut prendre jusqu’à 15 minutes.This can take up to 15 minutes.

Gérer les Office 365 CDNManage the Office 365 CDN

Une fois que vous avez CDN, vous pouvez apporter des modifications à votre configuration lorsque vous mettez à jour le contenu ou que vos besoins changent, comme décrit dans cette section.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.

Ajouter, mettre à jour ou supprimer des ressources du Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Une fois que vous avez terminé les étapes de configuration, vous pouvez ajouter de nouvelles ressources et mettre à jour ou supprimer des biens existants à tout moment.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Il vous suffit d’apporter vos modifications aux ressources du dossier ou de la bibliothèque SharePoint que vous avez identifiée comme origine.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Si vous ajoutez une nouvelle valeur, elle est disponible via le CDN immédiatement.If you add a new asset, it is available through the CDN immediately. Toutefois, si vous mettez à jour le bien, la propagation de la nouvelle copie et sa mise à disposition dans le CDN prennent jusqu’à 15 minutes.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.

Si vous avez besoin de récupérer l’emplacement de l’origine, vous pouvez utiliser l’cmdlet Get-PnPTenantCdnOrigin.If you need to retrieve the location of the origin, you can use the Get-PnPTenantCdnOrigin cmdlet. Pour plus d’informations sur l’utilisation de cette cmdlet, voir Get-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Get-PnPTenantCdnOrigin.

Supprimer une origine du Office 365 CDNRemove an origin from the Office 365 CDN

Vous pouvez supprimer l’accès à un dossier ou une bibliothèque SharePoint que vous avez identifié comme origine.You can remove access to a folder or SharePoint library that you identified as an origin. Pour ce faire, utilisez l’cmdlet Remove-PnPTenantCdnOrigin.To do this, use the Remove-PnPTenantCdnOrigin cmdlet.

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

Pour plus d’informations sur l’utilisation de cette cmdlet, voir Remove-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Remove-PnPTenantCdnOrigin.

Modifier une origine dans le Office 365 CDNModify an origin in the Office 365 CDN

Vous ne pouvez pas modifier une origine que vous avez créée.You cannot modify an origin you've created. Supprimez plutôt l’origine, puis ajoutez-en une nouvelle.Instead, remove the origin and then add a new one. Pour plus d’informations, voir Pour supprimer une origine du Office 365 CDN et pour ajouter une origine pour vos ressources.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Désactiver le Office 365 CDNDisable the Office 365 CDN

Utilisez la cmdlet Set-PnPTenantCdnEnabled pour désactiver le CDN pour votre organisation.Use the Set-PnPTenantCdnEnabled cmdlet to disable the CDN for your organization. Si les origines publique et privée sont activées pour le CDN, vous devez exécuter l’cmdlet deux fois comme indiqué dans les exemples suivants.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.

Pour désactiver l’utilisation des origines publiques dans le CDN, entrez la commande suivante :To disable use of public origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Pour désactiver l’utilisation des origines privées dans le CDN, entrez la commande suivante :To disable use of the private origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Pour plus d’informations sur cette cmdlet, voir Set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Installation et configuration du CDN Office 365 à l’aide de la CLI Office 365Set up and configure the Office 365 CDN using the Office 365 CLI

Les procédures de cette section nécessitent que vous avez installé l’Office 365 CLI.The procedures in this section require that you have installed the Office 365 CLI. Ensuite, connectez-vous à Office 365 client à l’aide de la commande de connexion.Next, connect to your Office 365 tenant using the login command.

Pour configurer et configurer le CDN pour héberger vos ressources dans SharePoint Online à l’aide de l’Office 365 CLI, complétez ces étapes.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the Office 365 CLI.

Cliquez pour développerClick to expand

Activer le Office 365 CDNEnable the Office 365 CDN

Vous pouvez gérer l’état du CDN Office 365 dans votre client à l’aide de la commande spo cdn set.You can manage the state of the Office 365 CDN in your tenant using the spo cdn set command.

Pour activer le CDN public Office 365 dans votre client exécutez la commande suivante :To enable the Office 365 Public CDN in your tenant execute:

spo cdn set --type Public --enabled true

Pour activer le Office 365 SharePoint CDN, exécutez :To enable the Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Affichage de l’état actuel du CDN Office 365View the current status of the Office 365 CDN

Pour vérifier si le type particulier de Office 365 CDN est activé ou désactivé, utilisez la commande get spo cdn.To check if the particular type of Office 365 CDN is enabled or disabled, use the spo cdn get command.

Pour vérifier si le CDN public Office 365 est activé, exécutez la commande suivante :To check if the Office 365 Public CDN is enabled, execute:

spo cdn get --type Public

Afficher les origines Office 365 CDN de l’affichageView the Office 365 CDN origins

Pour afficher les origines actuellement configurées du CDN public Office 365, exécutez la commande suivante :To view the currently configured Office 365 Public CDN origins execute:

spo cdn origin list --type Public

Voir Default CDN’origines pour plus d’informations sur les origines qui sont provisionn es par défaut lorsque vous activez le Office 365 CDN.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Ajouter une origine Office 365 CDN’origineAdd an Office 365 CDN origin

Important

Vous ne devez jamais placer les ressources qui sont considérées comme sensibles à votre organisation dans une bibliothèque de documents SharePoint configurée en tant qu’origine publique.You should never place resources that are considered sensitive to your organization in a SharePoint document library configured as a public origin.

Utilisez la commande spo cdn origin add pour définir une origine de CDN.Use the spo cdn origin add command to define a CDN origin. Vous pouvez définir plusieurs origines.You can define multiple origins. L’origine est une URL pointant vers un dossier ou une bibliothèque SharePoint qui contient les ressources qui doivent être hébergées par le 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 se trouve le chemin d’accès relatif au dossier qui contient les ressources.Where path is the relative path to the folder that contains the assets. Vous pouvez utiliser des caractères génériques en plus des chemins d’accès relatifs.You can use wildcards in addition to relative paths.

Pour inclure toutes les ressources dans la galerie de pages maîtres de tous les sites en tant qu’origine publique, exécutez :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

Pour configurer une origine privée pour une collection de sites spécifique, exécutez la commande suivante :To configure a private origin for a specific site collection, execute:

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

Notes

Après l’ajout d’une origine de CDN, un délai de 15 minutes maximum peut être nécessaire avant que vous ne puissiez récupérer des fichiers par le biais du service de 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. Vous pouvez vérifier si l’origine spécifique a déjà été activée à l’aide la commande spo cdn origin list.You can verify if the particular origin has already been enabled using the spo cdn origin list command.

Supprimer une origine Office 365 CDN’origineRemove an Office 365 CDN origin

Utilisez la commande spo cdn origin remove pour supprimer une origine de CDN pour le type de CDN spécifié.Use the spo cdn origin remove command to remove a CDN origin for the specified CDN type.

Pour supprimer une origine publique de la configuration CDN, exécutez :To remove a public origin from the CDN configuration, execute:

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

Notes

La suppression d CDN d’une bibliothèque de documents n’affecte pas les fichiers stockés dans une bibliothèque de documents correspondant à cette origine.Removing a CDN origin doesn't affect the files stored in any document library matching that origin. Si ces ressources ont été référencés à l’aide de leur URL SharePoint, SharePoint revenir automatiquement à l’URL d’origine pointant vers la bibliothèque de documents.If these assets have been referenced using their SharePoint URL, SharePoint will automatically switch back to the original URL pointing to the document library. Toutefois, si des ressources ont été référencés à l’aide d’une URL CDN publique, la suppression de l’origine va rompre le lien et vous devrez les modifier manuellement.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.

Modifier une origine Office 365 CDN de donnéesModify an Office 365 CDN origin

Il n’est pas possible de modifier une origine de CDN existante.It's not possible to modify an existing CDN origin. Vous devez plutôt supprimer l’origine de CDN définie précédemment à l’aide de la commande spo cdn origin remove et en ajouter une nouvelle à l’aide de la commande 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.

Modifier les types de fichiers à inclure dans le Office 365 CDNChange the types of files to include in the Office 365 CDN

Par défaut, les types de fichiers suivants sont inclus dans le CDN : .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff et .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. Si vous devez inclure des types de fichier supplémentaires dans le CDN, vous pouvez modifier la configuration du CDN à l’aide de la commande 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.

Notes

Lorsque vous modifiez la liste des types de fichier, vous remplacez la liste actuellement définie.When changing the list of file types, you overwrite the currently defined list. Pour inclure des types de fichier supplémentaires, utilisez d’abord la commande spo cdn policy list afin de vérifier les types de fichier qui sont actuellement configurés.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.

Pour ajouter le type de fichier JSON à la liste par défaut des types de fichiers inclus dans le CDN public, exécutez :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"

Modification de la liste des classifications de site que vous souhaitez exclure du CDN Office 365Change the list of site classifications you want to exclude from the Office 365 CDN

Utilisez la commande spo cdn policy set pour exclure les classifications de site que vous ne souhaitez pas rendre disponibles via le CDN.Use the spo cdn policy set command to exclude site classifications that you do not want to make available over the CDN. Par défaut, aucune classification de site n’est exclue.By default, no site classifications are excluded.

Notes

Lorsque vous modifiez la liste des classifications de site exclues, vous remplacez la liste actuellement définie.When changing the list of excluded site classifications, you overwrite the currently defined list. Pour exclure des classifications supplémentaires, utilisez d’abord la commande spo cdn policy list afin de vérifier les classifications qui sont actuellement configurées.If you want to exclude additional classifications, first use the spo cdn policy list command to find out which classifications are currently configured.

Pour exclure des sites classés comme HBI de l’CDN public, exécutezTo exclude sites classified as HBI from the public CDN, execute

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

Désactiver le Office 365 CDNDisable the Office 365 CDN

Pour désactiver le CDN Office 365, utilisez la commande spo cdn set, par exemple :To disable the Office 365 CDN use the spo cdn set command, for example:

spo cdn set --type Public --enabled false

Utilisation de vos ressources CDN de gestionUsing your CDN assets

Maintenant que vous avez activé la CDN et configuré les origines et les stratégies, vous pouvez commencer à utiliser CDN ressources.Now that you have enabled the CDN and configured origins and policies, you can begin using your CDN assets.

Cette section vous aidera à comprendre comment utiliser les URL de CDN dans vos pages et votre contenu SharePoint afin que SharePoint redirige les demandes de ressources des origines publiques et privées vers le 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.

Pour plus d’informations sur l’utilisation du CDN pour l’hébergement de composants Web Part côté client, voir la rubrique 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).

Notes

Si vous ajoutez le dossier ClientSideAssets à la liste CDN origines, les composants Web CDN hébergés par le client ne seront pas restituer. If you add the ClientSideAssets folder to the private CDN origins list, CDN-hosted custom web parts will fail to render. Les fichiers utilisés par les composants Web Parts SPFX peuvent uniquement utiliser le CDN public et le dossier ClientSideAssets est une origine par défaut pour les CDN.Files used by SPFX web parts can only utilize the public CDN and the ClientSideAssets folder is a default origin for public CDN.

Pour utiliser les ressources que vous avez ajoutées à une origine, il vous suffit de mettre à jour les liens vers le fichier d’origine avec le chemin d’accès au fichier dans l’origine.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.

  • Modifiez la page ou le contenu qui contient des liens vers des ressources que vous avez ajoutées à une origine.Edit the page or content that contains links to assets you have added to an origin. Vous pouvez également utiliser l’une des différentes méthodes pour rechercher et remplacer globalement les liens entre un site ou une collection de sites d’entrée si vous souhaitez mettre à jour le lien vers un bien donné partout où il apparaît.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.
  • Pour chaque lien vers une valeur d’origine, remplacez le chemin d’accès par le chemin d’accès au fichier dans l CDN d’origine.For each link to an asset in an origin, replace the path with the path to the file in the CDN origin. Vous pouvez utiliser des chemins d’accès relatifs.You can use relative paths.
  • Enregistrez la page ou le contenu.Save the page or content.

Par exemple, considérez l’image /site/SiteAssets/images/image.png, que vous avez copiée dans le dossier de bibliothèque de documents /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/. Pour utiliser la CDN, remplacez le chemin d’accès d’origine à l’emplacement du fichier image par le chemin d’accès à l’origine pour rendre la nouvelle 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.

Si vous souhaitez utiliser l’URL complète de la bien au lieu d’un chemin d’accès relatif, construisez le lien de la sorte :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

Notes

En règle générale, vous ne devez pas coder en dur les URL directement dans les ressources de la CDN.In general, you should not hardcode URLs directly to assets in the CDN. Toutefois, vous pouvez créer manuellement des URL pour les ressources dans les origines publiques si nécessaire.However, you can manually construct URLs for assets in public origins if needed. Pour plus d’informations, voir Codage CDN URL pour les biens publics.For more information, see Hardcoding CDN URLs for public assets.

Pour savoir comment vérifier que les biens sont servis à partir du CDN, voir Comment puis-je confirmer que les biens sont servis par le CDN ? dans La résolution des problèmes de Office 365 CDN .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.

Utilisation de biens dans les origines publiquesUsing assets in public origins

La fonctionnalité publication dans SharePoint Online réécrit automatiquement les URL des biens stockés dans des origines publiques en leurs équivalents CDN afin que les biens soient servis à partir du service CDN au lieu de 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.

Si votre origine se trouve dans un site où la fonctionnalité publication est activée et que les ressources que vous souhaitez décharger vers le CDN sont dans l’une des catégories suivantes, SharePoint réécrit automatiquement les URL des biens de l’origine, à condition que le bien n’ait pas été exclu par une stratégie 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.

Voici un aperçu des liens qui sont réécrits automatiquement par la fonctionnalité de publication SharePoint :The following is an overview of which links are automatically rewritten by the SharePoint Publishing feature:

  • URL IMG/LINK/CSS dans les réponses HTML de pages de publications classiquesIMG/LINK/CSS URLs in classic publishing page HTML responses
    • Cela comprend les images ajoutées par des auteurs dans le contenu HTML d’une page.This includes images added by authors within the HTML content of a page
  • URL d’images de composants WebPart de diaporamas de bibliothèque d’imagesPicture Library SlideShow webpart image URLs
  • Champs d’image dans les résultats d’API REST SPList (RenderListDataAsStream)Image fields in SPList REST API (RenderListDataAsStream) results
    • Utilisez la nouvelle propriété ImageFieldsToTryRewriteToCdnUrls pour fournir une liste de champs séparés par des virgulesUse the new property ImageFieldsToTryRewriteToCdnUrls to provide a comma separated list of fields
    • Prend en charge les champs lien hypertexte et PublishingImageSupports hyperlink fields and PublishingImage fields
  • SharePoint rendus d’imageSharePoint image renditions

Le diagramme suivant illustre le flux de travail lorsque SharePoint reçoit une demande de page contenant des biens d’une origine publique.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a public origin.

Diagramme de flux de travail : récupération de ressources Office 365 CDN d’une origine publiqueWorkflow diagram: Retrieving Office 365 CDN assets from a public origin

Conseil

Si vous souhaitez désactiver la réécriture automatique pour des URL spécifiques sur une page, vous pouvez consulter la page et ajouter le paramètre de chaîne de requête ? NoAutoReWrites=true à la fin de chaque lien à désactiver.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.

Construction d CDN URL pour les biens publicsConstructing CDN URLs for public assets

Si la fonctionnalité publication n’est pas activée pour une origine publique ou si la bien n’est pas l’un des types de liens pris en charge par la fonctionnalité de réécriture automatique du service CDN, vous pouvez créer manuellement des URL à l’emplacement CDN des ressources et utiliser ces URL dans votre contenu.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.

Notes

Vous ne pouvez pas coder en dur ou construire des URL CDN sur des ressources d’origine privée, car le jeton d’accès requis qui constitue la dernière section de l’URL est généré au moment où la ressource est demandée.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. Vous pouvez construire l’URL pour les CDN public et l’URL ne doit pas être codée en dur, car elle est sujette à modification.You can construct the URL for Public CDN and the URL should not be hard coded as it is subject to change.

Pour les ressources CDN publiques, le format d’URL ressemblera à ce qui suit :For public CDN assets, the URL format will look like the following:

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

Remplacez TenantHostName par le nom de votre client.Replace TenantHostName with your tenant name. Exemple :Example:

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

Notes

La propriété de contexte de page doit être utilisée pour construire le préfixe au lieu de coder en dur « https://publiccdn.sharepointonline.com ».The page context property should be used to construct the prefix instead of hard coding "https://publiccdn.sharepointonline.com". L’URL est sujette à modification et ne doit pas être codée en dur.The URL is subject to change and should not be hard coded. Si vous utilisez des modèles d’affichage avec Classic SharePoint Online, vous pouvez utiliser la propriété « window._spPageContextInfo.publicCdnBaseUrl » dans votre modèle d’affichage pour le préfixe de l’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. Si vous utilisez des composants Web SPFx pour des SharePoint vous pouvez utiliser la propriété « 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". Cela fournit le préfixe de sorte que s’il est modifié, votre implémentation sera mise à jour avec lui.This will provide the prefix so that if it is changed then your implementation will update with it. Par exemple, pour SPFx, l’URL peut être construite à l’aide de la propriété " this.context.pageContext.legacyPageContext.publicCdnBaseUrl » + « / » + « host » + « / » + « relativeURL for the item ».As an example for SPFx, the URL can be constructed using the property "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL for the item". Consultez l’utilisation CDN code côté client qui fait partie de la série de performances de la campagne 1Please see Using CDN in Client-side code which is part of the season 1 performance series

Utilisation de biens dans des origines privéesUsing assets in private origins

Aucune configuration supplémentaire n’est requise pour utiliser des biens dans des origines privées.No additional configuration is required to use assets in private origins. SharePoint Online réécrit automatiquement les URL des biens dans des origines privées afin que les demandes de ces biens soient toujours reçues à partir du CDN.SharePoint Online automatically rewrites URLs for assets in private origins so requests for those assets will always be served from the CDN. Vous ne pouvez pas créer manuellement des URL pour CDN ressources dans des origines privées, car ces URL contiennent des jetons qui doivent être générés automatiquement par SharePoint Online au moment où le bien est demandé.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.

L’accès aux biens dans les origines privées est protégé par des jetons générés dynamiquement en fonction des autorisations utilisateur sur l’origine, avec les avertissements décrits dans les sections suivantes.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. Les utilisateurs doivent au moins avoir un accès en lecture aux origines pour CDN pour restituer le contenu.Users must have at least read access to the origins for the CDN to render content.

Le diagramme suivant illustre le flux de travail lorsque SharePoint reçoit une demande pour une page contenant des biens d’une origine privée.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a private origin.

Diagramme de flux de travail : récupération de ressources Office 365 CDN d’une origine privéeWorkflow diagram: Retrieving Office 365 CDN assets from a private origin

Autorisation basée sur un jeton dans les origines privéesToken-based authorization in private origins

L’accès aux biens dans les origines privées du Office 365 CDN est accordé par les jetons générés par SharePoint Online.Access to assets in private origins in the Office 365 CDN is granted by tokens generated by SharePoint Online. Les utilisateurs qui ont déjà l’autorisation d’accéder au dossier ou à la bibliothèque désigné par l’origine se sont automatiquement vus accorder des jetons qui permettent à l’utilisateur d’accéder au fichier en fonction de son niveau d’autorisation.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. Ces jetons d’accès sont valides pendant 30 à 90 minutes après qu’ils ont été générés pour empêcher les attaques de relecture de jeton.These access tokens are valid for 30 to 90 minutes after they are generated to help prevent token replay attacks.

Une fois le jeton d’accès généré, SharePoint Online renvoie un URI personnalisé au client contenant deux paramètres d’autorisation (jeton d’autorisation Edge) et un secret (jeton d’autorisation d’origine).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). La structure de chaque jeton est<'expiration au format d’heure Époque >__<'>.The structure of each token is <'expiration time in Epoch time format'>__<'secure signature'>. Par exemple :For example:

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

Notes

Toute personne en possession du jeton peut accéder à la ressource dans le CDN.Anyone in possession of the token can access the resource in the CDN. Toutefois, les URL contenant ces jetons d’accès sont partagées uniquement sur HTTPS. Par conséquent, à moins que l’URL ne soit explicitement partagée par un utilisateur final avant l’expiration du jeton, le bien ne sera pas accessible aux utilisateurs non autorisés.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.

Les autorisations au niveau de l’élément ne sont pas pris en charge pour les biens dans les origines privéesItem-level permissions are not supported for assets in private origins

Il est important de noter que SharePoint Online ne prend pas en charge les autorisations au niveau de l’élément pour les biens dans les origines privées.It is important to note that SharePoint Online does not support item-level permissions for assets in private origins. Par exemple, pour un fichier situé à l’emplacement , les utilisateurs ont un accès effectif au fichier https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg dans les conditions suivantes :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:

UtilisateurUser AutorisationsPermissions Accès efficaceEffective access
Utilisateur 1User 1 A accès à folder1Has access to folder1 Peut accéder image1.jpg à partir du CDNCan access image1.jpg from the CDN
Utilisateur 2User 2 N’a pas accès à folder1Does not have access to folder1 Impossible d'image1.jpg à partir du CDNCannot access image1.jpg from the CDN
Utilisateur 3User 3 N’a pas accès au dossier 1, mais est autorisé explicitement à accéder image1.jpg dans SharePoint OnlineDoes not have access to folder1, but is granted explicit permission to access image1.jpg in SharePoint Online Peut accéder à l'image1.jpg directement à partir de SharePoint Online, mais pas à partir du CDNCan access the asset image1.jpg directly from SharePoint Online, but not from the CDN
Utilisateur 4User 4 A accès au dossier 1, mais a été explicitement refusé l’accès image1.jpg dans SharePoint OnlineHas access to folder1, but has been explicitly denied access to image1.jpg in SharePoint Online Impossible d’accéder au bien à partir de SharePoint Online, mais peut y accéder à partir du CDN même si l’accès au fichier n’est pas autorisé dans 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

Résolution des problèmes de la Office 365 CDNTroubleshooting the Office 365 CDN

Comment puis-je confirmer que les ressources sont servies par le CDN ?How do I confirm that assets are being served by the CDN?

Une fois que vous avez ajouté des liens vers des ressources CDN à une page, vous pouvez confirmer que le bien est servi à partir du CDN en naviguant jusqu’à la page, en cliquant avec le bouton droit sur l’image une fois qu’elle est restituer et en passant en revue l’URL de l’image.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.

Vous pouvez également utiliser les outils de développement de votre navigateur pour afficher l’URL de chaque bien sur une page, ou utiliser un outil de suivi réseau tiers.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.

Notes

Si vous utilisez un outil réseau tel que Fiddler pour tester vos ressources en dehors du rendu de la bien à partir d’une page SharePoint, vous devez ajouter manuellement l’en-tête de référence « Referer: » à la requête GET où l’URL est l’URL racine de votre client 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.

Vous ne pouvez pas tester CDN URL directement dans un navigateur web, car vous devez avoir un référent provenant de SharePoint Online.You cannot test CDN URLs directly in a web browser because you must have a referer coming from SharePoint Online. Toutefois, si vous ajoutez l’URL de la CDN à une page SharePoint, puis que vous ouvrez la page dans un navigateur, le bien CDN s’affichera sur la page.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.

Pour plus d’informations sur l’utilisation des outils de développement dans Microsoft Edge navigateur, voir Microsoft Edge Outils de développement.For more information on using the developer tools in the Microsoft Edge browser, see Microsoft Edge Developer Tools.

Pour regarder une courte vidéo hébergée sur la chaîne YouTube Modèles et pratiques du développeur SharePoint montrant comment vérifier que votre CDN fonctionne, voir Vérifier l’utilisation de votre CDNet garantir une connectivité réseau optimale.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.

Pourquoi les ressources d’une nouvelle origine ne sont-elles pas disponibles ?Why are assets from a new origin unavailable?

Les ressources des nouvelles origines ne seront pas immédiatement disponibles pour une utilisation, car il faut du temps pour que l’inscription se propage dans le CDN et que les ressources soient téléchargées de l’origine vers le stockage 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. Le temps nécessaire à la mise à disposition des ressources dans le CDN dépend du nombre de ressources et de la taille des fichiers.The time required for assets to be available in the CDN depends on how many assets and the files sizes.

Ma solution de serveur Web SharePoint Framework côté client ne fonctionne pasMy client-side web part or SharePoint Framework solution isn't working

Lorsque vous activez la Office 365 CDN pour les origines publiques, le service CDN crée automatiquement ces origines par défaut :When you enable the Office 365 CDN for public origins, the CDN service automatically creates these default origins:

  • */MASTERPAGE*/MASTERPAGE
  • */BIBLIOTHÈQUE DE STYLES*/STYLE LIBRARY
  • */CLIENTSIDEASSETS*/CLIENTSIDEASSETS

Si l’origine */clientsideassets est manquante, SharePoint Framework solutions de recherche échouent et aucun message d’avertissement ou d’erreur n’est généré.If the */clientsideassets origin is missing, SharePoint Framework solutions will fail, and no warning or error messages are generated. Cette origine peut être manquante soit parce que la CDN a été activée avec le paramètre -NoDefaultOrigins définie sur $true, soit parce que l’origine a été supprimée manuellement.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.

Vous pouvez vérifier les origines présentes avec la commande PowerShell suivante :You can check to see which origins are present with the following PowerShell command:

Get-SPOTenantCdnOrigins -CdnType Public

Vous pouvez également vérifier avec l’Office 365 CLI :Or you can check with the Office 365 CLI:

spo cdn origin list

Pour ajouter l’origine dans PowerShell :To add the origin in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Pour ajouter l’origine dans l’Office 365 CLI :To add the origin in the Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Quels sont les modules PowerShell et les shells CLI dont je ai besoin pour travailler avec les Office 365 CDN ?What PowerShell modules and CLI shells do I need to work with the Office 365 CDN?

Vous pouvez choisir d’utiliser le Office 365 CDN à l’aide du module PowerShell SharePoint Online Management Shell ou de l’Office 365 CLI.You can choose to work with the Office 365 CDN using either the SharePoint Online Management Shell PowerShell module or the Office 365 CLI.

Voir aussiSee also

Réseaux de distribution de contenuContent Delivery Networks

Planification réseau et optimisation des performances pour Office 365Network planning and performance tuning for Office 365

SharePoint Série de performances - série Office 365 CDN vidéoSharePoint Performance Series - Office 365 CDN video series