Använda Office 365-innehålls leverans nätverk (CDN) med SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online

Du kan använda det inbyggda Office-365 innehålls leverans nätverk (CDN) för att hantera statiska till gångar för bättre prestanda för SharePoint Online-sidorna.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. Office 365 CDN förbättrar prestandan genom att cachelagra statiska till gångar i webbläsare som begär dem, vilket hjälper dig att påskynda nedladdningen och minska svars tiden.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. Dessutom använder Office 365 CDN http/2 för förbättrad komprimering och http-försäljning.Also, the Office 365 CDN uses the HTTP/2 protocol for improved compression and HTTP pipelining. Office 365 CDN-tjänsten är inkluderad som en del av SharePoint Online-prenumerationen.The Office 365 CDN service is included as part of your SharePoint Online subscription.

Anteckning

Office 365 CDN är bara tillgängligt för klient organisationer i produktions -molnet (världen över).The Office 365 CDN is only available to tenants in the Production (worldwide) cloud. Klient organisationer i Förenta staternas myndigheter, Kina och Tyskland stöder för närvarande inte Office 365 CDN.Tenants in the US Government, China and Germany clouds do not currently support the Office 365 CDN.

Office 365 CDN består av flera CDN som låter dig hantera fasta till gångar på flera platser, eller ursprung, och betjäna dem från globala nätverk med snabb hastighet.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. Beroende på vilken typ av innehåll du vill ha i Office 365 CDN kan du lägga till offentliga ursprung, privata ursprung eller båda.Depending on the kind of content you want to host in the Office 365 CDN, you can add public origins, private origins or both. Se välja om varje ursprung ska vara offentligt eller privat för mer information om skillnaden mellan offentliga och privata ursprung.See Choose whether each origin should be public or private for more information on the difference between public and private origins.

Office 365 CDN-koncept diagramOffice 365 CDN conceptual diagram

Om du redan är bekant med hur CDN fungerar behöver du bara utföra några steg för att aktivera Office 365 CDN för din klient organisation.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. I det här avsnittet beskrivs hur.This topic describes how. Läs mer om hur du kommer igång med dina statiska till gångar.Read on for information about how to get started hosting your static assets.

Tips

Det finns andra Microsoft-värdbaserade CDN som kan användas med Office 365 för specialiserade användnings scenarier, men diskuteras inte i det här avsnittet eftersom de ligger utanför omfattningen av 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. Mer information finns i andra Microsoft-CDN.For more information, see Other Microsoft CDNs.

Gå tillbaka till nätverks planering och prestanda justering för Office 365.Head back to Network planning and performance tuning for Office 365.

Översikt över hur du arbetar med Office 365 CDN i SharePoint OnlineOverview of working with the Office 365 CDN in SharePoint Online

Följ de här grundläggande stegen för att konfigurera Office 365 CDN för din organisation:To set up the Office 365 CDN for your organization, you follow these basic steps:

När du är klar med konfigurationen kan du Hantera Office 365 CDN över tiden genom att:Once you're done with setup, you can Manage the Office 365 CDN over time by:

  • Lägga till, uppdatera och ta bort till gångarAdding, updating, and removing assets
  • Lägga till och ta bort ursprungAdding and removing origins
  • Konfigurera CDN-principerConfiguring CDN policies
  • Vid behov kan du avaktivera CDNIf necessary, disabling the CDN

Slutligen kan du läsa om hur du använder CDN-till gångar från både offentliga och privata ursprung.Finally, see Using your CDN assets to learn about accessing your CDN assets from both public and private origins.

Se fel sökning av Office 365 CDN för vägledning för lösning av vanliga problem.See Troubleshooting the Office 365 CDN for guidance on resolving common issues.

Planera för distribution av Office 365 CDNPlan for deployment of the Office 365 CDN

Innan du distribuerar Office 365 CDN för din Office 365-klient bör du tänka på följande faktorer som en del av planerings processen.Before you deploy the Office 365 CDN for your Office 365 tenant, you should consider the following factors as part of your planning process.

Avgöra vilka statiska till gångar som du vill använda i CDNDetermine which static assets you want to host on the CDN

I allmänhet är CDN mest effektiva för att vara värd för _fasta till gångar_eller till gångar som inte ändras ofta.In general, CDNs are most effective for hosting static assets, or assets that don't change very often. En bra tumregel är att identifiera filer som uppfyller vissa eller samtliga av dessa villkor:A good rule of thumb is to identify files that meet some or all of these conditions:

  • Statiska filer som bäddats in på en sida (till exempel skript och bilder) som kan ha avsevärda effekter på sid inläsnings tiderStatic files embedded in a page (like scripts and images) that may have a significant incremental impact on page load times
  • Stora filer, till exempel körbara filer och installationsfilerLarge files like executables and installation files
  • Resurs bibliotek med stöd för klientbaserade koderResource libraries that support client-side code

Till exempel kan små filer som är upprepade gånger begärda med webbplats bilder och skript förbättra prestandan för webbplats åter givningen och inkrementellt minska belastningen på SharePoint Online-webbplatserna när du lägger till dem i ett CDN-ursprung.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. Större filer, till exempel körbara installations program, kan hämtas från CDN och ger en positiv effekt som påverkar belastningen på SharePoint Online-webbplatsen även om de inte är tillgängliga så ofta.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.

Förbättring av prestanda på en fil är beroende av många faktorer, inklusive klientens närhet till närmaste CDN-slutpunkt, tillfälliga förhållanden i det lokala nätverket.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. Många statiska filer är ganska små och kan laddas ned från Office 365 på mindre än en sekund.Many static files are quite small, and can be downloaded from Office 365 in less than a second. En webb sida kan innehålla många inbäddade filer med en kumulativ nedladdnings tid på flera sekunder.However, a web page may contain many embedded files with a cumulative download time of several seconds. Om du betjänar dessa filer från CDN kan det avsevärt minska sid inläsnings tiden.Serving these files from the CDN can significantly reduce the overall page load time. Se vilka resultat vinster ett CDN tillhandahåller? för ett exempel.See What performance gains does a CDN provide? for an example.

Bestämma var du vill spara till gångarnaDetermine where you want to store your assets

CDN hämtar dina till gångar från en plats som kallas ursprung.The CDN fetches your assets from a location called an origin. Ett ursprung kan vara en SharePoint-webbplats, ett dokument bibliotek eller en mapp som är tillgänglig via en URL-adress.An origin can be a SharePoint site, document library or folder that is accessible by a URL. Du har stor flexibilitet när du anger ursprung för din organisation.You have great flexibility when you specify origins for your organization. Du kan till exempel ange flera ursprung eller ett enda ursprung där du vill lägga till alla dina CDN-till gångar.For example, you can specify multiple origins or a single origin where you want to put all your CDN assets. Du kan välja att ha både offentliga eller privata ursprung för organisationen.You can choose to have both public or private origins for your organization. De flesta organisationer väljer att implementera en kombination av båda.Most organizations will choose to implement a combination of the two.

Du kan skapa en ny behållare för dina ursprung, till exempel mappar eller dokument bibliotek, och lägga till filer som du vill göra tillgängliga från 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. Det här är en bra metod om du har en specifik uppsättning till till gångar som du vill ska vara tillgängliga från CDN och bara vill begränsa uppsättningen av CDN-till gångar till filerna i behållaren.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.

Du kan också konfigurera en befintlig webbplats samling, en webbplats, ett bibliotek eller en mapp som ursprung, som gör alla godkända till gångar i behållaren tillgängliga från 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. Innan du lägger till en befintlig behållare som ett ursprung är det viktigt att se till att du är medveten om dess innehåll och behörigheter så att du inte oavsiktligt exponerar till gångar för anonym åtkomst eller obehöriga användare.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.

Du kan definiera CDN-principer för att exkludera innehåll i ursprungen från CDN.You can define CDN policies to exclude content in your origins from the CDN. CDN-principer exkluderar till gångar i offentliga eller privata ursprung utifrån attribut som filtyp och _webbplats klassificering_och tillämpas på alla ursprung i CdnType (privat eller offentlig) som du anger i principen.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. Om du till exempel lägger till ett privat ursprung som består av en webbplats som innehåller flera under webbplatser kan du definiera en princip som utesluter webbplatser som är markerade som hemliga så att innehållet från webbplatser med den klassificeringen inte kommer att betjänas från 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. Policyn gäller för innehåll från alla privata ursprung som du har lagt till i CDN.The policy will apply to content from all private origins you have added to the CDN.

Kom ihåg att det större antalet ursprung, desto större är effekten på den tid det tar för CDN-tjänsten att bearbeta förfrågningar.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. Vi rekommenderar att du begränsar antalet ursprung så mycket som möjligt.We recommend that you limit the number of origins as much as possible.

Välja om varje ursprung ska vara offentligt eller privatChoose whether each origin should be public or private

När du identifierar ett ursprung anger du om det ska göras offentligt eller privat.When you identify an origin, you specify whether it should be made public or private. Åtkomst till CDN-till gångar i offentliga ursprung är anonymt och CDN-innehåll i privata ursprung skyddas genom dynamiskt genererade token för ökad säkerhet.Access to CDN assets in public origins is anonymous, and CDN content in private origins is secured by dynamically generated tokens for greater security. Oavsett vilket alternativ du väljer gör Microsoft all den tungan när det gäller administrationen av själva CDN.Regardless of which option you choose, Microsoft does all the heavy lifting for you when it comes to administration of the CDN itself. Du kan också ändra dina tankar senare, efter att du har konfigurerat CDN och identifierat dina ursprung.Also, you can change your mind later, after you've set up the CDN and identified your origins.

Både offentliga och privata alternativ ger liknande prestanda vinster men alla har unika attribut och fördelar.Both public and private options provide similar performance gains, but each has unique attributes and advantages.

Offentliga ursprung i Office 365 CDN är tillgängliga anonymt och värdbaserade till gångar kan nås av alla som har URL-adressen till till gången.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. Eftersom åtkomsten till innehåll i offentliga ursprung är anonym bör du endast använda dem för att cachelagra icke-känsligt allmänt innehåll, till exempel JavaScript-filer, skript, ikoner och bilder.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.

Privata ursprung i Office 365 CDN ger privat åtkomst till användar innehåll som SharePoint Online-dokumentbibliotek, webbplatser och grafik.Private origins within the Office 365 CDN provide private access to user content such as SharePoint Online document libraries, sites and proprietary images. Åtkomst till innehåll i privata ursprung skyddas genom dynamiskt genererade token så att användare som har behörighet till det ursprungliga dokument biblioteket eller lagrings platsen endast kan komma åt det.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. Privata ursprung i Office 365 CDN kan endast användas till till gångar i privata ursprung genom omdirigering från din SharePoint Online-klient.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.

Du kan läsa mer om hur CDN får åtkomst till till gångar i ett privat ursprung i använda till gångar i privata ursprung.You can read more about how CDN access to assets in a private origin works in Using assets in private origins.

Attribut och fördelar med att låta till gångar i offentliga ursprungAttributes and advantages of hosting assets in public origins

  • Till gångar som är utsatta med offentligt ursprung är tillgängliga för alla anonymt.Assets exposed in a public origin are accessible by everyone anonymously.

    Viktigt

    Du bör aldrig placera resurser som innehåller användar information eller anses vara känsliga för organisationen i ett offentligt ursprung.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

  • Om du tar bort en till gång från ett offentligt ursprung kan till gången fortsätta vara tillgänglig i upp till 30 dagar från cachen; Vi kommer inte att validera länkar till till gången i CDN inom 15 minuter.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.
  • När du är värd för formatmallar (CSS-filer) i ett offentligt ursprung kan du använda relativa sökvägar och URI: er i koden.When you host style sheets (CSS files) in a public origin, you can use relative paths and URIs within the code. Det innebär att du kan referera till platsen för bakgrunds bilder och andra objekt i förhållande till den plats där den som ringer till till gången finns.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.
  • Vi rekommenderar inte att du använder en fast kod för ett offentligt ursprung.While you can hard code a public origin's URL, doing so is not recommended. Anledningen till detta är att om åtkomsten till CDN inte är tillgänglig kommer URL-adressen inte automatiskt att lösas till din organisation i SharePoint Online och kan leda till felaktiga länkar och andra fel.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 standard fil typer som ingår i offentliga ursprung är. CSS,. EOT,. gif,. ico,. jpeg,. jpg,. js,. map,. png,. SVG,. ttf,. WOFF och. 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. Du kan ange Ytterligare filtyper.You can specify additional file types.
  • Du kan konfigurera en princip för att exkludera till gångar som identifieras av webbplats klassificeringar som du anger.You can configure a policy to exclude assets that have been identified by site classifications that you specify. Du kan till exempel välja att exkludera alla till gångar som är markerade som "konfidentiella" eller "begränsade" även om de är en tillåten filtyp och är placerade i ett offentligt ursprung.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.

Attribut och fördelar med att vara värd för till gångar i privata ursprungAttributes and advantages of hosting assets in private origins

  • Privata ursprung kan endast användas för SharePoint Online-till gångar.Private origins can only be used for SharePoint Online assets.
  • Användare kan bara komma åt till gångar från ett privat ursprung om de har behörighet att komma åt behållaren.Users can only access the assets from a private origin if they have permissions to access the container. Anonym åtkomst till dessa till gångar förhindras.Anonymous access to these assets is prevented.
  • Till gångar i privata ursprung måste hänvisas till i SharePoint Online-klient organisationen.Assets in private origins must be referred from the SharePoint Online tenant. Direkt åtkomst till privata CDN-objekt fungerar inte.Direct access to private CDN assets does not work.
  • Om du tar bort en till gång från privat ursprung kan till gången fortsätta vara tillgänglig för upp till en timme från cachen; Vi kommer att validera länkar till till gången i CDN inom 15 minuter efter det att du har avlägsnat den.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 standard fil typer som ingår i privata ursprung är. gif,. ico,. jpeg,. jpg,. js och. png.The default file types that are included for private origins are .gif, .ico, .jpeg, .jpg, .js, and .png. Du kan ange Ytterligare filtyper.You can specify additional file types.
  • Precis som med offentliga ursprung kan du konfigurera en princip för att exkludera till gångar som identifieras av webbplats klassificeringar som du anger även om du använder jokertecken för att inkludera alla till gångar i en mapp eller ett dokument bibliotek.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.

Mer information om varför du ska använda Office 365 CDN, allmänna CDN-begreppen och andra Microsoft-CDN som du kan använda med Office 365-klient organisationen finns i avsnittet innehålls leverans nätverk.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.

Standard ursprung för CDNDefault CDN origins

Om du inte anger något annat kommer Office 365 att ställa in vissa standard ursprung när du aktiverar Office 365 CDN.Unless you specify otherwise, Office 365 sets up some default origins for you when you enable the Office 365 CDN. Om du inte har avaktiverat dem kan du lägga till dessa ursprung när du har slutfört installationen.If you initially opt not to provision them, you can add these origins after you complete setup. Om du inte förstår följderna av att hoppa över inställningen av standard ursprung och har särskilda skäl för att göra det, bör du tillåta att dessa skapas när du aktiverar 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.

Standard privata CDN-ursprung:Default private CDN origins:

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

Standard allmänna CDN-ursprung:Default public CDN origins:

  • */masterpage*/masterpage
  • */Style-bibliotek*/style library
  • */clientsideassets*/clientsideassets

Anteckning

clientsideassets är ett offentligt standard ursprung som lagts till i Office 365 CDN-tjänsten i december 2017.clientsideassets is a default public origin that was added to the Office 365 CDN service in December 2017. Detta måste finnas för att SharePoint Framework-lösningarna i CDN ska fungera.This origin must be present in order for SharePoint Framework solutions in the CDN to work. Om du har aktiverat Office 365 CDN före den 2017 december, eller om du hoppat över installationen av standard ursprung när du aktiverade CDN, kan du manuellt lägga till det här ursprunget.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. Mer information finns i min webbdel för klient-eller SharePoint-ramverk fungerar inte.For more information, see My client-side web part or SharePoint Framework solution isn't working.

Konfigurera och konfigurera Office 365 CDN med hjälp av SharePoint Online Management ShellSet up and configure the Office 365 CDN by using the SharePoint Online Management Shell

Procedurerna i det här avsnittet kräver att du använder SharePoint Online Management Shell för att ansluta till SharePoint Online.The procedures in this section require you to use the SharePoint Online Management Shell to connect to SharePoint Online. Anvisningar finns i ansluta till SharePoint Online PowerShell.For instructions, see Connect to SharePoint Online PowerShell.

Utför de här stegen för att konfigurera och konfigurera CDN så att dina till gångar i SharePoint Online används med 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.

Klicka för att VisaClick to expand

Aktivera din organisation för att använda Office 365 CDNEnable your organization to use the Office 365 CDN

Innan du ändrar status för klient organisationen måste du hämta den aktuella statusen för privat CDN-konfigurationen i Office 365-klient organisationen.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. Anslut till klient organisationen med SharePoint Online Management Shell:Connect to your tenant using the SharePoint Online Management Shell:

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

Använd cmdleten Get-SPOTenantCdnEnabled för att hämta status inställningar för CDN från klient organisationen:Now use the Get-SPOTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Statusen för CDN för angiven CdnType kommer att matas ut till skärmen.The status of the CDN for the specified CdnType will output to the screen.

Använd cmdleten set-SPOTenantCdnEnabled för att göra det möjligt för organisationen att använda Office 365 CDN.Use the Set-SPOTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Du kan göra det möjligt för organisationen att använda offentliga ursprung, privata ursprung eller båda samtidigt.You can enable your organization to use public origins, private origins, or both at once. Du kan också konfigurera CDN för att hoppa över inställningen av standard ursprung när du aktiverar det.You can also configure the CDN to skip the setup of default origins when you enable it. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.You can always add these origins later as described in this topic.

I Windows PowerShell för SharePoint Online:In Windows Powershell for SharePoint Online:

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

Om du till exempel vill aktivera organisationen att använda både offentliga och privata ursprung skriver du följande kommando:For example, to enable your organization to use both public and private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Om du vill göra det möjligt för organisationen att använda både offentliga och privata ursprung men hoppa till standard ursprungen skriver du följande kommando: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

Se standard ursprung för CDN för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och den potentiella effekten av att hoppa över inställningen av standard ursprung.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.

Om du vill aktivera organisationen att använda offentliga ursprung skriver du följande kommando:To enable your organization to use public origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Om du vill aktivera din organisation att använda privata ursprung skriver du följande kommando:To enable your organization to use private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Mer information om den här cmdleten finns i set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Ändra listan över filtyper som ska ingå i Office 365 CDN (valfritt)Change the list of file types to include in the Office 365 CDN (Optional)

Tips

När du definierar filtyper med hjälp av cmdleten set-SPOTenantCdnPolicy skriver du över den för tillfället definierade listan.When you define file types by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Om du vill lägga till fler filtyper i listan kan du använda cmdleten först för att ta reda på vilka filtyper som redan är tillåtna och lägga till dem i listan tillsammans med nya filer.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.

Använd cmdleten set-SPOTenantCdnPolicy för att definiera statiska filtyper som kan hanteras av offentliga och privata ursprung i CDN.Use the Set-SPOTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Som standard tillåts vanliga typer av till gångar, till exempel. CSS,. gif,. jpg och. js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

I Windows PowerShell för SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Om du till exempel vill aktivera CDN som Host. CSS-och. png-filer anger du kommandot: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"

Använd cmdleten Get-SPOTenantCdnPolicies för att se vilka filtyper som för närvarande tillåts av CDN:To see what file types are currently allowed by the CDN, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Mer information om dessa cmdletar finns i set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Ändra listan över webbplats klassificeringar som du vill undanta från Office 365 CDN (valfritt)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tips

När du undantar webbplats klassificeringar med cmdleten set-SPOTenantCdnPolicy skriver du över den för tillfället definierade listan.When you exclude site classifications by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Om du vill undanta ytterligare webbplats klassificeringar kan du använda cmdleten först för att ta reda på vilka klassificeringar som redan är undantagna och sedan lägga till dem tillsammans med dina nya.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.

Använd cmdleten set-SPOTenantCdnPolicy för att undanta webbplats klassificeringar som du inte vill göra tillgängliga via CDN.Use the Set-SPOTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Som standard utesluts inga webbplats klassificeringar.By default, no site classifications are excluded.

I Windows PowerShell för SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Om du vill se vilka webbplats klassificeringar som är begränsade använder du cmdleten Get-SPOTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

De egenskaper som kommer att returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Egenskapen IncludeFileExtensions innehåller en lista över fil namns tillägg som kommer att betjänas från CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Anteckning

Standard fil namns tilläggen skiljer sig mellan offentliga och privata.The default file extensions are different between public and private.

Egenskapen ExcludeRestrictedSiteClassifications innehåller de webbplats klassificeringar som du vill undanta från CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Du kan till exempel utesluta webbplatser som marker ATS som konfidentiella så att innehållet från webbplatser med den klassificeringen inte kommer att betjänas från 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.

Egenskapen ExcludeIfNoScriptDisabled exkluderar innehåll från CDN baserat på Inställningar för NoScript på webbplats nivå.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Som standard är attributet NoScript aktiverat för moderna webbplatser och är inaktiverat för klassiska webbplatser.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Detta beror på klientens inställningar.This depends on your tenant settings.

Mer information om dessa cmdletar finns i set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Lägga till ett ursprung för dina till gångarAdd an origin for your assets

Använd cmdleten Add-SPOTenantCdnOrigin för att definiera ett ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define an origin. Du kan definiera flera ursprung.You can define multiple origins. Origo är en URL som pekar på ett SharePoint-bibliotek eller en mapp som innehåller de objekt som du vill ska hanteras av 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.

Viktigt

Du bör aldrig placera resurser som innehåller användar information eller anses vara känsliga för organisationen i ett offentligt ursprung.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>

Värdet för Path är den relativa sökvägen till det bibliotek eller den mapp som innehåller till gångarna.The value of path is the relative path to the library or folder that contains the assets. Du kan använda jokertecken utöver relativa sökvägar.You can use wildcards in addition to relative paths. Ursprung stöd för jokertecken läggs till till URL-adressen.Origins support wildcards prepended to the URL. Det gör att du kan skapa ursprung som sträcker sig över flera webbplatser.This allows you to create origins that span multiple sites. Om du till exempel vill ta med alla till gångar i masterpages-mappen för alla webbplatser som ett offentligt ursprung i CDN skriver du följande kommando: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
  • Jokertecknet * / kan bara användas i början av sökvägen och matchar alla URL-segment under den angivna URL-adressen.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Sökvägen kan peka på ett dokument bibliotek, en mapp eller en webbplats.The path can point to a document library, folder or site. Till exempel matchar sökvägen */site1 alla dokument bibliotek under webbplatsen.For example, the path */site1 will match all the document libraries under the site.

Du kan lägga till ett ursprung med en specifik relativ sökväg.You can add an origin with a specific relative path. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.You cannot add an origin using the full path.

I det här exemplet läggs ett privat ursprung för siteassets-biblioteket till på en specifik webbplats:This example adds a private origin of the siteassets library on a specific site:

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

Det här exemplet lägger till ett privat ursprung i mappen Mapp1 i webbplats samlingens webbplats till gångar-bibliotek: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

Om det finns ett blank steg i sökvägen kan du antingen omge vägen med citat tecken eller ersätta blank steget med URL-kodningen %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. Följande exempel lägger till ett privat ursprung för mappen 1 i webbplats samlingens webbplats till gångar-bibliotek: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"

Mer information om det här kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Anteckning

I privata ursprung måste till gångar som delas från ett ursprung ha en huvud version publicerad innan de kan nås från CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett offentligt ursprung för huvud sidorna och för format biblioteket för SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Vanligt vis är dessa ursprung för dig som standard när du aktiverar Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Om du vill aktivera dem manuellt följer du de här stegen.However, if you want to enable them manually, follow these steps.

  • Använd cmdleten Add-SPOTenantCdnOrigin för att definiera format biblioteket som ett offentligt ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define the style library as a public origin.
  Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
  • Använd cmdleten Add-SPOTenantCdnOrigin för att definiera huvud sidorna som ett offentligt ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define the master pages as a public origin.
  Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Mer information om det här kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett privat ursprung för webbplats till gångar, webbplats sidor och publicerings bilder för SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Använd cmdleten Add-SPOTenantCdnOrigin för att definiera mappen för webbplats till gångar som ett privat ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define the site assets folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
  • Använd cmdleten Add-SPOTenantCdnOrigin för att definiera mappen för webbplats sidor som ett privat ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define the site pages folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
  • Använd cmdleten Add-SPOTenantCdnOrigin för att definiera mappen för publicerings bilder som ett privat ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Mer information om det här kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett privat ursprung för en webbplats samling för SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Använd cmdleten Add-SPOTenantCdnOrigin för att definiera en webbplats samling som ett privat ursprung.Use the Add-SPOTenantCdnOrigin cmdlet to define a site collection as a private origin. Till exempel:For example:

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

Mer information om det här kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Du kan se ett meddelande om väntande konfiguration som förväntas som en SharePoint Online-klient ansluter till CDN-tjänsten.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Hantera Office 365 CDNManage the Office 365 CDN

När du har konfigurerat CDN kan du göra ändringar i konfigurationen när du uppdaterar innehåll eller när dina behov ändras, enligt beskrivningen i det här avsnittet.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.

Lägga till, uppdatera eller ta bort till gångar från Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

När du har slutfört konfigurations stegen kan du lägga till nya till gångar och uppdatera eller ta bort befintliga till gångar när du vill.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Gör dina ändringar i till gångarna i den mapp eller det SharePoint-bibliotek som du angav som ursprung.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Om du lägger till en ny till gång är den tillgänglig via CDN omedelbart.If you add a new asset, it is available through the CDN immediately. Men om du uppdaterar till gången tar det upp till 15 minuter innan den nya kopian sprids och blir tillgänglig i 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.

Om du behöver hämta plats för ursprunget kan du använda cmdleten Get-SPOTenantCdnOrigins .If you need to retrieve the location of the origin, you can use the Get-SPOTenantCdnOrigins cmdlet. Information om hur du använder denna cmdlet finns i Get-SPOTenantCdnOrigins.For information on how to use this cmdlet, see Get-SPOTenantCdnOrigins.

Ta bort ett ursprung från Office 365 CDNRemove an origin from the Office 365 CDN

Du kan ta bort åtkomst till en mapp eller ett SharePoint-bibliotek som du har identifierat som ett ursprung.You can remove access to a folder or SharePoint library that you identified as an origin. För att göra det, Använd cmdleten Remove-SPOTenantCdnOrigin .To do this, use the Remove-SPOTenantCdnOrigin cmdlet.

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

Information om hur du använder den här cmdleten finns i Remove-SPOTenantCdnOrigin.For information on how to use this cmdlet, see Remove-SPOTenantCdnOrigin.

Ändra ett ursprung i Office 365 CDNModify an origin in the Office 365 CDN

Du kan inte ändra ett ursprung som du har skapat.You cannot modify an origin you've created. I stället kan du ta bort Origo och sedan lägga till ett nytt.Instead, remove the origin and then add a new one. Mer information finns i så här tar du bort ett ursprung från Office 365 CDN och hur du lägger till till gångar.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Inaktivera Office 365 CDNDisable the Office 365 CDN

Använd cmdleten set-SPOTenantCdnEnabled för att inaktivera CDN för organisationen.Use the Set-SPOTenantCdnEnabled cmdlet to disable the CDN for your organization. Om både offentliga och privata ursprung är aktiverade för CDN måste du köra cmdleten två gånger enligt följande exempel.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.

Om du vill inaktivera användning av offentliga ursprung i CDN skriver du följande kommando:To disable use of public origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Om du vill inaktivera användningen av de privata ursprungen i CDN skriver du följande kommando:To disable use of the private origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Mer information om den här cmdleten finns i set-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Konfigurera och konfigurera Office 365 CDN med PnP PowerShellSet up and configure the Office 365 CDN by using PnP PowerShell

Procedurerna i det här avsnittet kräver att du använder PnP PowerShell för att ansluta till SharePoint Online.The procedures in this section require you to use PnP PowerShell to connect to SharePoint Online. Anvisningar finns i komma igång med PnP PowerShell.For instructions, see Getting started with PnP PowerShell.

Utför de här stegen för att konfigurera och konfigurera CDN för att hantera dina till gångar i SharePoint Online med hjälp av PnP PowerShell.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using PnP PowerShell.

Klicka för att VisaClick to expand

Aktivera din organisation för att använda Office 365 CDNEnable your organization to use the Office 365 CDN

Innan du ändrar status för klient organisationen måste du hämta den aktuella statusen för privat CDN-konfigurationen i Office 365-klient organisationen.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. Ansluta till klient organisationen med PnP PowerShell:Connect to your tenant using PnP PowerShell:

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

Använd cmdleten Get-PnPTenantCdnEnabled för att hämta status inställningar för CDN från klient organisationen:Now use the Get-PnPTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Statusen för CDN för angiven CdnType kommer att matas ut till skärmen.The status of the CDN for the specified CdnType will output to the screen.

Använd cmdleten set-PnPTenantCdnEnabled för att göra det möjligt för organisationen att använda Office 365 CDN.Use the Set-PnPTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Du kan göra det möjligt för organisationen att använda offentliga ursprung, privata ursprung eller båda samtidigt.You can enable your organization to use public origins, private origins, or both at at the same time. Du kan också konfigurera CDN för att hoppa över inställningen av standard ursprung när du aktiverar det.You can also configure the CDN to skip the setup of default origins when you enable it. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.You can always add these origins later as described in this topic.

I PnP PowerShell:In PnP PowerShell:

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

Om du till exempel vill aktivera organisationen att använda både offentliga och privata ursprung skriver du följande kommando:For example, to enable your organization to use both public and private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Om du vill göra det möjligt för organisationen att använda både offentliga och privata ursprung men hoppa till standard ursprungen skriver du följande kommando: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

Se standard ursprung för CDN för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och den potentiella effekten av att hoppa över inställningen av standard ursprung.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.

Om du vill aktivera organisationen att använda offentliga ursprung skriver du följande kommando:To enable your organization to use public origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Om du vill aktivera din organisation att använda privata ursprung skriver du följande kommando:To enable your organization to use private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Mer information om den här cmdleten finns i set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Ändra listan över filtyper som ska ingå i Office 365 CDN (valfritt)Change the list of file types to include in the Office 365 CDN (Optional)

Tips

När du definierar filtyper med hjälp av cmdleten set-PnPTenantCdnPolicy skriver du över den för tillfället definierade listan.When you define file types by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Om du vill lägga till fler filtyper i listan kan du använda cmdleten först för att ta reda på vilka filtyper som redan är tillåtna och lägga till dem i listan tillsammans med nya filer.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.

Använd cmdleten set-PnPTenantCdnPolicy för att definiera statiska filtyper som kan hanteras av offentliga och privata ursprung i CDN.Use the Set-PnPTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Som standard tillåts vanliga typer av till gångar, till exempel. CSS,. gif,. jpg och. js.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

I PnP PowerShell:In PnP PowerShell:

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

Om du till exempel vill aktivera CDN som Host. CSS-och. png-filer anger du kommandot: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"

Använd cmdleten Get-PnPTenantCdnPolicies för att se vilka filtyper som för närvarande tillåts av CDN:To see what file types are currently allowed by the CDN, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Mer information om dessa cmdletar finns i set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Ändra listan över webbplats klassificeringar som du vill undanta från Office 365 CDN (valfritt)Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tips

När du undantar webbplats klassificeringar med cmdleten set-PnPTenantCdnPolicy skriver du över den för tillfället definierade listan.When you exclude site classifications by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Om du vill undanta ytterligare webbplats klassificeringar kan du använda cmdleten först för att ta reda på vilka klassificeringar som redan är undantagna och sedan lägga till dem tillsammans med dina nya.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.

Använd cmdleten set-PnPTenantCdnPolicy för att undanta webbplats klassificeringar som du inte vill göra tillgängliga via CDN.Use the Set-PnPTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Som standard utesluts inga webbplats klassificeringar.By default, no site classifications are excluded.

I PnP PowerShell:In PnP PowerShell:

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

Om du vill se vilka webbplats klassificeringar som är begränsade använder du cmdleten Get-PnPTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

De egenskaper som kommer att returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Egenskapen IncludeFileExtensions innehåller en lista över fil namns tillägg som kommer att betjänas från CDN.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Anteckning

Standard fil namns tilläggen skiljer sig mellan offentliga och privata.The default file extensions are different between public and private.

Egenskapen ExcludeRestrictedSiteClassifications innehåller de webbplats klassificeringar som du vill undanta från CDN.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Du kan till exempel utesluta webbplatser som marker ATS som konfidentiella så att innehållet från webbplatser med den klassificeringen inte kommer att betjänas från 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.

Egenskapen ExcludeIfNoScriptDisabled exkluderar innehåll från CDN baserat på Inställningar för NoScript på webbplats nivå.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Som standard är attributet NoScript aktiverat för moderna webbplatser och är inaktiverat för klassiska webbplatser.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Detta beror på klientens inställningar.This depends on your tenant settings.

Mer information om dessa cmdletar finns i set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Lägga till ett ursprung för dina till gångarAdd an origin for your assets

Använd cmdleten Add-PnPTenantCdnOrigin för att definiera ett ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define an origin. Du kan definiera flera ursprung.You can define multiple origins. Origo är en URL som pekar på ett SharePoint-bibliotek eller en mapp som innehåller de objekt som du vill ska hanteras av 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.

Viktigt

Du bör aldrig placera resurser som innehåller användar information eller anses vara känsliga för organisationen i ett offentligt ursprung.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>

Värdet för Path är den relativa sökvägen till det bibliotek eller den mapp som innehåller till gångarna.The value of path is the relative path to the library or folder that contains the assets. Du kan använda jokertecken utöver relativa sökvägar.You can use wildcards in addition to relative paths. Ursprung stöd för jokertecken läggs till till URL-adressen.Origins support wildcards prepended to the URL. Det gör att du kan skapa ursprung som sträcker sig över flera webbplatser.This allows you to create origins that span multiple sites. Om du till exempel vill ta med alla till gångar i masterpages-mappen för alla webbplatser som ett offentligt ursprung i CDN skriver du följande kommando: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
  • Jokertecknet * / kan bara användas i början av sökvägen och matchar alla URL-segment under den angivna URL-adressen.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Sökvägen kan peka på ett dokument bibliotek, en mapp eller en webbplats.The path can point to a document library, folder or site. Till exempel matchar sökvägen */site1 alla dokument bibliotek under webbplatsen.For example, the path */site1 will match all the document libraries under the site.

Du kan lägga till ett ursprung med en specifik relativ sökväg.You can add an origin with a specific relative path. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.You cannot add an origin using the full path.

I det här exemplet läggs biblioteket webbplats till gångar till på en specifik webbplats:This example adds a private origin of the site assets library on a specific site:

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

Det här exemplet lägger till ett privat ursprung i mappen Mapp1 i webbplats samlingens webbplats till gångar-bibliotek: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

Om det finns ett blank steg i sökvägen kan du antingen omge vägen med citat tecken eller ersätta blank steget med URL-kodningen %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. Följande exempel lägger till ett privat ursprung för mappen 1 i webbplats samlingens webbplats till gångar-bibliotek: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"

Mer information om det här kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Anteckning

I privata ursprung måste till gångar som delas från ett ursprung ha en huvud version publicerad innan de kan nås från CDN.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett offentligt ursprung för huvud sidorna och för format biblioteket för SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Vanligt vis är dessa ursprung för dig som standard när du aktiverar Office 365 CDN.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Om du vill aktivera dem manuellt följer du de här stegen.However, if you want to enable them manually, follow these steps.

  • Använd cmdleten Add-PnPTenantCdnOrigin för att definiera format biblioteket som ett offentligt ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define the style library as a public origin.
  Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
  • Använd cmdleten Add-PnPTenantCdnOrigin för att definiera huvud sidorna som ett offentligt ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define the master pages as a public origin.
  Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Mer information om det här kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett privat ursprung för webbplats till gångar, webbplats sidor och publicerings bilder för SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Använd cmdleten Add-PnPTenantCdnOrigin för att definiera mappen för webbplats till gångar som ett privat ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define the site assets folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
  • Använd cmdleten Add-PnPTenantCdnOrigin för att definiera mappen för webbplats sidor som ett privat ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define the site pages folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
  • Använd cmdleten Add-PnPTenantCdnOrigin för att definiera mappen för publicerings bilder som ett privat ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Mer information om det här kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Exempel: Konfigurera ett privat ursprung för en webbplats samling för SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Använd cmdleten Add-PnPTenantCdnOrigin för att definiera en webbplats samling som ett privat ursprung.Use the Add-PnPTenantCdnOrigin cmdlet to define a site collection as a private origin. Till exempel:For example:

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

Mer information om det här kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

När du har kört kommandot synkroniseras konfigurationen via data Center.Once you've run the command, the system synchronizes the configuration across the datacenter. Du kan se ett meddelande om väntande konfiguration som förväntas som en SharePoint Online-klient ansluter till CDN-tjänsten.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Det kan ta upp till 15 minuter.This can take up to 15 minutes.

Hantera Office 365 CDNManage the Office 365 CDN

När du har konfigurerat CDN kan du göra ändringar i konfigurationen när du uppdaterar innehåll eller när dina behov ändras, enligt beskrivningen i det här avsnittet.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.

Lägga till, uppdatera eller ta bort till gångar från Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

När du har slutfört konfigurations stegen kan du lägga till nya till gångar och uppdatera eller ta bort befintliga till gångar när du vill.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Gör dina ändringar i till gångarna i den mapp eller det SharePoint-bibliotek som du angav som ursprung.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Om du lägger till en ny till gång är den tillgänglig via CDN omedelbart.If you add a new asset, it is available through the CDN immediately. Men om du uppdaterar till gången tar det upp till 15 minuter innan den nya kopian sprids och blir tillgänglig i 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.

Om du behöver hämta plats för ursprunget kan du använda cmdleten Get-PnPTenantCdnOrigin .If you need to retrieve the location of the origin, you can use the Get-PnPTenantCdnOrigin cmdlet. Information om hur du använder denna cmdlet finns i Get-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Get-PnPTenantCdnOrigin.

Ta bort ett ursprung från Office 365 CDNRemove an origin from the Office 365 CDN

Du kan ta bort åtkomst till en mapp eller ett SharePoint-bibliotek som du har identifierat som ett ursprung.You can remove access to a folder or SharePoint library that you identified as an origin. För att göra det, Använd cmdleten Remove-PnPTenantCdnOrigin .To do this, use the Remove-PnPTenantCdnOrigin cmdlet.

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

Information om hur du använder den här cmdleten finns i Remove-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Remove-PnPTenantCdnOrigin.

Ändra ett ursprung i Office 365 CDNModify an origin in the Office 365 CDN

Du kan inte ändra ett ursprung som du har skapat.You cannot modify an origin you've created. I stället kan du ta bort Origo och sedan lägga till ett nytt.Instead, remove the origin and then add a new one. Mer information finns i så här tar du bort ett ursprung från Office 365 CDN och hur du lägger till till gångar.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Inaktivera Office 365 CDNDisable the Office 365 CDN

Använd cmdleten set-PnPTenantCdnEnabled för att inaktivera CDN för organisationen.Use the Set-PnPTenantCdnEnabled cmdlet to disable the CDN for your organization. Om både offentliga och privata ursprung är aktiverade för CDN måste du köra cmdleten två gånger enligt följande exempel.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.

Om du vill inaktivera användning av offentliga ursprung i CDN skriver du följande kommando:To disable use of public origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Om du vill inaktivera användningen av de privata ursprungen i CDN skriver du följande kommando:To disable use of the private origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Mer information om den här cmdleten finns i set-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Konfigurera och konfigurera Office 365 CDN med Office 365-CLISet up and configure the Office 365 CDN using the Office 365 CLI

Procedurerna i det här avsnittet kräver att du har installerat Office 365-CLI.The procedures in this section require that you have installed the Office 365 CLI. Anslut sedan till Office 365-klient organisationen med kommandot Logga in .Next, connect to your Office 365 tenant using the login command.

Utför de här stegen för att konfigurera och konfigurera CDN så att du kan vara värd för dina till gångar i SharePoint Online med hjälp av 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.

Klicka för att VisaClick to expand

Aktivera Office 365 CDNEnable the Office 365 CDN

Du kan hantera statusen för Office 365 CDN i klient organisationen med kommandot SPO CDN set .You can manage the state of the Office 365 CDN in your tenant using the spo cdn set command.

Så här aktiverar du Office 365 Public CDN i klient organisationen:To enable the Office 365 Public CDN in your tenant execute:

spo cdn set --type Public --enabled true

Aktivera Office 365 SharePoint CDN genom att köra:To enable the Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Visa aktuell status för Office 365 CDNView the current status of the Office 365 CDN

Om du vill kontrol lera om den särskilda typen av Office 365 CDN är aktiverat eller inaktive rad använder du kommandot SPO CDN get .To check if the particular type of Office 365 CDN is enabled or disabled, use the spo cdn get command.

Så här kontrollerar du om Office 365 Public CDN är aktiverat:To check if the Office 365 Public CDN is enabled, execute:

spo cdn get --type Public

Visa Office 365 CDN-ursprungView the Office 365 CDN origins

Så här visar du de aktuella konfigurerade Office 365 Public CDN-ursprungen kör:To view the currently configured Office 365 Public CDN origins execute:

spo cdn origin list --type Public

Se standard ursprung för CDN för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Lägga till ett Office 365 CDN-ursprungAdd an Office 365 CDN origin

Viktigt

Du bör aldrig placera resurser som anses vara känsliga för organisationen i ett SharePoint-dokumentbibliotek som är konfigurerat som ett offentligt ursprung.You should never place resources that are considered sensitive to your organization in a SharePoint document library configured as a public origin.

Använd kommandot SPO CDN Origin Add för att definiera ett CDN-ursprung.Use the spo cdn origin add command to define a CDN origin. Du kan definiera flera ursprung.You can define multiple origins. Origo är en URL som pekar på ett SharePoint-bibliotek eller en mapp som innehåller de objekt som du vill ska hanteras av 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>

Var path finns den relativa sökvägen till mappen som innehåller till gångarna.Where path is the relative path to the folder that contains the assets. Du kan använda jokertecken utöver relativa sökvägar.You can use wildcards in addition to relative paths.

Om du vill inkludera alla till gångar i huvud sid galleriet på alla webbplatser som ett offentligt ursprung kör du: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

Om du vill konfigurera ett privat ursprung för en viss webbplats samling kör du:To configure a private origin for a specific site collection, execute:

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

Anteckning

När du har lagt till ett CDN-ursprung kan det ta upp till 15 minuter innan du kan hämta filer via CDN-tjänsten.After adding a CDN origin, it might take up to 15 minutes for you to be able to retrieve files via the CDN service. Du kan kontrol lera om det specifika ursprungs ursprunget redan har Aktiver ATS med kommandot SPO CDN Origin .You can verify if the particular origin has already been enabled using the spo cdn origin list command.

Ta bort ett Office 365 CDN-ursprungRemove an Office 365 CDN origin

Använd kommandot SPO CDN Origin ta bort om du vill ta bort ett CDN-ursprung för den angivna CDN-typen.Use the spo cdn origin remove command to remove a CDN origin for the specified CDN type.

Om du vill ta bort ett offentligt ursprung från CDN-konfigurationen kör du:To remove a public origin from the CDN configuration, execute:

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

Anteckning

Om du tar bort ett CDN-ursprung påverkas inte filerna som lagras i ett dokument bibliotek som matchar ursprunget.Removing a CDN origin doesn't affect the files stored in any document library matching that origin. Om de här till gångarna har refererats till med deras SharePoint-URL växlar SharePoint automatiskt tillbaka till den ursprungliga URL-adressen som pekar på dokument biblioteket.If these assets have been referenced using their SharePoint URL, SharePoint will automatically switch back to the original URL pointing to the document library. Om till gångar har refererats till med en offentlig CDN-URL kommer länken att brytas och du måste ändra dem manuellt.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.

Ändra ett Office 365 CDN-ursprungModify an Office 365 CDN origin

Det går inte att ändra ett befintligt CDN-ursprung.It's not possible to modify an existing CDN origin. I stället bör du ta bort det tidigare definierade CDN-ursprunget med spo cdn origin remove kommandot och lägga till ett nytt med spo cdn origin add kommandot.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.

Ändra vilka typer av filer som ska ingå i Office 365 CDNChange the types of files to include in the Office 365 CDN

Följande filtyper ingår som standard i CDN: . CSS,. EOT,. gif,. ico,. jpeg,. jpg,. js,. map,. png,. SVG,. ttf,. WOFF och. 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. Om du behöver ta med fler filtyper i CDN kan du ändra CDN-konfigurationen med hjälp av SPO CDN-princip uppsättning .If you need to include additional file types in the CDN, you can change the CDN configuration using the spo cdn policy set command.

Anteckning

När du ändrar listan med filtyper skriver du över den för tillfället definierade listan.When changing the list of file types, you overwrite the currently defined list. Om du vill inkludera fler filtyper måste du först använda kommandot SPO CDN policy List för att ta reda på vilka filtyper som är konfigurerade för tillfället.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.

Om du vill lägga till JSON -filtypen i standard listan med filtyper som ingår i Public CDN kör du: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"

Ändra listan över webbplats klassificeringar som du vill undanta från Office 365 CDNChange the list of site classifications you want to exclude from the Office 365 CDN

Använd kommandot SPO CDN-princip uppsättning för att undanta webbplats klassificeringar som du inte vill göra tillgängliga via CDN.Use the spo cdn policy set command to exclude site classifications that you do not want to make available over the CDN. Som standard utesluts inga webbplats klassificeringar.By default, no site classifications are excluded.

Anteckning

När du ändrar listan med undantagna webbplats klassificeringar skriver du över den för tillfället definierade listan.When changing the list of excluded site classifications, you overwrite the currently defined list. Om du vill undanta ytterligare klassificeringar bör du först använda kommandot SPO CDN policy List för att ta reda på vilka klassificeringar som för tillfället är konfigurerade.If you want to exclude additional classifications, first use the spo cdn policy list command to find out which classifications are currently configured.

Om du vill undanta webbplatser som klassificerats som HBI från Public CDN kör duTo exclude sites classified as HBI from the public CDN, execute

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

Inaktivera Office 365 CDNDisable the Office 365 CDN

Så här inaktiverar du Office 365 CDN Använd spo cdn set kommandot, till exempel:To disable the Office 365 CDN use the spo cdn set command, for example:

spo cdn set --type Public --enabled false

Använda dina CDN-till gångarUsing your CDN assets

Nu när du har aktiverat CDN och konfigurerat ursprung och policy kan du börja använda dina CDN-till gångar.Now that you have enabled the CDN and configured origins and policies, you can begin using your CDN assets.

I det här avsnittet får du lära dig hur du använder CDN-URL: er på dina SharePoint-sidor och-innehåll så att SharePoint dirigerar om förfrågningar till till gångar i både offentliga och privata ursprung till 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.

Information om hur du använder CDN för att vara värd för klient webb delar finns i artikeln värd för klient sidan från Office 365 CDN (Hej världen 4).For information on how to use the CDN for hosting client-side web parts, see the topic Host your client-side web part from Office 365 CDN (Hello World part 4).

Anteckning

Om du lägger till mappen ClientSideAssets i listan privata CDN-ursprung går det inte att rendera CDN-anpassade webb delar.If you add the ClientSideAssets folder to the private CDN origins list, CDN-hosted custom web parts will fail to render. Filer som används av SPFX webb delar kan bara använda det offentliga CDN och ClientSideAssets-mappen är ett standard ursprung för offentlig CDN.Files used by SPFX web parts can only utilize the public CDN and the ClientSideAssets folder is a default origin for public CDN.

Om du vill använda till gångar som du har lagt till i ett ursprung uppdaterar du bara länkar till den ursprungliga filen med sökvägen till filen i origo.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.

  • Redigera sidan eller innehållet som innehåller länkar till till gångar som du har lagt till i ett ursprung.Edit the page or content that contains links to assets you have added to an origin. Du kan också använda en av flera metoder för att globalt söka och ersätta länkar på en webbplats eller webbplats samling om du vill uppdatera länken till en viss till gång överallt där den visas.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.
  • För varje länk till en till gång i ett ursprung ersätter du sökvägen med sökvägen till filen i CDNs ursprung.For each link to an asset in an origin, replace the path with the path to the file in the CDN origin. Du kan använda relativa sökvägar.You can use relative paths.
  • Spara sidan eller innehållet.Save the page or content.

Titta exempelvis på bild _/site/SiteAssets/images/image.png_som du har kopierat till mappen dokument bibliotek /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/. Om du vill använda CDN-resursen ersätter du den ursprungliga sökvägen till bild filens plats med sökvägen till origo för att skapa den nya URL-adressen /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.

Om du vill använda den fullständiga URL-adressen till resursen i stället för en relativ sökväg skapar du länken så här: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

Anteckning

I allmänhet ska du inte hardcode URL-adresser direkt till till gångar i CDN.In general, you should not hardcode URLs directly to assets in the CDN. Du kan dock manuellt skapa URL-adresser till till gångar i offentliga ursprung om det behövs.However, you can manually construct URLs for assets in public origins if needed. Mer information finns i HARDCODING CDN URL: er för offentliga till gångar.For more information, see Hardcoding CDN URLs for public assets.

Om du vill veta mer om hur du kontrollerar att till gångar bearbetas från CDN kan du läsa Hur kontrollerar jag att till gångar betjänas av CDN? i fel sökning i avsnittet Office 365 CDN .To learn about how to verify that assets are being served from the CDN, see How do I confirm that assets are being served by the CDN? in the Troubleshooting the Office 365 CDN section.

Använda till gångar i offentliga ursprungUsing assets in public origins

Med publicerings funktionen i SharePoint Online skrivs automatiskt om URL-adresser till till gångar som lagras i offentliga ursprung till deras CDN-motsvarigheter, så att till gångar behandlas från CDN-tjänsten i stället för 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.

Om ditt ursprung finns på en webbplats där publicerings funktionen är aktive rad och de till gångar som du vill ladda in till CDN finns i någon av följande kategorier, skrivs URL-adresser automatiskt om till till gångar i ursprungslandet, förutsatt att till gången inte har uteslutits av en CDN policy.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.

Här följer en översikt över vilka länkar som automatiskt skrivs om av publicerings funktionen för SharePoint:The following is an overview of which links are automatically rewritten by the SharePoint Publishing feature:

  • IMG/LINK/CSS URL-adresser i klassisk publicerings sida HTML-svarIMG/LINK/CSS URLs in classic publishing page HTML responses
    • Här ingår bilder som lagts till av författare i HTML-innehåll på en sidaThis includes images added by authors within the HTML content of a page
  • Bild-URL: er för bild bibliotekPicture Library SlideShow webpart image URLs
  • Bildfält i RenderListDataAsStream-resultat (SPList REST API)Image fields in SPList REST API (RenderListDataAsStream) results
    • Använd den nya egenskapen ImageFieldsToTryRewriteToCdnUrls för att ange en kommaseparerad lista med fältUse the new property ImageFieldsToTryRewriteToCdnUrls to provide a comma separated list of fields
    • Stöd för hyperlänkfält och PublishingImage-fältSupports hyperlink fields and PublishingImage fields
  • Bild åter givningar för SharePointSharePoint image renditions

I följande diagram visas arbets flödet när SharePoint tar emot en begäran om en sida som innehåller till gångar från ett offentligt ursprung.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a public origin.

Arbets flödes diagram: Hämta Office 365 CDN-till gångar från ett offentligt ursprungWorkflow diagram: Retrieving Office 365 CDN assets from a public origin

Tips

Om du vill inaktivera automatisk omskrivning för specifika URL-adresser på en sida kan du checka ut sidan och lägga till parametern frågesträng ? NoAutoReWrites = sant till slutet av varje länk som du vill inaktivera.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.

Hardcoding CDN-URL: er för offentliga till gångarHardcoding CDN URLs for public assets

Om publicerings funktionen inte är aktive rad för ett offentligt ursprung, eller om till gången inte är en av de länk typer som stöds av funktionen automatisk omskrivning i CDN-tjänsten, kan du skapa URL-adresser till till GÅNGARnas CDN-plats och använda dessa URL-adresser i innehållet.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.

Anteckning

Du kan inte hardcode CDN-URL: er till till gångar i ett privat ursprung eftersom den nödvändiga åtkomsttoken som utgör den sista delen av URL-adressen genereras när resursen begärs.You cannot hardcode 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.

För offentliga CDN-till gångar ser URL-formatet ut så här:For public CDN assets, the URL format will look like the following:

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

Ersätt TenantHostName med klient namnet.Replace TenantHostName with your tenant name. Exempel:Example:

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

Använda till gångar i privata ursprungUsing assets in private origins

Ingen ytterligare konfiguration krävs för att använda till gångar i privata ursprung.No additional configuration is required to use assets in private origins. I SharePoint Online skrivs URL-adresser automatiskt om för till gångar i privata ursprung så att begär Anden för dessa till gångar alltid kommer från CDN.SharePoint Online automatically rewrites URLs for assets in private origins so requests for those assets will always be served from the CDN. Du kan inte skapa URL: er till CDN-till gångar manuellt i privata ursprung eftersom dessa URL: er innehåller tokens som måste genereras automatiskt av SharePoint Online när du begär till gången.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.

Åtkomst till till gångar i privata ursprung skyddas av dynamiskt genererade token baserat på användar behörigheter till ursprung, med de villkor som beskrivs i följande avsnitt.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. Användare måste minst ha Läs behörighet till ursprungen för att det ska gå att rendera innehållet.Users must have at least read access to the origins for the CDN to render content.

I följande diagram visas arbets flödet när SharePoint tar emot en begäran om en sida som innehåller till gångar från ett privat ursprung.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a private origin.

Arbets flödes diagram: Hämta Office 365 CDN-till gångar från ett privat ursprungWorkflow diagram: Retrieving Office 365 CDN assets from a private origin

Token-baserad auktorisering i privata ursprungToken-based authorization in private origins

Åtkomst till till gångar i privata ursprung i Office 365 CDN beviljas av tokens som genererats av SharePoint Online.Access to assets in private origins in the Office 365 CDN is granted by tokens generated by SharePoint Online. Användare som redan har behörighet att komma åt mappen eller biblioteket som anges av ursprunget beviljas automatiskt token som gör att användaren kan komma åt filen baserat på deras behörighets nivå.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. Dessa åtkomsttoken är giltiga i 30 till 90 minuter efter att de genererats för att förhindra repetition av token.These access tokens are valid for 30 to 90 minutes after they are generated to help prevent token replay attacks.

När Access-token har genererats returnerar SharePoint Online en anpassad URI till klienten med två verifierings Parametrar: dela (Edge Authorization token) och OAT (ursprunglig 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). Strukturen för varje token är < "förfallo tid i test perioden" >__< "säker signatur" >.The structure of each token is <'expiration time in Epoch time format'>__<'secure signature'>. Till exempel:For example:

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

Anteckning

Alla som har ett token kan komma åt resursen i CDN.Anyone in possession of the token can access the resource in the CDN. URL-adresser med dessa åtkomsttoken delas bara över HTTPS, så såvida inte URL: en uttryckligen delas av en slutanvändare innan token går ut är till gången inte tillgänglig för obehöriga användare.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.

Behörigheter på objekt nivå stöds inte för till gångar i privata ursprungItem-level permissions are not supported for assets in private origins

Det är viktigt att du är medveten om att SharePoint Online inte hanterar behörigheter på objekt nivå för till gångar i privata ursprung.It is important to note that SharePoint Online does not support item-level permissions for assets in private origins. Användare har till exempel en https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg effektiv åtkomst till filen med följande villkor: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:

AnvändareUser BehörigheterPermissions Effektiv åtkomstEffective access
Användare 1User 1 Har åtkomst till Mapp1Has access to folder1 Kan komma åt image1.jpg från CDNCan access image1.jpg from the CDN
Användare 2User 2 Har inte åtkomst till Mapp1Does not have access to folder1 Det går inte att komma åt image1.jpg från CDNCannot access image1.jpg from the CDN
Användare 3User 3 Har inte åtkomst till Mapp1, men har uttryckligen tillåtelse att komma åt image1.jpg i SharePoint OnlineDoes not have access to folder1, but is granted explicit permission to access image1.jpg in SharePoint Online Kan komma åt till gången image1.jpg direkt från SharePoint Online, men inte från CDNCan access the asset image1.jpg directly from SharePoint Online, but not from the CDN
Användare 4User 4 Har åtkomst till Mapp1, men har uttryckligen nekats åtkomst till image1.jpg i SharePoint OnlineHas access to folder1, but has been explicitly denied access to image1.jpg in SharePoint Online Det går inte att komma åt till gången från SharePoint Online men kan komma åt till gången från CDN trots att den nekas åtkomst till filen i SharePoint OnlineCannot access the asset from SharePoint Online, but can access the asset from the CDN despite being denied access to the file in SharePoint Online

Felsöka Office 365 CDNTroubleshooting the Office 365 CDN

Hur bekräftar jag att till gångar betjänas av CDN?How do I confirm that assets are being served by the CDN?

När du har lagt till länkar till CDN-till gångar på en sida kan du bekräfta att till gången betjänas från CDN genom att bläddra till sidan och högerklicka på bilden när den har Render ATS och granska bild-URL: en.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.

Du kan också använda din webbläsares utvecklingsverktyg för att Visa webb adressen för varje objekt på en sida eller använda en tredjepartsleverantör för nätverks spårning.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.

Anteckning

Om du använder ett nätverks verktyg som/Fiddler-loggar för att testa dina till gångar från en SharePoint-sida, måste du lägga till referens rubriken "referering: https://yourdomain.sharepoint.com " till GET-begäran där URL-adressen är rot-URL för SharePoint Online-klienten.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.

Du kan inte testa CDN-adresser direkt i en webbläsare eftersom det finns en refererare från SharePoint Online.You cannot test CDN URLs directly in a web browser because you must have a referer coming from SharePoint Online. Om du däremot lägger till URL-adressen till till gången på en SharePoint-sida och sedan öppnar sidan i en webbläsare visas CDN-resursen som återges på sidan.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.

Mer information om hur du använder utvecklingsverktygen i webbläsaren Microsoft Edge finns i Microsoft Edge Developer Tools.For more information on using the developer tools in the Microsoft Edge browser, see Microsoft Edge Developer Tools.

Om du vill titta på en kort video som finns i SharePoint-utvecklingsverktygen och Practices YouTube-kanalen som visar hur du kontrollerar att CDN fungerar, se Verifiera ditt CDN-bruk och säkerställa optimal nätverks anslutning.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.

Varför är inte till gångar från ett nytt ursprungs ursprung?Why are assets from a new origin unavailable?

Till gångar i nya ursprung är inte omedelbart tillgängliga för användning, eftersom det tar tid för registreringen att sprida sig genom CDN och för till gångar att laddas upp från origo till CDN-lagring.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. Den tid som krävs för att till gångar ska vara tillgänglig i CDN beror på hur många till gångar och filernas storlek.The time required for assets to be available in the CDN depends on how many assets and the files sizes.

Min webb dels klient eller SharePoint Framework-lösning fungerar inteMy client-side web part or SharePoint Framework solution isn't working

När du aktiverar Office 365 CDN för offentliga ursprung, skapar CDN-tjänsten automatiskt dessa standard ursprung:When you enable the Office 365 CDN for public origins, the CDN service automatically creates these default origins:

  • */MASTERPAGE*/MASTERPAGE
  • */STYLE-BIBLIOTEK*/STYLE LIBRARY
  • */CLIENTSIDEASSETS*/CLIENTSIDEASSETS

Om */clientsideassets-Origo saknas Miss lyckas SharePoint Framework-lösningar och ingen varnings-eller fel meddelanden genereras.If the */clientsideassets origin is missing, SharePoint Framework solutions will fail, and no warning or error messages are generated. Detta ursprung kan saknas antingen på grund av att CDN aktiverades med parametern -NoDefaultOrigins inställd på $True, eller på grund av att origo togs bort manuellt.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.

Du kan kontrol lera vilka ursprung som finns med följande PowerShell-kommando:You can check to see which origins are present with the following PowerShell command:

Get-SPOTenantCdnOrigins -CdnType Public

Eller så kan du kontrol lera med Office 365-CLI:Or you can check with the Office 365 CLI:

spo cdn origin list

Så här lägger du till ursprung i PowerShell:To add the origin in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Så här lägger du till ursprunget i Office 365-CLI:To add the origin in the Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Vilka PowerShell-moduler och CLI-gränssnitt behöver jag för att arbeta med Office 365 CDN?What PowerShell modules and CLI shells do I need to work with the Office 365 CDN?

Du kan välja att arbeta med Office 365 CDN med antingen SharePoint Online Management Shell PowerShell-modulen eller 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.

Se ävenSee also

Nätverk för innehålls leveransContent Delivery Networks

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

SharePoint-prestandaräknare – Office 365 CDN-videoserieSharePoint Performance Series - Office 365 CDN video series