De Office 365 Content Delivery Network (CDN) gebruiken met SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online

U kunt de ingebouwde Office 365 Content Delivery Network (CDN) gebruiken om statische assets te hosten om betere prestaties te bieden voor uw SharePoint Online-pagina's.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. De Office 365 CDN verbetert de prestaties door statische assets dichter bij de browsers te houden waarin ze worden gevraagd, wat helpt om downloads te versnellen en de latentie te verminderen.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. De Office 365 CDN gebruikt ook het HTTP/2-protocol voor verbeterde compressie en HTTP-pipelineing.Also, the Office 365 CDN uses the HTTP/2 protocol for improved compression and HTTP pipelining. De Office 365 CDN service is opgenomen als onderdeel van uw SharePoint Online-abonnement.The Office 365 CDN service is included as part of your SharePoint Online subscription.

Notitie

De Office 365 CDN is alleen beschikbaar voor tenants in de productiecloud (wereldwijd).The Office 365 CDN is only available to tenants in the Production (worldwide) cloud. Tenants in de amerikaanse overheid, China en Duitsland clouds ondersteunen momenteel de Office 365 CDN.Tenants in the US Government, China and Germany clouds do not currently support the Office 365 CDN.

De Office 365 CDN bestaat uit meerdere CDN's waarmee u statische assets op meerdere locaties of origins kunt hosten en deze kunt gebruiken vanuit globale snelle netwerken.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. Afhankelijk van het type inhoud dat u wilt hosten in de Office 365 CDN, kunt u openbare origins, privé-origins of beide toevoegen.Depending on the kind of content you want to host in the Office 365 CDN, you can add public origins, private origins or both. Zie Kiezen of elke origin openbaar of privé moet zijn voor meer informatie over het verschil tussen openbare en private origins.See Choose whether each origin should be public or private for more information on the difference between public and private origins.

Office 365 CDN conceptueel diagramOffice 365 CDN conceptual diagram

Als u al bekend bent met de manier waarop CDN's werken, hoeft u slechts een paar stappen uit te voeren om de Office 365 CDN voor uw tenant in te stellen.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. In dit onderwerp wordt beschreven hoe.This topic describes how. Lees verder voor informatie over hoe u aan de slag kunt met het hosten van uw statische assets.Read on for information about how to get started hosting your static assets.

Tip

Er zijn andere door Microsoft gehoste CDN's die kunnen worden gebruikt met Office 365 voor gespecialiseerde gebruiksscenario's, maar worden niet besproken in dit onderwerp omdat ze buiten het bereik van de 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. Zie Andere Microsoft CDN'svoor meer informatie.For more information, see Other Microsoft CDNs.

Ga terug naar Netwerkplanning en prestatieafstemming voor Office 365.Head back to Network planning and performance tuning for Office 365.

Overzicht van het werken met de Office 365 CDN in SharePoint OnlineOverview of working with the Office 365 CDN in SharePoint Online

Als u de Office 365 CDN voor uw organisatie wilt instellen, volgt u de volgende basisstappen:To set up the Office 365 CDN for your organization, you follow these basic steps:

Nadat u klaar bent met instellen, kunt u de Office 365 CDN in de tijd beheren door:Once you're done with setup, you can Manage the Office 365 CDN over time by:

  • Activa toevoegen, bijwerken en verwijderenAdding, updating, and removing assets
  • Origins toevoegen en verwijderenAdding and removing origins
  • Beleidsregels CDN configurerenConfiguring CDN policies
  • Als dat nodig is, kunt u de CDNIf necessary, disabling the CDN

Zie Ten slotte Uw CDN gebruiken voor meer informatie over toegang tot uw CDN activa van zowel openbare als privé-origins.Finally, see Using your CDN assets to learn about accessing your CDN assets from both public and private origins.

Zie Problemen oplossen Office 365 CDN voor richtlijnen voor het oplossen van veelvoorkomende problemen.See Troubleshooting the Office 365 CDN for guidance on resolving common issues.

Plannen voor implementatie van de Office 365 CDNPlan for deployment of the Office 365 CDN

Voordat u de Office 365 CDN voor uw Office 365 tenant implementeert, moet u rekening houden met de volgende factoren als onderdeel van uw planningsproces.Before you deploy the Office 365 CDN for your Office 365 tenant, you should consider the following factors as part of your planning process.

Bepalen welke statische assets u wilt hosten op de CDNDetermine which static assets you want to host on the CDN

CdN's zijn over het algemeen het meest effectief voor het hosten van statische activa of activa die niet vaak veranderen.In general, CDNs are most effective for hosting static assets, or assets that don't change very often. Een goede vuistregel is om bestanden te identificeren die voldoen aan bepaalde of al deze voorwaarden:A good rule of thumb is to identify files that meet some or all of these conditions:

  • Statische bestanden die zijn ingesloten in een pagina (zoals scripts en afbeeldingen) die een aanzienlijk incrementeel effect kunnen hebben op laadtijden van pagina'sStatic files embedded in a page (like scripts and images) that may have a significant incremental impact on page load times
  • Grote bestanden, zoals uitvoerbare bestanden en installatiebestandenLarge files like executables and installation files
  • Resourcebibliotheken die clientcode ondersteunenResource libraries that support client-side code

Kleine bestanden die herhaaldelijk worden aangevraagd, zoals siteafbeeldingen en scripts, kunnen bijvoorbeeld de prestaties van siterendering aanzienlijk verbeteren en de belasting op uw SharePoint Online-sites stapsgewijs verminderen wanneer u ze toevoegt aan een CDN origin.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. Grotere bestanden, zoals installatieuitvoerbare bestanden, kunnen worden gedownload van de CDN, wat een positief effect heeft op de prestaties en de belasting op uw SharePoint Online-site, zelfs als ze niet zo vaak worden gebruikt.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.

Prestatieverbetering per bestand is afhankelijk van een groot aantal factoren, waaronder de nabijheid van de client tot het dichtstbijzijnde CDN eindpunt, tijdelijke voorwaarden op het lokale netwerk, enzovoort.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. Veel statische bestanden zijn vrij klein en kunnen in minder dan Office 365 worden gedownload.Many static files are quite small, and can be downloaded from Office 365 in less than a second. Een webpagina kan echter veel ingesloten bestanden bevatten met een cumulatieve downloadtijd van enkele seconden.However, a web page may contain many embedded files with a cumulative download time of several seconds. Als u deze bestanden vanuit de CDN kunt u de totale laadtijd van de pagina aanzienlijk verminderen.Serving these files from the CDN can significantly reduce the overall page load time. Zie Welke prestatiewinst levert een CDN? voor een voorbeeld.See What performance gains does a CDN provide? for an example.

Bepalen waar u uw assets wilt opslaanDetermine where you want to store your assets

De CDN haalt uw activa op van een locatie die een origin wordt genoemd.The CDN fetches your assets from a location called an origin. Een origin kan een SharePoint site, documentbibliotheek of map zijn die toegankelijk is via een URL.An origin can be a SharePoint site, document library or folder that is accessible by a URL. U hebt grote flexibiliteit wanneer u origins voor uw organisatie opgeeft.You have great flexibility when you specify origins for your organization. U kunt bijvoorbeeld meerdere origins of één origin opgeven waar u al uw CDN wilt plaatsen.For example, you can specify multiple origins or a single origin where you want to put all your CDN assets. U kunt ervoor kiezen om zowel openbare als persoonlijke origins voor uw organisatie te hebben.You can choose to have both public or private origins for your organization. De meeste organisaties kiezen ervoor om een combinatie van de twee te implementeren.Most organizations will choose to implement a combination of the two.

U kunt nieuwe containers maken voor uw origins, zoals mappen of documentbibliotheken, en bestanden toevoegen die u beschikbaar wilt maken vanaf de 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. Dit is een goede methode als u een specifieke set activa hebt die u beschikbaar wilt hebben in de CDN en u de set CDN-assets wilt beperken tot alleen die bestanden in de container.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.

U kunt ook een bestaande siteverzameling, site, bibliotheek of map configureren als origin, zodat alle in aanmerking komende activa in de container beschikbaar zijn vanaf de 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. Voordat u een bestaande container als origin toevoegt, is het belangrijk dat u op de hoogte bent van de inhoud en machtigingen, zodat u activa niet per ongeluk blootstelt aan anonieme toegang of niet-geautoriseerde gebruikers.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.

U kunt een CDN definiëren om inhoud in uw origins uit te sluiten van de CDN.You can define CDN policies to exclude content in your origins from the CDN. CDN beleidsregels sluiten activa in openbare of privé-origins uit op basis van kenmerken zoals bestandstype en siteclassificatie en worden toegepast op alle origins van het CdnType (privé of openbaar) dat u opgeeft in het beleid. 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. Als u bijvoorbeeld een privé-origin toevoegt die bestaat uit een site die meerdere subsites bevat, kunt u een beleid definiëren om sites uit te sluiten die zijn gemarkeerd als Vertrouwelijk, zodat inhoud van sites met die classificatie wordt toegepast, niet wordt gebruikt vanaf de 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. Het beleid is van toepassing op inhoud van alle persoonlijke origins die u hebt toegevoegd aan de CDN.The policy will apply to content from all private origins you have added to the CDN.

Houd er rekening mee dat hoe groter het aantal origins, hoe groter de impact op de tijd die de service CDN om aanvragen te verwerken.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. U wordt aangeraden het aantal origins zo veel mogelijk te beperken.We recommend that you limit the number of origins as much as possible.

Kies of elke origin openbaar of privé moet zijnChoose whether each origin should be public or private

Wanneer u een origin identificeert, geeft u aan of deze openbaar of privé moet worden gemaakt.When you identify an origin, you specify whether it should be made public or private. Toegang tot CDN activa in openbare origins is anoniem en CDN inhoud in privé-origins wordt beveiligd door dynamisch gegenereerde tokens voor meer beveiliging.Access to CDN assets in public origins is anonymous, and CDN content in private origins is secured by dynamically generated tokens for greater security. Ongeacht welke optie u kiest, Microsoft doet al het zware werk voor u als het gaat om het beheer van de CDN zelf.Regardless of which option you choose, Microsoft does all the heavy lifting for you when it comes to administration of the CDN itself. U kunt ook later van gedachten veranderen nadat u de CDN hebt ingesteld en uw origins hebt geïdentificeerd.Also, you can change your mind later, after you've set up the CDN and identified your origins.

Openbare en private opties bieden vergelijkbare prestatieverbeteringen, maar elk heeft unieke kenmerken en voordelen.Both public and private options provide similar performance gains, but each has unique attributes and advantages.

Openbare origins binnen de Office 365 CDN zijn anoniem toegankelijk en gehoste assets kunnen worden gebruikt door iedereen die de URL van het activum heeft.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. Omdat toegang tot inhoud in openbare origins anoniem is, moet u deze alleen gebruiken om niet-gevoelige algemene inhoud in de cache op te slaan, zoals JavaScript-bestanden, scripts, pictogrammen en afbeeldingen.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.

Privé-origins binnen de Office 365 CDN bieden persoonlijke toegang tot gebruikersinhoud, zoals SharePoint Online-documentbibliotheken, sites en eigen afbeeldingen.Private origins within the Office 365 CDN provide private access to user content such as SharePoint Online document libraries, sites and proprietary images. Toegang tot inhoud in privé-origins wordt beveiligd door dynamisch gegenereerde tokens, zodat deze alleen toegankelijk is voor gebruikers met machtigingen voor de oorspronkelijke documentbibliotheek of opslaglocatie.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. Privé-origins in de Office 365 CDN kunnen alleen worden gebruikt voor SharePoint Online-inhoud en u hebt alleen toegang tot activa in privé-origins via omleiding vanuit uw SharePoint Online-tenant.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.

U kunt meer informatie lezen over hoe CDN toegang tot activa in een persoonlijke origin werkt in Assets gebruiken in private origins.You can read more about how CDN access to assets in a private origin works in Using assets in private origins.

Kenmerken en voordelen van het hosten van activa in openbare originsAttributes and advantages of hosting assets in public origins

  • Activa die in een openbare origin worden getoond, zijn anoniem toegankelijk voor iedereen.Assets exposed in a public origin are accessible by everyone anonymously.

    Belangrijk

    U mag nooit resources plaatsen die gebruikersgegevens bevatten of die als gevoelig voor uw organisatie worden beschouwd in een openbare origin.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

  • Als u een activum uit een openbare origin verwijdert, is het activum mogelijk nog maximaal 30 dagen beschikbaar in de cache. De koppelingen naar het activum worden binnen 15 minuten CDN ongeldig.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.

  • Wanneer u stijlbladen (CSS-bestanden) host in een openbare origin, kunt u relatieve paden en URL's binnen de code gebruiken.When you host style sheets (CSS files) in a public origin, you can use relative paths and URIs within the code. Dit betekent dat u kunt verwijzen naar de locatie van achtergrondafbeeldingen en andere objecten ten opzichte van de locatie van het activum dat de activum aanroept.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.

  • Hoewel u de URL van een openbare origin kunt maken, moet u voorzichtig te werk gaan en ervoor zorgen dat u de context-eigenschap pagina gebruikt en de richtlijnen volgt om dit te doen.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. De reden hiervoor is dat als de toegang tot de CDN niet beschikbaar wordt, de URL niet automatisch wordt opgelost voor uw organisatie in SharePoint Online en kan leiden tot verbroken koppelingen en andere fouten.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. De URL kan ook worden gewijzigd. Daarom moet de URL niet alleen hard worden gecodeerd naar de huidige waarde.The URL is also subject to change which is why it should not just be hard coded to its current value.

  • De standaardbestandstypen die zijn opgenomen voor openbare origins zijn .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff en .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. U kunt extra bestandstypen opgeven.You can specify additional file types.

  • U kunt een beleid configureren om activa uit te sluiten die zijn geïdentificeerd met siteclassificaties die u opgeeft.You can configure a policy to exclude assets that have been identified by site classifications that you specify. U kunt er bijvoorbeeld voor kiezen om alle activa uit te sluiten die zijn gemarkeerd als 'vertrouwelijk' of 'beperkt', zelfs als ze een toegestaan bestandstype zijn en zich in een openbare origin bevinden.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.

Kenmerken en voordelen van hostingactiva in privé-originsAttributes and advantages of hosting assets in private origins

  • Privé-origins kunnen alleen worden gebruikt voor SharePoint onlineactiva.Private origins can only be used for SharePoint Online assets.

  • Gebruikers hebben alleen toegang tot de assets van een persoonlijke origin als ze machtigingen hebben voor toegang tot de container.Users can only access the assets from a private origin if they have permissions to access the container. Anonieme toegang tot deze activa wordt voorkomen.Anonymous access to these assets is prevented.

  • Activa in privé-origins moeten worden verwezen vanuit de SharePoint Online-tenant.Assets in private origins must be referred from the SharePoint Online tenant. Directe toegang tot privé-CDN werkt niet.Direct access to private CDN assets does not work.

  • Als u een activum uit de privé-origin verwijdert, is het activum mogelijk nog maximaal een uur beschikbaar in de cache. We zullen echter binnen 15 minuten na de verwijdering van het activum koppelingen naar het activum in CDN ongeldig maken.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.

  • De standaardbestandstypen die zijn opgenomen voor privé-origins zijn .gif, .ico, .jpeg, .jpg, .js en .png.The default file types that are included for private origins are .gif, .ico, .jpeg, .jpg, .js, and .png. U kunt extra bestandstypen opgeven.You can specify additional file types.

  • Net als bij openbare origins kunt u een beleid configureren om activa uit te sluiten die zijn geïdentificeerd met siteclassificaties die u opgeeft, zelfs als u jokertekens gebruikt om alle activa in een map of documentbibliotheek op te nemen.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.

Zie Content Delivery Networksvoor meer informatie over Office 365 CDN, algemene CDN concepten en andere Microsoft CDN's die u kunt gebruiken met uw Office 365 tenant.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.

Standaard CDN originsDefault CDN origins

Tenzij u anders opgeeft, Office 365 u een aantal standaard origins voor u in wanneer u de Office 365 CDN.Unless you specify otherwise, Office 365 sets up some default origins for you when you enable the Office 365 CDN. Als u er in eerste instantie voor kiest om deze niet in te stellen, kunt u deze origins toevoegen nadat u de installatie hebt voltooid.If you initially opt not to provision them, you can add these origins after you complete setup. Tenzij u de gevolgen begrijpt van het overslaan van de instelling van standaard origins en hiervoor een specifieke reden hebt, moet u toestaan dat deze worden gemaakt wanneer u de 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.

Standaardinstellingen CDN privé-origins:Default private CDN origins:

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

Standaard openbare CDN origins:Default public CDN origins:

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

Notitie

clientsideassets is een standaard openbare origin die in december 2017 is toegevoegd aan de Office 365 CDN service.clientsideassets is a default public origin that was added to the Office 365 CDN service in December 2017. Deze origin moet aanwezig zijn om te kunnen SharePoint Framework oplossingen in de CDN werken.This origin must be present in order for SharePoint Framework solutions in the CDN to work. Als u de Office 365 CDN hebt ingeschakeld vóór december 2017 of als u de installatie van standaard origins hebt overgeslagen toen u de CDN inschakelen, kunt u deze origin handmatig toevoegen.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. Zie Mijn webonderdeel aan de clientzijde ofSharePoint Framework oplossing werkt niet voor meer informatie.For more information, see My client-side web part or SharePoint Framework solution isn't working.

De Office 365 CDN instellen en configureren met de SharePoint Online Management ShellSet up and configure the Office 365 CDN by using the SharePoint Online Management Shell

Voor de procedures in deze sectie moet u de SharePoint Online Management Shell gebruiken om verbinding te maken met SharePoint Online.The procedures in this section require you to use the SharePoint Online Management Shell to connect to SharePoint Online. Zie voor instructies Verbinding maken SharePoint Online PowerShell.For instructions, see Connect to SharePoint Online PowerShell.

Voltooi deze stappen voor het instellen en configureren van de CDN om uw assets te hosten in SharePoint Online met behulp van SharePoint Online Management Shell.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the SharePoint Online Management Shell.

Klik om uit te vouwenClick to expand

Uw organisatie in staat stellen de Office 365 CDNEnable your organization to use the Office 365 CDN

Voordat u wijzigingen aan de tenantinstellingen CDN, moet u de huidige status van de privé-CDN in uw Office 365 tenant.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. Verbinding maken naar uw tenant met behulp van SharePoint Online Management Shell:Connect to your tenant using the SharePoint Online Management Shell:

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

Gebruik nu de cmdlet Get-SPOTenantCdnEnabled om de CDN statusinstellingen van de tenant op te halen:Now use the Get-SPOTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

De status van de CDN voor het opgegeven CdnType wordt naar het scherm uitgevoerd.The status of the CDN for the specified CdnType will output to the screen.

Gebruik de cmdlet Set-SPOTenantCdnEnabled om uw organisatie in staat te stellen de Office 365 CDN.Use the Set-SPOTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. U kunt uw organisatie in staat stellen om openbare origins, privé-origins of beide tegelijk te gebruiken.You can enable your organization to use public origins, private origins, or both at once. U kunt de CDN ook zo configureren dat de instelling van standaard origins wordt overgeslagen wanneer u deze inschakelen.You can also configure the CDN to skip the setup of default origins when you enable it. U kunt deze origins altijd later toevoegen, zoals in dit onderwerp wordt beschreven.You can always add these origins later as described in this topic.

In Windows PowerShell voor SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Als u bijvoorbeeld wilt dat uw organisatie zowel openbare als privé-origins kan gebruiken, typt u de volgende opdracht:For example, to enable your organization to use both public and private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Als u wilt dat uw organisatie zowel openbare als persoonlijke origins kan gebruiken, maar het instellen van de standaard origins wilt overslaan, typt u de volgende opdracht: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

Zie Standaard CDN origins voor informatie over de origins die standaard zijn ingericht wanneer u de Office 365 CDN inschakelen, en de mogelijke impact van het overslaan van de instelling van standaard 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.

Als u wilt dat uw organisatie openbare origins kan gebruiken, typt u de volgende opdracht:To enable your organization to use public origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Als u wilt dat uw organisatie persoonlijke origins kan gebruiken, typt u de volgende opdracht:To enable your organization to use private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Zie Set-SPOTenantCdnEnabled voormeer informatie over deze cmdlet.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

De lijst met bestandstypen wijzigen die u wilt opnemen in de Office 365 CDN (Optioneel)Change the list of file types to include in the Office 365 CDN (Optional)

Tip

Wanneer u bestandstypen definieert met de cmdlet Set-SPOTenantCdnPolicy, overschrijft u de lijst die momenteel is gedefinieerd.When you define file types by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Als u extra bestandstypen aan de lijst wilt toevoegen, gebruikt u de cmdlet eerst om te kijken welke bestandstypen al zijn toegestaan en deze samen met de nieuwe bestandstypen in de lijst op te nemen.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.

Gebruik de cmdlet Set-SPOTenantCdnPolicy om statische bestandstypen te definiëren die kunnen worden gehost door openbare en private origins in de CDN.Use the Set-SPOTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Standaard zijn veelgebruikte activatypen toegestaan, zoals .css, .gif, .jpg en .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

In Windows PowerShell voor SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Als u bijvoorbeeld de CDN css en .png wilt hosten, voert u de opdracht in: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"

Gebruik de cmdlet Get-SPOTenantCdnPolicies om te zien welke bestandstypen momenteel door de CDN zijn toegestaan:To see what file types are currently allowed by the CDN, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Zie Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies (Set-SPOTenantCdnPolicy en Get-SPOTenantCdnPolicies)voor meer informatie over deze cmdlets.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

De lijst met siteclassificaties wijzigen die u wilt uitsluiten van de Office 365 CDN (Optioneel)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tip

Wanneer u siteclassificaties uitsluit met de cmdlet Set-SPOTenantCdnPolicy, overschrijft u de lijst die momenteel is gedefinieerd.When you exclude site classifications by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Als u extra siteclassificaties wilt uitsluiten, gebruikt u de cmdlet eerst om te kijken welke classificaties al zijn uitgesloten en voegt u deze vervolgens samen met de nieuwe toe.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.

Gebruik de cmdlet Set-SPOTenantCdnPolicy om siteclassificaties uit te sluiten die u niet beschikbaar wilt maken in de CDN.Use the Set-SPOTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Standaard worden geen siteclassificaties uitgesloten.By default, no site classifications are excluded.

In Windows PowerShell voor SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Als u wilt zien welke siteclassificaties momenteel zijn beperkt, gebruikt u de cmdlet Get-SPOTenantCdnPolicies:To see what site classifications are currently restricted, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

De eigenschappen die worden geretourneerd, zijn IncludeFileExtensions, ExcludeRestrictedSiteClassifications en ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

De eigenschap IncludeFileExtensions bevat de lijst met bestandsextensies die vanaf de CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Notitie

De standaardbestandsextensies verschillen tussen openbaar en privé.The default file extensions are different between public and private.

De eigenschap ExcludeRestrictedSiteClassifications bevat de siteclassificaties die u wilt uitsluiten van de CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. U kunt bijvoorbeeld sites uitsluiten die zijn gemarkeerd als Vertrouwelijk, zodat inhoud van sites met die classificatie die is toegepast, niet wordt gebruikt vanaf de 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.

De eigenschap ExcludeIfNoScriptDisabled sluit inhoud uit van de CDN op basis van de noScript-kenmerkinstellingen op siteniveau.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Het kenmerk NoScript is standaard ingesteld op Ingeschakeld voor moderne sites en Uitgeschakeld voor klassieke sites.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Dit is afhankelijk van uw tenantinstellingen.This depends on your tenant settings.

Zie Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies (Set-SPOTenantCdnPolicy en Get-SPOTenantCdnPolicies)voor meer informatie over deze cmdlets.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Een origin toevoegen voor uw activaAdd an origin for your assets

Gebruik de cmdlet Add-SPOTenantCdnOrigin om een origin te definiëren.Use the Add-SPOTenantCdnOrigin cmdlet to define an origin. U kunt meerdere origins definiëren.You can define multiple origins. De origin is een URL die wijst naar een SharePoint of map die de assets bevat die u wilt hosten door de 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.

Belangrijk

U mag nooit resources plaatsen die gebruikersgegevens bevatten of die als gevoelig voor uw organisatie worden beschouwd in een openbare origin.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>

De waarde van pad is het relatieve pad naar de bibliotheek of map die de assets bevat.The value of path is the relative path to the library or folder that contains the assets. U kunt jokertekens gebruiken naast relatieve paden.You can use wildcards in addition to relative paths. Origins ondersteunt jokertekens die zijn voorbereid op de URL.Origins support wildcards prepended to the URL. Op deze manier kunt u origins maken die meerdere sites bespannen.This allows you to create origins that span multiple sites. Als u bijvoorbeeld alle assets wilt opnemen in de map met basispagina's voor al uw sites als openbare origin in de CDN, typt u de volgende opdracht: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
  • De jokertekenmodule * kan alleen worden gebruikt aan het begin van het pad en komt overeen met alle URL-segmenten / onder de opgegeven URL.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Het pad kan naar een documentbibliotheek, map of site wijzen.The path can point to a document library, folder or site. Het pad */site1 komt bijvoorbeeld overeen met alle documentbibliotheken onder de site.For example, the path */site1 will match all the document libraries under the site.

U kunt een origin toevoegen met een specifiek relatieve pad.You can add an origin with a specific relative path. U kunt geen origin toevoegen met het volledige pad.You cannot add an origin using the full path.

In dit voorbeeld wordt een persoonlijke origin van de siteassetsbibliotheek op een specifieke site toegevoegd:This example adds a private origin of the siteassets library on a specific site:

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

In dit voorbeeld wordt een persoonlijke origin van de map1 toegevoegd aan de siteactivabibliotheek van de siteverzameling: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

Als er een spatie in het pad is, kunt u het pad omringen met dubbele aanhalingstekens of de spatie vervangen door de URL-codering %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. In de volgende voorbeelden wordt een persoonlijke origin van de map 1 in de siteactivabibliotheek van de siteverzameling toegevoegd: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"

Zie Add-SPOTenantCdnOrigin (Add-SPOTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Notitie

In privé-origins moeten activa die vanaf een origin worden gedeeld, een hoofdversie hebben gepubliceerd voordat ze vanaf de CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een openbare origin configureren voor uw basispagina's en voor uw stijlbibliotheek voor SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normaal gesproken worden deze origins standaard voor u ingesteld wanneer u de Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Als u ze echter handmatig wilt inschakelen, volgt u deze stappen.However, if you want to enable them manually, follow these steps.

  • Gebruik de cmdlet Add-SPOTenantCdnOrigin om de stijlbibliotheek te definiëren als een openbare origin.Use the Add-SPOTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Gebruik de cmdlet Add-SPOTenantCdnOrigin om de basispagina's te definiëren als een openbare origin.Use the Add-SPOTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Zie Add-SPOTenantCdnOrigin (Add-SPOTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een persoonlijke origin configureren voor uw siteactiva, sitepagina's en publicerende afbeeldingen voor SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Gebruik de cmdlet Add-SPOTenantCdnOrigin om de map met siteactiva te definiëren als een persoonlijke origin.Use the Add-SPOTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Gebruik de cmdlet Add-SPOTenantCdnOrigin om de map sitepagina's te definiëren als een persoonlijke origin.Use the Add-SPOTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Gebruik de cmdlet Add-SPOTenantCdnOrigin om de map met publicatieafbeeldingen te definiëren als een persoonlijke origin.Use the Add-SPOTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Zie Add-SPOTenantCdnOrigin (Add-SPOTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een persoonlijke origin configureren voor een siteverzameling voor SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Gebruik de cmdlet Add-SPOTenantCdnOrigin om een siteverzameling te definiëren als een persoonlijke origin.Use the Add-SPOTenantCdnOrigin cmdlet to define a site collection as a private origin. Bijvoorbeeld:For example:

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

Zie Add-SPOTenantCdnOrigin (Add-SPOTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Mogelijk ziet u een bericht in behandeling met configuratie dat wordt verwacht wanneer de SharePoint Online-tenant verbinding maakt met de CDN service.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

De Office 365 CDNManage the Office 365 CDN

Nadat u de CDN hebt ingesteld, kunt u wijzigingen aanbrengen in uw configuratie terwijl u inhoud bij werk of als uw behoeften veranderen, zoals in deze sectie wordt beschreven.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.

Activa toevoegen, bijwerken of verwijderen uit de Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Nadat u de installatiestappen hebt voltooid, kunt u nieuwe activa toevoegen en bestaande assets bijwerken of verwijderen wanneer u maar wilt.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Pas uw wijzigingen aan in de assets in de map of SharePoint bibliotheek die u hebt geïdentificeerd als een origin.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Als u een nieuw activum toevoegt, is deze direct beschikbaar via CDN.If you add a new asset, it is available through the CDN immediately. Als u het activum echter bij werkt, duurt het maximaal 15 minuten voordat de nieuwe kopie wordt doorgegeven en beschikbaar komt in de CDN.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.

Als u de locatie van de origin wilt ophalen, kunt u de cmdlet Get-SPOTenantCdnOrigins gebruiken.If you need to retrieve the location of the origin, you can use the Get-SPOTenantCdnOrigins cmdlet. Zie Get-SPOTenantCdnOriginsvoor meer informatie over het gebruik van deze cmdlet.For information on how to use this cmdlet, see Get-SPOTenantCdnOrigins.

Een origin verwijderen uit de Office 365 CDNRemove an origin from the Office 365 CDN

U kunt de toegang tot een map of bibliotheek SharePoint verwijderen die u hebt geïdentificeerd als een origin.You can remove access to a folder or SharePoint library that you identified as an origin. Gebruik hiervoor de cmdlet Remove-SPOTenantCdnOrigin.To do this, use the Remove-SPOTenantCdnOrigin cmdlet.

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

Zie Remove-SPOTenantCdnOrigin (Verwijderen-SPOTenantCdnOrigin)voor meer informatie over het gebruik van deze cmdlet.For information on how to use this cmdlet, see Remove-SPOTenantCdnOrigin.

Een origin in de Office 365 CDNModify an origin in the Office 365 CDN

U kunt een origin die u hebt gemaakt niet wijzigen.You cannot modify an origin you've created. In plaats daarvan verwijdert u de origin en voegt u een nieuwe toe.Instead, remove the origin and then add a new one. Zie Een origin verwijderen uit de Office 365 CDN en Een origin toevoegen voor uw assets voor meer informatie.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

De Office 365 CDNDisable the Office 365 CDN

Gebruik de cmdlet Set-SPOTenantCdnEnabled om de CDN voor uw organisatie uit te schakelen.Use the Set-SPOTenantCdnEnabled cmdlet to disable the CDN for your organization. Als u zowel de openbare als de privé-origins hebt ingeschakeld voor de CDN, moet u de cmdlet tweemaal uitvoeren, zoals wordt weergegeven in de volgende voorbeelden.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.

Als u het gebruik van openbare origins in de CDN wilt uitschakelen, voert u de volgende opdracht in:To disable use of public origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Als u het gebruik van de privé-origins in de CDN wilt uitschakelen, voert u de volgende opdracht in:To disable use of the private origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Zie Set-SPOTenantCdnEnabled voormeer informatie over deze cmdlet.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

De Office 365 CDN instellen en configureren met PnP PowerShellSet up and configure the Office 365 CDN by using PnP PowerShell

Voor de procedures in deze sectie moet u PnP PowerShell gebruiken om verbinding te maken met SharePoint Online.The procedures in this section require you to use PnP PowerShell to connect to SharePoint Online. Zie Aan de slag met PnP PowerShellvoor instructies.For instructions, see Getting started with PnP PowerShell.

Voltooi deze stappen voor het instellen en configureren van de CDN om uw assets te hosten in SharePoint Online met PnP PowerShell.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using PnP PowerShell.

Klik om uit te vouwenClick to expand

Uw organisatie in staat stellen de Office 365 CDNEnable your organization to use the Office 365 CDN

Voordat u wijzigingen aan de tenantinstellingen CDN, moet u de huidige status van de privé-CDN in uw Office 365 tenant.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. Verbinding maken met PnP PowerShell naar uw tenant:Connect to your tenant using PnP PowerShell:

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

Gebruik nu de cmdlet Get-PnPTenantCdnEnabled om de statusinstellingen CDN de tenant op te halen:Now use the Get-PnPTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

De status van de CDN voor het opgegeven CdnType wordt naar het scherm uitgevoerd.The status of the CDN for the specified CdnType will output to the screen.

Gebruik de cmdlet Set-PnPTenantCdnEnabled om uw organisatie in staat te stellen de Office 365 CDN.Use the Set-PnPTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. U kunt uw organisatie inschakelen om tegelijk gebruik te maken van openbare origins, privé-origins of beide.You can enable your organization to use public origins, private origins, or both at at the same time. U kunt de CDN ook zo configureren dat de instelling van standaard origins wordt overgeslagen wanneer u deze inschakelen.You can also configure the CDN to skip the setup of default origins when you enable it. U kunt deze origins altijd later toevoegen, zoals in dit onderwerp wordt beschreven.You can always add these origins later as described in this topic.

In PnP PowerShell:In PnP PowerShell:

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

Als u bijvoorbeeld wilt dat uw organisatie zowel openbare als privé-origins kan gebruiken, typt u de volgende opdracht:For example, to enable your organization to use both public and private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Als u wilt dat uw organisatie zowel openbare als persoonlijke origins kan gebruiken, maar het instellen van de standaard origins wilt overslaan, typt u de volgende opdracht: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

Zie Standaard CDN origins voor informatie over de origins die standaard zijn ingericht wanneer u de Office 365 CDN inschakelen, en de mogelijke impact van het overslaan van de instelling van standaard 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.

Als u wilt dat uw organisatie openbare origins kan gebruiken, typt u de volgende opdracht:To enable your organization to use public origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Als u wilt dat uw organisatie persoonlijke origins kan gebruiken, typt u de volgende opdracht:To enable your organization to use private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Zie Set-PnPTenantCdnEnabled voor meer informatie over deze cmdlet.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

De lijst met bestandstypen wijzigen die u wilt opnemen in de Office 365 CDN (Optioneel)Change the list of file types to include in the Office 365 CDN (Optional)

Tip

Wanneer u bestandstypen definieert met de cmdlet Set-PnPTenantCdnPolicy, overschrijft u de momenteel gedefinieerde lijst.When you define file types by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Als u extra bestandstypen aan de lijst wilt toevoegen, gebruikt u de cmdlet eerst om te kijken welke bestandstypen al zijn toegestaan en deze samen met de nieuwe bestandstypen in de lijst op te nemen.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.

Gebruik de cmdlet Set-PnPTenantCdnPolicy om statische bestandstypen te definiëren die kunnen worden gehost door openbare en private origins in de CDN.Use the Set-PnPTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Standaard zijn veelgebruikte activatypen toegestaan, zoals .css, .gif, .jpg en .js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

In PnP PowerShell:In PnP PowerShell:

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

Als u bijvoorbeeld de CDN css en .png wilt hosten, voert u de opdracht in: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"

Gebruik de cmdlet Get-PnPTenantCdnPolicies om te zien welke bestandstypen momenteel door de CDN zijn toegestaan:To see what file types are currently allowed by the CDN, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Zie Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies (Set-PnPTenantCdnPolicy en Get-PnPTenantCdnPolicies)voor meer informatie over deze cmdlets.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

De lijst met siteclassificaties wijzigen die u wilt uitsluiten van de Office 365 CDN (Optioneel)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tip

Wanneer u siteclassificaties uitsluit met de cmdlet Set-PnPTenantCdnPolicy, overschrijft u de momenteel gedefinieerde lijst.When you exclude site classifications by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Als u extra siteclassificaties wilt uitsluiten, gebruikt u de cmdlet eerst om te kijken welke classificaties al zijn uitgesloten en voegt u deze vervolgens samen met de nieuwe toe.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.

Gebruik de cmdlet Set-PnPTenantCdnPolicy om siteclassificaties uit te sluiten die u niet beschikbaar wilt maken in de CDN.Use the Set-PnPTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Standaard worden geen siteclassificaties uitgesloten.By default, no site classifications are excluded.

In PnP PowerShell:In PnP PowerShell:

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

Als u wilt zien welke siteclassificaties momenteel zijn beperkt, gebruikt u de cmdlet Get-PnPTenantCdnPolicies:To see what site classifications are currently restricted, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

De eigenschappen die worden geretourneerd, zijn IncludeFileExtensions, ExcludeRestrictedSiteClassifications en ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

De eigenschap IncludeFileExtensions bevat de lijst met bestandsextensies die vanaf de CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Notitie

De standaardbestandsextensies verschillen tussen openbaar en privé.The default file extensions are different between public and private.

De eigenschap ExcludeRestrictedSiteClassifications bevat de siteclassificaties die u wilt uitsluiten van de CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. U kunt bijvoorbeeld sites uitsluiten die zijn gemarkeerd als Vertrouwelijk, zodat inhoud van sites met die classificatie die is toegepast, niet wordt gebruikt vanaf de 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.

De eigenschap ExcludeIfNoScriptDisabled sluit inhoud uit van de CDN op basis van de noScript-kenmerkinstellingen op siteniveau.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Het kenmerk NoScript is standaard ingesteld op Ingeschakeld voor moderne sites en Uitgeschakeld voor klassieke sites.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Dit is afhankelijk van uw tenantinstellingen.This depends on your tenant settings.

Zie Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies (Set-PnPTenantCdnPolicy en Get-PnPTenantCdnPolicies)voor meer informatie over deze cmdlets.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Een origin toevoegen voor uw activaAdd an origin for your assets

Gebruik de cmdlet Add-PnPTenantCdnOrigin om een origin te definiëren.Use the Add-PnPTenantCdnOrigin cmdlet to define an origin. U kunt meerdere origins definiëren.You can define multiple origins. De origin is een URL die wijst naar een SharePoint of map die de assets bevat die u wilt hosten door de 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.

Belangrijk

U mag nooit resources plaatsen die gebruikersgegevens bevatten of die als gevoelig voor uw organisatie worden beschouwd in een openbare origin.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>

De waarde van pad is het relatieve pad naar de bibliotheek of map die de assets bevat.The value of path is the relative path to the library or folder that contains the assets. U kunt jokertekens gebruiken naast relatieve paden.You can use wildcards in addition to relative paths. Origins ondersteunt jokertekens die zijn voorbereid op de URL.Origins support wildcards prepended to the URL. Op deze manier kunt u origins maken die meerdere sites bespannen.This allows you to create origins that span multiple sites. Als u bijvoorbeeld alle assets wilt opnemen in de map met basispagina's voor al uw sites als openbare origin in de CDN, typt u de volgende opdracht: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
  • De jokertekenmodule * kan alleen worden gebruikt aan het begin van het pad en komt overeen met alle URL-segmenten / onder de opgegeven URL.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Het pad kan naar een documentbibliotheek, map of site wijzen.The path can point to a document library, folder or site. Het pad */site1 komt bijvoorbeeld overeen met alle documentbibliotheken onder de site.For example, the path */site1 will match all the document libraries under the site.

U kunt een origin toevoegen met een specifiek relatieve pad.You can add an origin with a specific relative path. U kunt geen origin toevoegen met het volledige pad.You cannot add an origin using the full path.

In dit voorbeeld wordt een persoonlijke origin van de siteactivabibliotheek op een specifieke site toegevoegd:This example adds a private origin of the site assets library on a specific site:

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

In dit voorbeeld wordt een persoonlijke origin van de map1 toegevoegd aan de siteactivabibliotheek van de siteverzameling: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

Als er een spatie in het pad is, kunt u het pad omringen met dubbele aanhalingstekens of de spatie vervangen door de URL-codering %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. In de volgende voorbeelden wordt een persoonlijke origin van de map 1 in de siteactivabibliotheek van de siteverzameling toegevoegd: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"

Zie Add-PnPTenantCdnOrigin (Add-PnPTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Notitie

In privé-origins moeten activa die vanaf een origin worden gedeeld, een hoofdversie hebben gepubliceerd voordat ze vanaf de CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een openbare origin configureren voor uw basispagina's en voor uw stijlbibliotheek voor SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normaal gesproken worden deze origins standaard voor u ingesteld wanneer u de Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Als u ze echter handmatig wilt inschakelen, volgt u deze stappen.However, if you want to enable them manually, follow these steps.

  • Gebruik de cmdlet Add-PnPTenantCdnOrigin om de stijlbibliotheek te definiëren als een openbare origin.Use the Add-PnPTenantCdnOrigin cmdlet to define the style library as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
    
  • Gebruik de cmdlet Add-PnPTenantCdnOrigin om de basispagina's te definiëren als een openbare origin.Use the Add-PnPTenantCdnOrigin cmdlet to define the master pages as a public origin.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
    

Zie Add-PnPTenantCdnOrigin (Add-PnPTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een persoonlijke origin configureren voor uw siteactiva, sitepagina's en publicerende afbeeldingen voor SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Gebruik de cmdlet Add-PnPTenantCdnOrigin om de map met siteactiva te definiëren als een persoonlijke origin.Use the Add-PnPTenantCdnOrigin cmdlet to define the site assets folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
    
  • Gebruik de cmdlet Add-PnPTenantCdnOrigin om de map sitepagina's te definiëren als een persoonlijke origin.Use the Add-PnPTenantCdnOrigin cmdlet to define the site pages folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
    
  • Gebruik de cmdlet Add-PnPTenantCdnOrigin om de map publicerende afbeeldingen te definiëren als een persoonlijke origin.Use the Add-PnPTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
    

Zie Add-PnPTenantCdnOrigin (Add-PnPTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

Voorbeeld: Een persoonlijke origin configureren voor een siteverzameling voor SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Gebruik de cmdlet Add-PnPTenantCdnOrigin om een siteverzameling te definiëren als een persoonlijke origin.Use the Add-PnPTenantCdnOrigin cmdlet to define a site collection as a private origin. Bijvoorbeeld:For example:

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

Zie Add-PnPTenantCdnOrigin (Add-PnPTenantCdnOrigin)voor meer informatie over deze opdracht en de syntaxis ervan.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Wanneer u de opdracht hebt uitgevoerd, synchroniseert het systeem de configuratie in het datacenter.Once you've run the command, the system synchronizes the configuration across the datacenter. Mogelijk ziet u een bericht in behandeling met configuratie dat wordt verwacht wanneer de SharePoint Online-tenant verbinding maakt met de CDN service.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Dit kan maximaal 15 minuten duren.This can take up to 15 minutes.

De Office 365 CDNManage the Office 365 CDN

Nadat u de CDN hebt ingesteld, kunt u wijzigingen aanbrengen in uw configuratie terwijl u inhoud bij werk of als uw behoeften veranderen, zoals in deze sectie wordt beschreven.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.

Activa toevoegen, bijwerken of verwijderen uit de Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Nadat u de installatiestappen hebt voltooid, kunt u nieuwe activa toevoegen en bestaande assets bijwerken of verwijderen wanneer u maar wilt.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Pas uw wijzigingen aan in de assets in de map of SharePoint bibliotheek die u hebt geïdentificeerd als een origin.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Als u een nieuw activum toevoegt, is deze direct beschikbaar via CDN.If you add a new asset, it is available through the CDN immediately. Als u het activum echter bij werkt, duurt het maximaal 15 minuten voordat de nieuwe kopie wordt doorgegeven en beschikbaar komt in de CDN.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.

Als u de locatie van de origin wilt ophalen, kunt u de cmdlet Get-PnPTenantCdnOrigin gebruiken.If you need to retrieve the location of the origin, you can use the Get-PnPTenantCdnOrigin cmdlet. Zie Get-PnPTenantCdnOriginvoor meer informatie over het gebruik van deze cmdlet.For information on how to use this cmdlet, see Get-PnPTenantCdnOrigin.

Een origin verwijderen uit de Office 365 CDNRemove an origin from the Office 365 CDN

U kunt de toegang tot een map of bibliotheek SharePoint verwijderen die u hebt geïdentificeerd als een origin.You can remove access to a folder or SharePoint library that you identified as an origin. Gebruik hiervoor de cmdlet Remove-PnPTenantCdnOrigin.To do this, use the Remove-PnPTenantCdnOrigin cmdlet.

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

Zie Remove-PnPTenantCdnOrigin (Verwijderen-PnPTenantCdnOrigin)voor meer informatie over het gebruik van deze cmdlet.For information on how to use this cmdlet, see Remove-PnPTenantCdnOrigin.

Een origin in de Office 365 CDNModify an origin in the Office 365 CDN

U kunt een origin die u hebt gemaakt niet wijzigen.You cannot modify an origin you've created. In plaats daarvan verwijdert u de origin en voegt u een nieuwe toe.Instead, remove the origin and then add a new one. Zie Een origin verwijderen uit de Office 365 CDN en Een origin toevoegen voor uw assets voor meer informatie.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

De Office 365 CDNDisable the Office 365 CDN

Gebruik de cmdlet Set-PnPTenantCdnEnabled om de CDN voor uw organisatie uit te schakelen.Use the Set-PnPTenantCdnEnabled cmdlet to disable the CDN for your organization. Als u zowel de openbare als de privé-origins hebt ingeschakeld voor de CDN, moet u de cmdlet tweemaal uitvoeren, zoals wordt weergegeven in de volgende voorbeelden.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.

Als u het gebruik van openbare origins in de CDN wilt uitschakelen, voert u de volgende opdracht in:To disable use of public origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Als u het gebruik van de privé-origins in de CDN wilt uitschakelen, voert u de volgende opdracht in:To disable use of the private origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Zie Set-PnPTenantCdnEnabled voor meer informatie over deze cmdlet.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

De Office 365 CDN instellen en configureren met Office 365 CLISet up and configure the Office 365 CDN using the Office 365 CLI

Voor de procedures in deze sectie moet u de Office 365 CLI.The procedures in this section require that you have installed the Office 365 CLI. Maak vervolgens verbinding met uw Office 365 tenant met de opdracht Aanmelden.Next, connect to your Office 365 tenant using the login command.

Voltooi deze stappen voor het instellen en configureren van de CDN om uw assets te hosten in SharePoint Online met behulp van Office 365 CLI.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the Office 365 CLI.

Klik om uit te vouwenClick to expand

De Office 365 CDNEnable the Office 365 CDN

U kunt de status van de Office 365 CDN in uw tenant beheren met de opdracht SPO-cdn-set.You can manage the state of the Office 365 CDN in your tenant using the spo cdn set command.

Als u de Office 365 openbare CDN in uw tenant wilt inschakelen, voert u het volgende uit:To enable the Office 365 Public CDN in your tenant execute:

spo cdn set --type Public --enabled true

Voer de volgende Office 365 SharePoint CDN uit om de Office 365 SharePoint CDN in te stellen:To enable the Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

De huidige status van de Office 365 CDNView the current status of the Office 365 CDN

Als u wilt controleren of het specifieke type Office 365 CDN is ingeschakeld of uitgeschakeld, gebruikt u de opdracht spo cdn get.To check if the particular type of Office 365 CDN is enabled or disabled, use the spo cdn get command.

Als u wilt controleren of Office 365 openbare CDN is ingeschakeld, voert u het volgende uit:To check if the Office 365 Public CDN is enabled, execute:

spo cdn get --type Public

De oorspronkelijke Office 365 CDN weergevenView the Office 365 CDN origins

Als u de momenteel geconfigureerde Office 365 openbare CDN origins wilt weergeven:To view the currently configured Office 365 Public CDN origins execute:

spo cdn origin list --type Public

Zie Standaardinstellingen CDN origins voor informatie over de origins die standaard zijn ingericht wanneer u de Office 365 CDN.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Een oorspronkelijke Office 365 CDN toevoegenAdd an Office 365 CDN origin

Belangrijk

U mag resources die als gevoelig voor uw organisatie worden beschouwd, nooit in een SharePoint documentbibliotheek plaatsen die is geconfigureerd als een openbare origin.You should never place resources that are considered sensitive to your organization in a SharePoint document library configured as a public origin.

Gebruik de opdracht SPO CDN Origin Add om een CDN definiëren.Use the spo cdn origin add command to define a CDN origin. U kunt meerdere origins definiëren.You can define multiple origins. De origin is een URL die wijst naar een SharePoint of map die de assets bevat die u wilt hosten door de 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>

Waar path is het relatieve pad naar de map met de assets.Where path is the relative path to the folder that contains the assets. U kunt jokertekens gebruiken naast relatieve paden.You can use wildcards in addition to relative paths.

Als u alle activa in de galerie met basispagina's van alle sites wilt opnemen als openbare origin, voert u het volgende uit: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

Als u een persoonlijke origin wilt configureren voor een specifieke siteverzameling, voert u het volgende uit:To configure a private origin for a specific site collection, execute:

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

Notitie

Nadat u een CDN hebt toegevoegd, kan het tot 15 minuten duren voordat u bestanden kunt ophalen via de CDN service.After adding a CDN origin, it might take up to 15 minutes for you to be able to retrieve files via the CDN service. U kunt controleren of de specifieke origin al is ingeschakeld met de opdracht SPO CDN Origin List.You can verify if the particular origin has already been enabled using the spo cdn origin list command.

Een oorspronkelijke Office 365 CDN verwijderenRemove an Office 365 CDN origin

Gebruik de opdracht SPO CDN Origin Remove om een CDN voor het opgegeven CDN verwijderen.Use the spo cdn origin remove command to remove a CDN origin for the specified CDN type.

Als u een openbare origin wilt verwijderen uit de CDN configuratie, voert u het volgende uit:To remove a public origin from the CDN configuration, execute:

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

Notitie

Het verwijderen CDN origin heeft geen invloed op de bestanden die zijn opgeslagen in een documentbibliotheek die overeenkomt met die origin.Removing a CDN origin doesn't affect the files stored in any document library matching that origin. Als naar deze assets wordt verwezen met behulp van SharePoint URL, SharePoint automatisch terug naar de oorspronkelijke URL die naar de documentbibliotheek wijst.If these assets have been referenced using their SharePoint URL, SharePoint will automatically switch back to the original URL pointing to the document library. Als er echter naar activa is verwezen met een openbare CDN URL, wordt de koppeling door het verwijderen van de origin verwijderd en moet u deze handmatig wijzigen.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.

Een oorspronkelijke Office 365 CDN wijzigenModify an Office 365 CDN origin

Het is niet mogelijk om een bestaande CDN wijzigen.It's not possible to modify an existing CDN origin. In plaats daarvan moet u de eerder gedefinieerde origin CDN de opdracht verwijderen en een nieuwe met spo cdn origin remove de opdracht spo cdn origin add toevoegen.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.

De typen bestanden wijzigen die u wilt opnemen in de Office 365 CDNChange the types of files to include in the Office 365 CDN

Standaard worden de volgende bestandstypen opgenomen in de CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff en .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. Als u extra bestandstypen wilt opnemen in de CDN, kunt u de configuratie van de CDN wijzigen met de opdracht SPO CDN-beleidset.If you need to include additional file types in the CDN, you can change the CDN configuration using the spo cdn policy set command.

Notitie

Wanneer u de lijst met bestandstypen verandert, overschrijft u de lijst die momenteel is gedefinieerd.When changing the list of file types, you overwrite the currently defined list. Als u extra bestandstypen wilt opnemen, gebruikt u eerst de opdracht lijst met spo-cdn-beleid om erachter te komen welke bestandstypen momenteel zijn geconfigureerd.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.

Als u het JSON-bestandstype wilt toevoegen aan de standaardlijst met bestandstypen die zijn opgenomen in de openbare CDN voert u het volgende uit: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"

De lijst met siteclassificaties wijzigen die u wilt uitsluiten van de Office 365 CDNChange the list of site classifications you want to exclude from the Office 365 CDN

Gebruik de opdracht SPO CDN-beleidset om siteclassificaties uit te sluiten die u niet beschikbaar wilt maken in de CDN.Use the spo cdn policy set command to exclude site classifications that you do not want to make available over the CDN. Standaard worden geen siteclassificaties uitgesloten.By default, no site classifications are excluded.

Notitie

Wanneer u de lijst met uitgesloten siteclassificaties verandert, overschrijft u de lijst die momenteel is gedefinieerd.When changing the list of excluded site classifications, you overwrite the currently defined list. Als u extra classificaties wilt uitsluiten, gebruikt u eerst de opdracht SPO CDN-beleidlijst om te kijken welke classificaties momenteel zijn geconfigureerd.If you want to exclude additional classifications, first use the spo cdn policy list command to find out which classifications are currently configured.

Als u sites die als HBI zijn geclassificeerd, wilt uitsluiten van de openbare CDN, voert uTo exclude sites classified as HBI from the public CDN, execute

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

De Office 365 CDNDisable the Office 365 CDN

Als u de Office 365 CDN de opdracht spo cdn set wilt uitschakelen, bijvoorbeeld:To disable the Office 365 CDN use the spo cdn set command, for example:

spo cdn set --type Public --enabled false

Uw CDN gebruikenUsing your CDN assets

Nu u de oorspronkelijke CDN en geconfigureerde origins en beleidsregels hebt ingeschakeld, kunt u uw CDN gebruiken.Now that you have enabled the CDN and configured origins and policies, you can begin using your CDN assets.

In deze sectie krijgt u inzicht in het gebruik van CDN-URL's in uw SharePoint-pagina's en inhoud, zodat SharePoint aanvragen voor activa in zowel openbare als privé-origins omleiden naar de 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.

Zie het onderwerp Host your client-side web part from Office 365 CDN (Hello World part 4)voor informatie over het gebruik van de CDN voor het hosten van webonderdelen aan de clientzijde.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).

Notitie

Als u de map ClientSideAssets toevoegt aan de lijst met CDN-origins, kunnen CDN aangepaste webonderdelen niet worden weergegeven. If you add the ClientSideAssets folder to the private CDN origins list, CDN-hosted custom web parts will fail to render. Bestanden die door SPFX-webonderdelen worden gebruikt, kunnen alleen gebruikmaken van de openbare CDN en de map ClientSideAssets is een standaardinstelling voor openbare CDN.Files used by SPFX web parts can only utilize the public CDN and the ClientSideAssets folder is a default origin for public CDN.

Als u activa wilt gebruiken die u aan een origin hebt toegevoegd, kunt u koppelingen naar het oorspronkelijke bestand bijwerken met het pad naar het bestand in de origin.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.

  • Bewerk de pagina of inhoud die koppelingen bevat naar activa die u aan een origin hebt toegevoegd.Edit the page or content that contains links to assets you have added to an origin. U kunt ook een van de verschillende methoden gebruiken om wereldwijd koppelingen in een enter-site of siteverzameling te zoeken en te vervangen als u de koppeling naar een bepaald activum overal wilt bijwerken waar deze wordt weergegeven.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.
  • Vervang voor elke koppeling naar een activum in een origin het pad door het pad naar het bestand in de CDN origin.For each link to an asset in an origin, replace the path with the path to the file in the CDN origin. U kunt relatieve paden gebruiken.You can use relative paths.
  • Sla de pagina of inhoud op.Save the page or content.

Denk bijvoorbeeld aan de afbeelding /site/SiteAssets/images/image.png, die u hebt gekopieerd naar de map documentbibliotheek /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/. Als u de CDN wilt gebruiken, vervangt u het oorspronkelijke pad naar de locatie van het afbeeldingsbestand door het pad naar de origin om de nieuwe 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.

Als u de volledige URL naar het activum wilt gebruiken in plaats van een relatief pad, maakt u de koppeling als het volgende: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

Notitie

In het algemeen moet u URL's niet rechtstreeks hardcoderen naar activa in de CDN.In general, you should not hardcode URLs directly to assets in the CDN. U kunt echter indien nodig handmatig URL's maken voor activa in openbare origins.However, you can manually construct URLs for assets in public origins if needed. Zie Hardcoding CDN URL's voor openbare activa voor meer informatie.For more information, see Hardcoding CDN URLs for public assets.

Zie Hoe kan ik bevestigen dat activa worden beheerd door de CDN Office 365 CDN?in Problemen met de CDN voor meer informatie over het controleren of activa worden gebruikt vanuit de 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.

Activa gebruiken in openbare originsUsing assets in public origins

Met de functie Publiceren in SharePoint Online worden URL's van activa die zijn opgeslagen in openbare origins automatisch herschreven in hun CDN-equivalenten, zodat activa worden gebruikt vanuit de CDN-service in plaats van 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.

Als uw origin zich op een site met de functie Publiceren heeft ingeschakeld en de activa die u wilt overschrijven naar de CDN zich in een van de volgende categorieën plaatsen, worden INL's in SharePoint automatisch herschreven voor activa in de origin, mits het activum niet is uitgesloten door een CDN-beleid.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.

Hieronder volgt een overzicht van de koppelingen die automatisch worden herschreven door de SharePoint Publicatiefunctie:The following is an overview of which links are automatically rewritten by the SharePoint Publishing feature:

  • IMG/LINK/CSS-URL's in html-antwoorden voor klassieke publicatiepaginaIMG/LINK/CSS URLs in classic publishing page HTML responses
    • Dit omvat afbeeldingen die door auteurs zijn toegevoegd aan de HTML-inhoud van een paginaThis includes images added by authors within the HTML content of a page
  • AfbeeldingsbibliotheekDiavoorstelling webonderdeel AFBEELDING-URL'sPicture Library SlideShow webpart image URLs
  • Afbeeldingsvelden in SPList REST API (RenderListDataAsStream) resultatenImage fields in SPList REST API (RenderListDataAsStream) results
    • De nieuwe eigenschap ImageFieldsToTryRewriteToCdnUrls gebruiken om een door komma's gescheiden lijst met velden op te gevenUse the new property ImageFieldsToTryRewriteToCdnUrls to provide a comma separated list of fields
    • Ondersteunt hyperlinkvelden en PublishingImage-veldenSupports hyperlink fields and PublishingImage fields
  • SharePoint afbeeldingsweergavenSharePoint image renditions

In het volgende diagram wordt de werkstroom weergegeven wanneer SharePoint een aanvraag ontvangt voor een pagina met activa van een openbare origin.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a public origin.

Werkstroomdiagram: ophalen Office 365 CDN activa van een openbare originWorkflow diagram: Retrieving Office 365 CDN assets from a public origin

Tip

Als u automatisch herschrijven voor specifieke URL's op een pagina wilt uitschakelen, kunt u de pagina bekijken en de parameter queryreeks toevoegen? NoAutoReWrites=true aan het einde van elke koppeling die u wilt uitschakelen.If you want to disable auto-rewriting for specific URLs on a page, you can check out the page and add the query string parameter ?NoAutoReWrites=true to the end of each link you want to disable.

Url'CDN maken voor openbare activaConstructing CDN URLs for public assets

Als de publicatiefunctie niet is ingeschakeld voor een openbare origin of als het activum niet een van de koppelingstypen is die worden ondersteund door de functie voor automatisch herschrijven van de CDN-service, kunt u HANDMATIG URL's maken naar de CDN-locatie van de activa en deze URL's in uw inhoud gebruiken.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.

Notitie

U kunt url's niet hardcoderen of CDN maken voor activa in een persoonlijke origin, omdat het vereiste toegangs token dat de laatste sectie van de URL vormt, wordt gegenereerd op het moment dat de resource wordt aangevraagd.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. U kunt de URL voor openbare CDN maken en de URL mag niet moeilijk worden gecodeerd omdat deze onderhevig is aan wijziging.You can construct the URL for Public CDN and the URL should not be hard coded as it is subject to change.

Voor openbare CDN ziet de URL-indeling er als volgt uit:For public CDN assets, the URL format will look like the following:

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

Vervang TenantHostName door uw tenantnaam.Replace TenantHostName with your tenant name. Voorbeeld:Example:

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

Notitie

De paginacontext-eigenschap moet worden gebruikt om het voorvoegsel te maken in plaats van hardcoderen " https://publiccdn.sharepointonline.com ".The page context property should be used to construct the prefix instead of hard coding "https://publiccdn.sharepointonline.com". De URL kan worden gewijzigd en mag niet hard worden gecodeerd.The URL is subject to change and should not be hard coded. Als u weergavesjablonen gebruikt met Classic SharePoint Online, kunt u de eigenschap 'window._spPageContextInfo.publicCdnBaseUrl' gebruiken in de weergavesjabloon voor het voorvoegsel van de 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. Als u SPFx voor moderne en klassieke SharePoint kunt u de eigenschap 'this.context.pageContext.legacyPageContext.publicCdnBaseUrl' gebruiken.If you are SPFx web parts for modern and classic SharePoint the you can utilize the property "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Dit geeft het voorvoegsel op, zodat als het wordt gewijzigd, de implementatie wordt bijgewerkt.This will provide the prefix so that if it is changed then your implementation will update with it. Als voorbeeld voor SPFx kan de URL worden gemaakt met de eigenschap '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". Zie Gebruik CDN in clientcode die deel uitmaakt van de prestatiereeks seizoen 1Please see Using CDN in Client-side code which is part of the season 1 performance series

Activa in privé-origins gebruikenUsing assets in private origins

Er is geen extra configuratie vereist voor het gebruik van activa in privé-origins.No additional configuration is required to use assets in private origins. SharePoint Online herschrijft automatisch URL's voor activa in privé-origins, zodat aanvragen voor deze activa altijd vanaf de CDN.SharePoint Online automatically rewrites URLs for assets in private origins so requests for those assets will always be served from the CDN. U kunt URL's niet handmatig maken voor CDN-assets in privé-origins, omdat deze URL's tokens bevatten die automatisch moeten worden gegenereerd door SharePoint Online op het moment dat het activum wordt aangevraagd.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.

Toegang tot activa in privé-origins wordt beveiligd door dynamisch gegenereerde tokens op basis van gebruikersmachtigingen voor de origin, met de waarschuwingen die in de volgende secties worden beschreven.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. Gebruikers moeten ten minste leestoegang hebben tot de origins voor de CDN om inhoud weer te geven.Users must have at least read access to the origins for the CDN to render content.

In het volgende diagram wordt de werkstroom weergegeven wanneer SharePoint een aanvraag ontvangt voor een pagina met activa van een persoonlijke origin.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a private origin.

Werkstroomdiagram: ophalen Office 365 CDN activa van een privé-originWorkflow diagram: Retrieving Office 365 CDN assets from a private origin

Autorisatie op basis van token in privé-originsToken-based authorization in private origins

Toegang tot activa in privé-origins in de Office 365 CDN wordt verleend door tokens die worden gegenereerd door SharePoint Online.Access to assets in private origins in the Office 365 CDN is granted by tokens generated by SharePoint Online. Gebruikers die al toegang hebben tot de map of bibliotheek die door de origin is aangewezen, krijgen automatisch tokens die de gebruiker toegang geven tot het bestand op basis van hun machtigingsniveau.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. Deze toegangstokens zijn geldig voor 30 tot 90 minuten nadat ze zijn gegenereerd om te voorkomen dat token opnieuw wordt afgespeeld.These access tokens are valid for 30 to 90 minutes after they are generated to help prevent token replay attacks.

Wanneer het toegangs token is gegenereerd, retourneert SharePoint Online een aangepaste URI naar de client met twee autorisatieparameters eten (edge authorization token) en haver (origin authorization token).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). De structuur van elk token is<'verlooptijd in tijdnotatie epoch'>__<'secure signature'>.The structure of each token is <'expiration time in Epoch time format'>__<'secure signature'>. Bijvoorbeeld:For example:

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

Notitie

Iedereen die in het bezit is van het token, heeft toegang tot de resource in de CDN.Anyone in possession of the token can access the resource in the CDN. URL's met deze toegangstokens worden echter alleen gedeeld via HTTPS, dus tenzij de URL expliciet wordt gedeeld door een eindgebruiker voordat het token verloopt, is het activum niet toegankelijk voor niet-geautoriseerde gebruikers.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.

Machtigingen op itemniveau worden niet ondersteund voor activa in privé-originsItem-level permissions are not supported for assets in private origins

Het is belangrijk om te weten dat SharePoint Online geen machtigingen op itemniveau ondersteunt voor activa in privé-origins.It is important to note that SharePoint Online does not support item-level permissions for assets in private origins. Voor een bestand dat zich bijvoorbeeld op bevindt, hebben gebruikers effectieve toegang tot het https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg bestand onder de volgende voorwaarden: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:

GebruikerUser MachtigingenPermissions Effectieve toegangEffective access
Gebruiker 1User 1 Heeft toegang tot map1Has access to folder1 Toegang tot image1.jpg de CDNCan access image1.jpg from the CDN
Gebruiker 2User 2 Heeft geen toegang tot map1Does not have access to folder1 Geen toegang image1.jpg de CDNCannot access image1.jpg from the CDN
Gebruiker 3User 3 Heeft geen toegang tot map1, maar wordt expliciete machtigingen verleend voor toegang tot image1.jpg in SharePoint OnlineDoes not have access to folder1, but is granted explicit permission to access image1.jpg in SharePoint Online U kunt de activa image1.jpg rechtstreeks vanuit SharePoint Online openen, maar niet vanuit de CDNCan access the asset image1.jpg directly from SharePoint Online, but not from the CDN
Gebruiker 4User 4 Heeft toegang tot map1, maar is expliciet toegang geweigerd tot image1.jpg in SharePoint OnlineHas access to folder1, but has been explicitly denied access to image1.jpg in SharePoint Online Heeft geen toegang tot het activum vanuit SharePoint Online, maar heeft wel toegang tot het activum vanuit de CDN ondanks dat de toegang tot het bestand in SharePoint Online is geweigerdCannot access the asset from SharePoint Online, but can access the asset from the CDN despite being denied access to the file in SharePoint Online

Problemen met de Office 365 CDNTroubleshooting the Office 365 CDN

Hoe kan ik bevestigen dat activa worden gebruikt door de CDN?How do I confirm that assets are being served by the CDN?

Nadat u koppelingen naar CDN-assets aan een pagina hebt toegevoegd, kunt u bevestigen dat het activum wordt weergegeven vanaf de CDN door naar de pagina te bladeren, met de rechtermuisknop op de afbeelding te klikken nadat de afbeelding is weergegeven en de url van de afbeelding te controleren.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.

U kunt ook de hulpprogramma's voor ontwikkelaars van uw browser gebruiken om de URL voor elk activum op een pagina weer te geven of een hulpprogramma voor netwerk traceren van derden gebruiken.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.

Notitie

Als u een netwerkhulpmiddel, zoals Fiddler, gebruikt om uw activa te testen buiten het weergeven van het activum vanaf een SharePoint-pagina, moet u handmatig de refererkop 'Referer:' toevoegen aan de GET-aanvraag waarbij de URL de hoofd-URL is van uw https://yourdomain.sharepoint.com SharePoint Online-tenant.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.

Het is niet mogelijk CDN URL's rechtstreeks in een webbrowser te testen, omdat u een referer moet hebben die afkomstig is van SharePoint Online.You cannot test CDN URLs directly in a web browser because you must have a referer coming from SharePoint Online. Als u echter de CDN-activa-URL toevoegt aan een SharePoint-pagina en vervolgens de pagina opent in een browser, ziet u de CDN-asset weergegeven op de pagina.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.

Zie voor meer informatie over het gebruik van de hulpprogramma's voor ontwikkelaars in Microsoft Edge browser Microsoft Edge Ontwikkelaarshulpmiddelen.For more information on using the developer tools in the Microsoft Edge browser, see Microsoft Edge Developer Tools.

Als u een korte video wilt bekijken die wordt gehost in het YouTube-kanaal van SharePoint Developer Patterns and Practices, waarin wordt gedemonstreert hoe u kunt controleren of uw CDN werkt, raadpleegt u Uw CDN-gebruikverifiëren en een optimale netwerkverbinding garanderen.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.

Waarom zijn activa van een nieuwe origin niet beschikbaar?Why are assets from a new origin unavailable?

Activa in nieuwe origins zijn niet onmiddellijk beschikbaar voor gebruik, omdat het tijd kost om de registratie door te sturen via de CDN en om de assets te uploaden van de origin naar CDN storage.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. De tijd die nodig is om activa beschikbaar te maken in de CDN is afhankelijk van het aantal assets en de bestandsgrootten.The time required for assets to be available in the CDN depends on how many assets and the files sizes.

Mijn clientwebonderdeel of -SharePoint Framework werkt nietMy client-side web part or SharePoint Framework solution isn't working

Wanneer u de Office 365 CDN voor openbare origins inschakelen, worden CDN standaard origins automatisch gemaakt:When you enable the Office 365 CDN for public origins, the CDN service automatically creates these default origins:

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

Als de origin */clientsideassets ontbreekt, mislukt SharePoint Framework en worden er geen waarschuwings- of foutberichten gegenereerd.If the */clientsideassets origin is missing, SharePoint Framework solutions will fail, and no warning or error messages are generated. Deze origin ontbreekt mogelijk omdat de CDN is ingeschakeld met de parameter -NoDefaultOrigins ingesteld op $true of omdat de origin handmatig is verwijderd.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.

U kunt controleren welke origins aanwezig zijn met de volgende PowerShell-opdracht:You can check to see which origins are present with the following PowerShell command:

Get-SPOTenantCdnOrigins -CdnType Public

U kunt ook contact op met Office 365 CLI:Or you can check with the Office 365 CLI:

spo cdn origin list

De origin in PowerShell toevoegen:To add the origin in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Als u de origin in de Office 365 CLI wilt toevoegen:To add the origin in the Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Welke PowerShell-modules en CLI-shells heb ik nodig om met de Office 365 CDN?What PowerShell modules and CLI shells do I need to work with the Office 365 CDN?

U kunt ervoor kiezen om met de Office 365 CDN te werken met de SharePoint Online Management Shell PowerShell-module of de 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.

Zie ookSee also

Netwerken voor contentleveringContent Delivery Networks

Network planning and performance tuning for Office 365Network planning and performance tuning for Office 365

SharePoint Performance Series - Office 365 CDN videoreeksSharePoint Performance Series - Office 365 CDN video series