Använda Office 365 Content Delivery Network (CDN) med SharePoint Online
Du kan använda den inbyggda Office 365 Content Delivery Network (CDN) som värd för statiska tillgångar för att få bättre prestanda för dina SharePoint onlinesidor. Med Office 365 CDN prestanda kan du cachelagra statiska tillgångar närmare de webbläsare som begär dem, vilket hjälper dig att snabba på hämtningar och minska svarstiden. Dessutom Office 365 CDN HTTP/2-protokollet för förbättrad komprimering och HTTP-pipelining. Tjänsten Office 365 CDN ingår som en del av din prenumeration SharePoint Online.
Anteckning
Klientorganisationen Office 365 CDN tillgänglig för klientorganisationen i molnet För produktion (globalt). Klientorganisationen i molnen för myndigheter i USA, Kina och Tyskland stöder för närvarande inte Office 365 CDN.
The Office 365 CDN består av flera CDN som gör att du kan ha statiska tillgångar på flera platser, eller ursprung, och hantera dem från globala nätverk med hög hastighet. Beroende på vilken typ av innehåll som du vill lagra i Office 365 CDN kan du lägga till offentliga ursprung, privata ursprung eller båda. Se Välj om varje ursprung ska vara offentligt eller privat för mer information om skillnaden mellan offentliga och privata ursprung.

Om du redan är bekant med hur CDNs fungerar behöver du bara utföra några få steg för att aktivera Office 365 CDN för klientorganisationen. I det här avsnittet beskrivs hur du gör. Läs vidare för information om hur du kommer igång med värdskap för dina statiska tillgångar.
Tips
Det finns andra CDN med Microsoft-värd som kan användas med Office 365 för särskilda användningsscenarier, men som inte diskuteras i det här avsnittet eftersom de faller utanför Office 365 CDN. Mer information finns i Andra Microsoft CDN.
Gå tillbaka till Nätverksplanering och prestandajustering för Office 365.
Översikt över hur du arbetar med Office 365 CDN i SharePoint Online
Följ de här Office 365 CDN för att konfigurera organisationens tjänster:
Planera distributionen av Office 365 CDN
- Bestäm vilka statiska tillgångar du vill ha på CDN.
- Bestäm var du vill lagra tillgångarna. Den här platsen kan SharePoint en webbplats, ett bibliotek eller en mapp och kallas för ursprung.
- Välj om varje ursprung ska vara offentligt eller privat. Du kan lägga till flera ursprung för både offentliga och privata typer.
Konfigurera och konfigurera CDN med hjälp av PowerShell eller SharePoint Online CLI
- Konfigurera och konfigurera CDN med hjälp av SharePoint Online Management Shell
- Konfigurera och konfigurera CDN med PnP PowerShell
- Konfigurera och konfigurera CDN med hjälp av Office 365 CLI
När du slutför det här steget har du:
- Aktiverat CDN för din organisation.
- Lagt till ursprungen och identifierar varje ursprung som offentligt eller privat.
När du är klar med konfigurationen kan du hantera programmet Office 365 CDN tiden genom att:
- Lägga till, uppdatera och ta bort tillgångar
- Lägga till och ta bort ursprung
- Konfigurera CDN principer
- Om det behövs inaktiverar du CDN
Slutligen kan du läsa Använda dina CDN för att lära dig mer om hur du kommer CDN tillgångar från både offentliga och privata ursprung.
I Felsöka Office 365 CDN information om hur du löser vanliga problem.
Planera distributionen av Office 365 CDN
Innan du distribuerar Office 365 CDN för Office 365-klientorganisationen bör du tänka på följande faktorer som en del av planeringsprocessen.
- Bestäm vilka statiska tillgångar du vill ha på CDN
- Bestäm var du vill lagra tillgångarna
- Välj om varje ursprung ska vara offentligt eller privat
Bestäm vilka statiska tillgångar du vill ha på CDN
I allmänhet är CDN mest effektiva för värd för statiska tillgångar , eller tillgångar som inte ändras så ofta. En bra tumregel är att identifiera filer som uppfyller vissa eller alla dessa villkor:
- Statiska filer som är inbäddade i en sida (till exempel skript och bilder) som kan ha en betydande stegvis inverkan på sidornas inläsningstider
- Stora filer som körbara filer och installationsfiler
- Resursbibliotek med stöd för klientkod
Till exempel kan små filer som upprepade gånger efterfrågas, t.ex. webbplatsbilder och skript, avsevärt förbättra prestanda för webbplatsåtergivning och stegvis minska inläsningen av SharePoint Online-webbplatser när du lägger till dem i ett CDN-ursprung. Större filer, till exempel körbara installationsfiler, kan laddas ned från CDN, vilket ger positiv prestanda, samtidigt som belastningen på din SharePoint Online-webbplats därefter minskar, även om de inte används så ofta.
Prestandaförbättringar per fil beror på många faktorer, inklusive klientens närhet till närmaste CDN-slutpunkt, tillfälliga villkor i det lokala nätverket och så vidare. Många statiska filer är ganska små och kan laddas ned från Office 365 på mindre än en sekund. En webbsida kan emellertid innehålla många inbäddade filer med en kumulativ nedladdningstid på flera sekunder. Att använda dessa filer från CDN filer kan avsevärt minska inläsningstiden för sidan. Se Vilka prestandaförbättringar tillhandahåller CDN för ett exempel.
Bestäm var du vill lagra tillgångarna
Data CDN dina tillgångar från en plats som kallas för ursprung. Ursprunget kan vara en SharePoint, ett dokumentbibliotek eller en mapp som kan nås via en URL. Du har stor flexibilitet när du anger ursprung för organisationen. Du kan till exempel ange flera ursprung eller ett enda ursprung där du vill placera alla CDN tillgångar. Du kan välja att ha både offentliga och privata ursprung för organisationen. De flesta organisationer väljer att implementera en kombination av de två.
Du kan skapa en ny behållare för ursprungen, till exempel mappar eller dokumentbibliotek, och lägga till filer som du vill göra tillgängliga från CDN. Det här är ett bra sätt om du har en särskild uppsättning tillgångar som du vill ska vara tillgänglig från CDN och vill begränsa uppsättningen CDN-tillgångar till endast de filerna i behållaren.
Du kan också konfigurera en befintlig webbplatssamling, webbplats, bibliotek eller mapp som ursprung, vilket gör alla kvalificerade tillgångar i behållaren tillgängliga från CDN. Innan du lägger till en befintlig behållare som ursprung är det viktigt att du är medveten om dess innehåll och behörigheter så att du inte oavsiktligt visar tillgångar för anonym åtkomst eller obehöriga användare.
Du kan CDN principer för att utesluta innehåll i dina ursprung från CDN. CDN-principer utesluter tillgångar i offentliga eller privata ursprung efter attribut, till exempel filtyp och webbplatsklassificering, och tillämpas på alla ursprung för den CdnType (privat eller offentlig) du anger i principen. Om du till exempel lägger till ett privat ursprung som består av en webbplats som innehåller flera underwebbplatser kan du definiera en princip för att utesluta webbplatser som markerats som konfidentiellt, så att innehåll från webbplatser med den klassificeringen inte kommer att användas från CDN. Principen gäller för innehåll från alla privata ursprung som du har lagt till i CDN.
Kom ihåg att ju fler ursprung, desto större inverkan på den tid det tar CDN att bearbeta förfrågningar. Vi rekommenderar att du så mycket som möjligt begränsar antalet ursprung.
Välj om varje ursprung ska vara offentligt eller privat
När du identifierar ett ursprung anger du om det ska göras offentligt eller privat. Åtkomsten CDN tillgångar i offentliga ursprung är anonym och CDN innehåll i privata ursprung skyddas av dynamiskt genererade token för större säkerhet. Oavsett vilket alternativ du väljer gör Microsoft allt grovjobb åt dig när det gäller administration av CDN själv. Du kan också ändra dig senare, när du har ställt in CDN och identifierat dina ursprung.
Både offentliga och privata alternativ ger liknande prestandaförbättringar, men var och en har unika attribut och fördelar.
Offentliga ursprung i Office 365 CDN är anonymt tillgängliga och värdtillgångar kan nås av alla som har URL-adressen till tillgången. Eftersom åtkomsten till innehåll i offentliga ursprung är anonym bör du bara använda dem för att cachelagra icke-känsligt allmänt innehåll som JavaScript-filer, skript, ikoner och bilder.
Privata ursprung i Office 365 CDN ger privat åtkomst till användarinnehåll, SharePoint Dokumentbibliotek, webbplatser och egenutvecklade bilder. Åtkomst till innehåll i privata ursprung skyddas av dynamiskt genererade tokens så att användare med behörighet till det ursprungliga dokumentbiblioteket eller lagringsplatsen endast kan komma åt det. Privata ursprung i Office 365 CDN kan endast användas för SharePoint Online-innehåll och du kan bara komma åt tillgångar i privata ursprung genom omdirigering från SharePoint Online-klienten.
Du kan läsa mer om hur CDN åtkomst till tillgångar i ett privat ursprung fungerar i Använda tillgångar i privata ursprung.
Attribut och fördelar med att ha tillgångar i offentliga ursprung
Tillgångar som exponeras i en offentlig tillgång är åtkomliga för alla anonymt.
Viktigt
Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.
Om du tar bort en tillgång från ett offentligt ursprung kan tillgången fortsätta att vara tillgänglig i upp till 30 dagar från cachen. Länkarna till tillgången blir ogiltiga under de CDN inom 15 minuter.
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. Det innebär att du kan referera till platsen för bakgrundsbilder och andra objekt i förhållande till platsen för tillgången som anropar den.
Du kan skapa URL-adressen för ett offentligt ursprung, men du bör vara försiktig och se till att du använder sidkontextegenskapen och följer instruktionerna för att göra det. Anledningen är att om åtkomsten till CDN blir otillgänglig matchas inte URL-adressen automatiskt med din organisation i SharePoint Online och kan leda till brutna länkar och andra fel. URL-adressen kan också komma att ändras, vilket är anledningen till att den inte bara ska vara hårdkodad till sitt nuvarande värde.
Standardfiltyperna som ingår för offentliga ursprung är .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff och .woff2. Du kan ange ytterligare filtyper.
Du kan konfigurera en princip för att utesluta tillgångar som har identifierats av webbplatsklassificeringarna som du anger. Du kan till exempel välja att utesluta alla tillgångar som markeras som "konfidentiell" eller "begränsad" även om de är en tillåten filtyp och finns i ett offentligt ursprung.
Attribut och fördelar med att ha tillgångar i privata ursprung
Privata ursprung kan endast användas för SharePoint och onlinetillgångar.
Användare kan bara komma åt tillgångarna från ett privat ursprung om de har behörighet att komma åt behållaren. Anonym åtkomst till tillgångarna förhindras.
Tillgångar i privata ursprung måste hänvisas från den SharePoint Online-klientorganisationen. Direkt åtkomst till privata CDN tillgångar fungerar inte.
Om du tar bort en tillgång från det privata ursprunget kan tillgången fortsätta att vara tillgänglig i upp till en timme från cachen. Länkarna till tillgången blir ogiltiga under de CDN inom 15 minuter från borttagningen av tillgången.
Standardfiltyperna som ingår för privata ursprung är .gif, .ico, .jpeg, .jpg, .js och .png. Du kan ange ytterligare filtyper.
Precis som för offentliga ursprung kan du konfigurera en princip för att utesluta tillgångar som har identifierats av webbplatsklassificeringarna som du anger även om du använder jokertecken för att inkludera alla tillgångar i en mapp eller ett dokumentbibliotek.
Mer information om varför du kan använda de Office 365 CDN, allmänna CDN-begreppen och andra Microsoft CDN:er som du kan använda med din Office 365-klientorganisation finns i Nätverk för innehållsleverans.
Standardprodukter CDN ursprung
Om du inte anger något Office 365 några standard ursprung åt dig när du aktiverar Office 365 CDN. Om du först väljer att inte tillhandahålla dem kan du lägga till dessa ursprung när du har slutfört konfigurationen. Om du inte förstår konsekvenserna av att hoppa över konfigurationen av standard ursprung och har en särskild orsak till det, bör du tillåta att de skapas när du aktiverar CDN.
Privata standardprodukter CDN ursprung:
- */userphoto.aspx
- */siteassets
Offentliga standardprodukter CDN ursprung:
- */masterpage
- */style library
- */clientsideassets
Anteckning
clientsideassets är ett offentligt standard ursprung som lades till Office 365 CDN tjänsten i december 2017. Ursprunget måste finnas för att SharePoint Framework lösningarna i CDN ska fungera. Om du aktiverade Office 365 CDN före december 2017, eller om du hoppade över konfigurationen av standard ursprung när du aktiverade CDN, kan du manuellt lägga till det här ursprunget. Mer information finns i Min webbdel på klientsidan eller i SharePoint Framework en lösning inte fungerar.
Konfigurera och konfigurera Office 365 CDN med hjälp av 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. Instruktioner finns i Anslut för SharePoint PowerShell.
Utför de här stegen för att konfigurera och konfigurera CDN för att lagra dina tillgångar i SharePoint Online med hjälp av SharePoint Online Management Shell.
Klicka för att Visa
Aktivera organisationen för att använda Office 365 CDN
Innan du gör ändringar i CDN inställningar bör du hämta aktuell status för konfigurationen av privata CDN i Office 365 klientorganisation. Anslut till klientorganisationen med hjälp SharePoint Online Management Shell:
Connect-SPOService -Url https://contoso-admin.sharepoint.com
Använd nu cmdleten Get-SPOTenantCdnEnabled för att hämta CDN statusinställningar från klientorganisationen:
Get-SPOTenantCdnEnabled -CdnType <Public | Private>
Status för den CDN för den angivna CdnType matas ut på skärmen.
Använd cmdleten Set-SPOTenantCdnEnabled till att aktivera organisationen för att använda Office 365 CDN. Du kan aktivera organisationen för att använda offentliga ursprung, privata ursprung eller båda samtidigt. Du kan också konfigurera CDN att hoppa över konfigurationen av standard ursprung när du aktiverar det. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.
Gör Windows PowerShell för SharePoint Online:
Set-SPOTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true
Om du till exempel vill aktivera organisationen för att använda både offentliga och privata ursprung skriver du följande kommando:
Set-SPOTenantCdnEnabled -CdnType Both -Enable $true
Om du vill aktivera organisationen för att använda både offentliga och privata ursprung men hoppa över att konfigurera standard ursprung skriver du följande kommando:
Set-SPOTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins
Se Standardvärden CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och eventuell inverkan av att hoppa över konfigurationen av standard ursprung.
Om du vill aktivera organisationen för att använda offentliga ursprung skriver du följande kommando:
Set-SPOTenantCdnEnabled -CdnType Public -Enable $true
Om du vill aktivera din organisation för att använda privata ursprung skriver du följande kommando:
Set-SPOTenantCdnEnabled -CdnType Private -Enable $true
Mer information om den här cmdleten finns i Set-SPOTenantCdnEnabled.
Ändra listan över filtyper som ska ingå i listan Office 365 CDN (valfritt)
Tips
När du definierar filtyper med hjälp av cmdleten Set-SPOTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill lägga till ytterligare filtyper i listan använder du först cmdleten för att ta reda på vilka filtyper som redan är tillåtna och inkludera dem i listan tillsammans med dina nya.
Använd cmdleten Set-SPOTenantCdnPolicy till att definiera statiska filtyper som kan lagras av offentliga och privata ursprung i CDN. Som standard tillåts vanliga tillgångstyper, till exempel .css, .gif, .jpg och .js.
Gör Windows PowerShell för SharePoint Online:
Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"
Om du till exempel vill CDN CSS- och .png-filer anger du kommandot:
Set-SPOTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"
Om du vill se vilka filtyper som tillåts av CDN använder du cmdleten Get-SPOTenantCdnPolicies:
Get-SPOTenantCdnPolicies -CdnType <Public | Private>
Mer information om dessa cmdlets finns i Set-SPOTenantCdnPolicy och Get-SPOTenantCdnPolicies.
Ändra listan över webbplatsklassificeringarna som du vill utesluta från Office 365 CDN (valfritt)
Tips
När du utesluter webbplatsklassificeringarna med hjälp av cmdleten Set-SPOTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill utesluta ytterligare webbplatsklassificeringarna använder du cmdleten först för att ta reda på vilka klassificeringar som redan har uteslutits och sedan lägga till dem tillsammans med dina nya.
Använd cmdleten Set-SPOTenantCdnPolicy till att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.
Gör Windows PowerShell för SharePoint Online:
Set-SPOTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications -PolicyValue "<Comma-separated list of site classifications >"
Om du vill se vilka webbplatsklassificeringarna som är begränsade använder du cmdleten Get-SPOTenantCdnPolicies:
Get-SPOTenantCdnPolicies -CdnType <Public | Private>
Egenskaperna som returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.
Egenskapen IncludeFileExtensions innehåller listan över filnamnstillägg som kommer att användas från CDN.
Anteckning
Standardtilläggen för filer skiljer sig åt mellan offentliga och privata.
Egenskapen ExcludeRestrictedSiteClassifications innehåller webbplatsklassificeringarna som du vill utesluta från CDN. Du kan till exempel utesluta webbplatser som markerats som konfidentiella så att innehåll från webbplatser med den klassificering som tillämpas inte CDN.
Egenskapen ExcludeIfNoScriptDisabled utesluter innehåll från CDN baserat på inställningar för NoScript-attribut på webbplatsnivå. Som standard är attributet NoScript inställt på Aktiverad för moderna webbplatser och Inaktiverat för klassiska webbplatser. Det beror på klientorganisationens inställningar.
Mer information om dessa cmdlets finns i Set-SPOTenantCdnPolicy och Get-SPOTenantCdnPolicies.
Lägga till ett ursprung för dina tillgångar
Definiera ett ursprung med cmdleten Add-SPOTenantCdnOrigin. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.
Viktigt
Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.
Add-SPOTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>
Värdet på sökvägen är den relativa sökvägen till biblioteket eller mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar. Ursprung stöder jokertecken som finns i url-adressen. På så sätt kan du skapa ursprung som spänner över flera webbplatser. Om du till exempel vill ta med alla tillgångar i mappen masterpages för alla dina webbplatser som ett offentligt ursprung i CDN skriver du följande kommando:
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:en.
- Sökvägen kan peka på ett dokumentbibliotek, en mapp eller en webbplats. Sökvägen */webbplats1 matchar till exempel alla dokumentbibliotek under webbplatsen.
Du kan lägga till ett ursprung med en viss relativ sökväg. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.
I det här exemplet läggs ett privat ursprung till webbplatssamlingsbiblioteket på en viss webbplats:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Det här exemplet lägger till ett privat ursprung för mappen mapp1 i webbplatssamlingens bibliotek för webbplatstillgångar:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1
Om det finns ett blanksteg i sökvägen kan du antingen omge sökvägen med dubbla citattecken eller ersätta blanksteget med URL-kodningen %20. Följande exempel lägger till ett privat ursprung för mappen mapp 1 i webbplatssamlingens bibliotek för webbplatstillgångar:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"
Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.
Anteckning
I privata ursprung måste tillgångar som delas från ett ursprung ha en huvudversion publicerad innan de kan nås från CDN.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett offentligt ursprung för huvudsidorna och för formatbiblioteket för SharePoint Online
Normalt konfigureras dessa ursprung åt dig som standard när du aktiverar Office 365 CDN. Men om du vill aktivera dem manuellt följer du de här stegen.
Använd cmdleten Add-SPOTenantCdnOrigin till att definiera formatbiblioteket som ett offentligt ursprung.
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20libraryAnvänd cmdleten Add-SPOTenantCdnOrigin till att definiera huvudsidorna som ett offentligt ursprung.
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett privat ursprung för dina webbplatstillgångar, webbplatssidor och publiceringsbilder för SharePoint Online
Använd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för webbplatstillgångar som ett privat ursprung.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassetsAnvänd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för webbplatssidor som ett privat ursprung.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepagesAnvänd cmdleten Add-SPOTenantCdnOrigin till att definiera mappen för publiceringsbilder som ett privat ursprung.
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett privat ursprung för en webbplatssamling för SharePoint Online
Använd cmdleten Add-SPOTenantCdnOrigin till att definiera en webbplatssamling som ett privat ursprung. Till exempel:
Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Mer information om kommandot och dess syntax finns i Add-SPOTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Ett meddelande om väntande konfiguration visas, vilket förväntas när SharePoint Online-klienten ansluter till CDN tjänsten. Det kan ta upp till 15 minuter.
Hantera Office 365 CDN
När du har ställt 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.
Lägga till, uppdatera eller ta bort tillgångar från Office 365 CDN
När du har slutfört konfigurationsstegen kan du lägga till nya tillgångar och uppdatera eller ta bort befintliga tillgångar när du vill. Gör bara ändringar av tillgångarna i mappen eller det SharePoint som du har identifierat som ursprung. Om du lägger till en ny tillgång är den tillgänglig via CDN omedelbart. Men om du uppdaterar tillgången tar det upp till 15 minuter för den nya kopian av spridas och bli tillgänglig i CDN.
Om du behöver hämta platsen för ursprunget kan du använda cmdleten Get-SPOTenantCdnOrigins. Information om hur du använder denna cmdlet finns i Get-SPOTenantCdnOrigins.
Ta bort ett ursprung från Office 365 CDN
Du kan ta bort åtkomst till en mapp SharePoint ett bibliotek som du har identifierat som ursprung. Det gör du med cmdleten Remove-SPOTenantCdnOrigin.
Remove-SPOTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>
Information om hur du använder denna cmdlet finns i Remove-SPOTenantCdnOrigin.
Ändra ett ursprung i Office 365 CDN
Du kan inte ändra ett ursprung som du har skapat. Ta istället bort ursprunget och lägg sedan till ett nytt. Mer information finns i Ta bort ett ursprung från Office 365 CDN Lägga till ett ursprung för dina tillgångar.
Inaktivera Office 365 CDN
Använd cmdleten Set-SPOTenantCdnEnabled till att inaktivera CDN för organisationen. Om du har aktiverat både offentliga och privata ursprung för CDN, måste du köra cmdleten två gånger enligt följande exempel.
Inaktivera användningen av offentliga ursprung i CDN genom att ange följande kommando:
Set-SPOTenantCdnEnabled -CdnType Public -Enable $false
Inaktivera användningen av privata ursprung i CDN genom att ange följande kommando:
Set-SPOTenantCdnEnabled -CdnType Private -Enable $false
Mer information om den här cmdleten finns i Set-SPOTenantCdnEnabled.
Konfigurera och konfigurera Office 365 CDN med PnP PowerShell
Procedurerna i det här avsnittet kräver att du använder PnP PowerShell för att ansluta till SharePoint Online. Anvisningar finns i Komma igång med PnP PowerShell.
Utför de här stegen för att konfigurera och konfigurera CDN för att lagra dina tillgångar i SharePoint Online med PnP PowerShell.
Klicka för att Visa
Aktivera organisationen för att använda Office 365 CDN
Innan du gör ändringar i CDN inställningar bör du hämta aktuell status för konfigurationen av privata CDN i Office 365 klientorganisation. Anslut till klientorganisationen med PnP PowerShell:
Connect-PnPOnline -Url https://contoso-admin.sharepoint.com -UseWebLogin
Använd nu cmdleten Get-PnPTenantCdnEnabled för att hämta CDN statusinställningar från klientorganisationen:
Get-PnPTenantCdnEnabled -CdnType <Public | Private>
Status för den CDN för den angivna CdnType matas ut på skärmen.
Använd cmdleten Set-PnPTenantCdnEnabled till att aktivera organisationen för att använda Office 365 CDN. Du kan aktivera organisationen för att använda offentliga ursprung, privata ursprung eller både och på samma gång. Du kan också konfigurera CDN att hoppa över konfigurationen av standard ursprung när du aktiverar det. Du kan alltid lägga till dessa ursprung senare enligt beskrivningen i det här avsnittet.
I PnP PowerShell:
Set-PnPTenantCdnEnabled -CdnType <Public | Private | Both> -Enable $true
Om du till exempel vill aktivera organisationen för att använda både offentliga och privata ursprung skriver du följande kommando:
Set-PnPTenantCdnEnabled -CdnType Both -Enable $true
Om du vill aktivera organisationen för att använda både offentliga och privata ursprung men hoppa över att konfigurera standard ursprung skriver du följande kommando:
Set-PnPTenantCdnEnabled -CdnType Both -Enable $true -NoDefaultOrigins
Se Standardvärden CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN och eventuell inverkan av att hoppa över konfigurationen av standard ursprung.
Om du vill aktivera organisationen för att använda offentliga ursprung skriver du följande kommando:
Set-PnPTenantCdnEnabled -CdnType Public -Enable $true
Om du vill aktivera din organisation för att använda privata ursprung skriver du följande kommando:
Set-PnPTenantCdnEnabled -CdnType Private -Enable $true
Mer information om den här cmdleten finns i Set-PnPTenantCdnEnabled.
Ändra listan över filtyper som ska ingå i listan Office 365 CDN (valfritt)
Tips
När du definierar filtyper med hjälp av cmdleten Set-PnPTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill lägga till ytterligare filtyper i listan använder du först cmdleten för att ta reda på vilka filtyper som redan är tillåtna och inkludera dem i listan tillsammans med dina nya.
Använd cmdleten Set-PnPTenantCdnPolicy till att definiera statiska filtyper som kan lagras av offentliga och privata ursprung i CDN. Som standard tillåts vanliga tillgångstyper, till exempel .css, .gif, .jpg och .js.
I PnP PowerShell:
Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType IncludeFileExtensions -PolicyValue "<Comma-separated list of file types >"
Om du till exempel vill CDN CSS- och .png-filer anger du kommandot:
Set-PnPTenantCdnPolicy -CdnType Private -PolicyType IncludeFileExtensions -PolicyValue "CSS,PNG"
Om du vill se vilka filtyper som tillåts av CDN använder du cmdleten Get-PnPTenantCdnPolicies:
Get-PnPTenantCdnPolicies -CdnType <Public | Private>
Mer information om dessa cmdlets finns i Set-PnPTenantCdnPolicy och Get-PnPTenantCdnPolicies.
Ändra listan över webbplatsklassificeringarna som du vill utesluta från Office 365 CDN (valfritt)
Tips
När du utesluter webbplatsklassificeringarna med hjälp av cmdleten Set-PnPTenantCdnPolicy skriver du över den aktuella definierade listan. Om du vill utesluta ytterligare webbplatsklassificeringarna använder du cmdleten först för att ta reda på vilka klassificeringar som redan har uteslutits och sedan lägga till dem tillsammans med dina nya.
Använd cmdleten Set-PnPTenantCdnPolicy till att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.
I PnP PowerShell:
Set-PnPTenantCdnPolicy -CdnType <Public | Private> -PolicyType ExcludeRestrictedSiteClassifications -PolicyValue "<Comma-separated list of site classifications>"
Om du vill se vilka webbplatsklassificeringarna är begränsade använder du cmdleten Get-PnPTenantCdnPolicies:
Get-PnPTenantCdnPolicies -CdnType <Public | Private>
Egenskaperna som returneras är IncludeFileExtensions, ExcludeRestrictedSiteClassifications och ExcludeIfNoScriptDisabled.
Egenskapen IncludeFileExtensions innehåller listan över filnamnstillägg som ska användas för CDN.
Anteckning
Standardtilläggen för filer skiljer sig åt mellan offentliga och privata.
Egenskapen ExcludeRestrictedSiteClassifications innehåller webbplatsklassificeringarna som du vill utesluta från CDN. Du kan till exempel utesluta webbplatser som markerats som konfidentiella så att innehåll från webbplatser med den klassificering som tillämpas inte CDN.
Egenskapen ExcludeIfNoScriptDisabled utesluter innehåll från CDN baserat på inställningar för NoScript-attribut på webbplatsnivå. Som standard är attributet NoScript inställt på Aktiverad för moderna webbplatser och Inaktiverat för klassiska webbplatser. Det beror på klientorganisationens inställningar.
Mer information om dessa cmdlets finns i Set-PnPTenantCdnPolicy och Get-PnPTenantCdnPolicies.
Lägga till ett ursprung för dina tillgångar
Definiera ett ursprung med cmdleten Add-PnPTenantCdnOrigin. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.
Viktigt
Du ska aldrig placera resurser som innehåller användarinformation eller som anses vara känsliga för organisationen i ett offentligt ursprung.
Add-PnPTenantCdnOrigin -CdnType <Public | Private> -OriginUrl <path>
Värdet på sökvägen är den relativa sökvägen till biblioteket eller mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar. Ursprung stöder jokertecken som finns i url-adressen. På så sätt kan du skapa ursprung som spänner över flera webbplatser. Om du till exempel vill ta med alla tillgångar i mappen masterpages för alla dina webbplatser som ett offentligt ursprung i CDN, skriver du följande kommando:
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:en.
- Sökvägen kan peka på ett dokumentbibliotek, en mapp eller en webbplats. Sökvägen */webbplats1 matchar till exempel alla dokumentbibliotek under webbplatsen.
Du kan lägga till ett ursprung med en viss relativ sökväg. Du kan inte lägga till ett ursprung med den fullständiga sökvägen.
I det här exemplet läggs ett privat ursprung till biblioteket med webbplatstillgångar till på en viss webbplats:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Det här exemplet lägger till ett privat ursprung för mappen mapp1 i webbplatssamlingens bibliotek för webbplatstillgångar:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder1
Om det finns ett blanksteg i sökvägen kan du antingen omge sökvägen med dubbla citattecken eller ersätta blanksteget med URL-kodningen %20. Följande exempel lägger till ett privat ursprung för mappen mapp 1 i webbplatssamlingens bibliotek för webbplatstillgångar:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/test/siteassets/folder%201
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl "sites/test/siteassets/folder 1"
Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.
Anteckning
I privata ursprung måste tillgångar som delas från ett ursprung ha en huvudversion publicerad innan de kan nås från CDN.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett offentligt ursprung för dina huvudsidor och för ditt formatbibliotek för SharePoint Online
Normalt konfigureras dessa ursprung åt dig som standard när du aktiverar Office 365 CDN. Men om du vill aktivera dem manuellt följer du de här stegen.
Använd cmdleten Add-PnPTenantCdnOrigin till att definiera formatbiblioteket som ett offentligt ursprung.
Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20libraryAnvänd cmdleten Add-PnPTenantCdnOrigin till att definiera huvudsidorna som ett offentligt ursprung.
Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett privat ursprung för dina webbplatstillgångar, webbplatssidor och publiceringsbilder för SharePoint Online
Använd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för webbplatstillgångar som ett privat ursprung.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassetsAnvänd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för webbplatssidor som ett privat ursprung.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepagesAnvänd cmdleten Add-PnPTenantCdnOrigin till att definiera mappen för publiceringsbilder som ett privat ursprung.
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages
Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Det kan ta upp till 15 minuter.
Exempel: Konfigurera ett privat ursprung för en webbplatssamling för SharePoint Online
Använd cmdleten Add-PnPTenantCdnOrigin till att definiera en webbplatssamling som ett privat ursprung. Till exempel:
Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl sites/site1/siteassets
Mer information om kommandot och dess syntax finns i Add-PnPTenantCdnOrigin.
När du har kört kommandot synkroniserar systemet konfigurationen i datacentret. Ett meddelande om väntande konfiguration visas, vilket förväntas när SharePoint Online-klienten ansluter till CDN tjänsten. Det kan ta upp till 15 minuter.
Hantera Office 365 CDN
När du har ställt 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.
Lägga till, uppdatera eller ta bort tillgångar från Office 365 CDN
När du har slutfört konfigurationsstegen kan du lägga till nya tillgångar och uppdatera eller ta bort befintliga tillgångar när du vill. Gör bara ändringar av tillgångarna i mappen eller det SharePoint som du har identifierat som ursprung. Om du lägger till en ny tillgång är den tillgänglig via CDN omedelbart. Men om du uppdaterar tillgången tar det upp till 15 minuter för den nya kopian av spridas och bli tillgänglig i CDN.
Om du behöver hämta platsen för ursprunget kan du använda cmdleten Get-PnPTenantCdnOrigin. Information om hur du använder denna cmdlet finns i Get-PnPTenantCdnOrigin.
Ta bort ett ursprung från Office 365 CDN
Du kan ta bort åtkomst till en mapp SharePoint ett bibliotek som du har identifierat som ursprung. Det gör du med cmdleten Remove-PnPTenantCdnOrigin.
Remove-PnPTenantCdnOrigin -OriginUrl <path> -CdnType <Public | Private | Both>
Information om hur du använder denna cmdlet finns i Remove-PnPTenantCdnOrigin.
Ändra ett ursprung i Office 365 CDN
Du kan inte ändra ett ursprung som du har skapat. Ta istället bort ursprunget och lägg sedan till ett nytt. Mer information finns i Ta bort ett ursprung från Office 365 CDN Lägga till ett ursprung för dina tillgångar.
Inaktivera Office 365 CDN
Använd cmdleten Set-PnPTenantCdnEnabled till att inaktivera CDN för organisationen. Om du har aktiverat både offentliga och privata ursprung för CDN, måste du köra cmdleten två gånger enligt följande exempel.
Inaktivera användningen av offentliga ursprung i CDN genom att ange följande kommando:
Set-PnPTenantCdnEnabled -CdnType Public -Enable $false
Inaktivera användningen av privata ursprung i CDN genom att ange följande kommando:
Set-PnPTenantCdnEnabled -CdnType Private -Enable $false
Mer information om den här cmdleten finns i Set-PnPTenantCdnEnabled.
Konfigurera och konfigurera Office 365 CDN med hjälp av Office 365 CLI
För procedurerna i det här avsnittet krävs att du har installerat Office 365 CLI. Anslut sedan till Office 365 klientorganisation med kommandot inloggning.
Utför de här stegen för att konfigurera och konfigurera CDN att lagra dina tillgångar i SharePoint Online med hjälp av Office 365 CLI.
Klicka för att Visa
Aktivera Office 365 CDN
Du kan hantera statusen för Office 365 CDN klientorganisation med hjälp av kommandot för spo cdn-uppsättning.
Så här aktiverar Office 365 offentliga CDN i klientorganisationen:
spo cdn set --type Public --enabled true
Om du vill aktivera Office 365 SharePoint CDN kör du:
spo cdn set --type Private --enabled true
Visa aktuell status för Office 365 CDN
För att kontrollera om den specifika typen Office 365 CDN är aktiverad eller inaktiverad, använder du kommandot spo cdn get.
För att kontrollera om Office 365 offentliga CDN är aktiverad kör du:
spo cdn get --type Public
Visa Office 365 CDN ursprung
Om du vill visa de Office 365 offentliga CDN körs:
spo cdn origin list --type Public
Se Standard CDN ursprung för information om ursprung som är etablerade som standard när du aktiverar Office 365 CDN.
Lägga till ett Office 365 CDN ursprung
Viktigt
Du ska aldrig placera resurser som anses vara känsliga för organisationen i ett SharePoint-dokumentbibliotek som konfigurerats som ett offentligt ursprung.
Använd lägg till ett spo cdn-ursprung för att definiera ett CDN ursprung. Du kan definiera flera ursprung. Ursprunget är en URL-adress som pekar på SharePoint bibliotek eller mapp som innehåller tillgångarna som du vill ska lagras av CDN.
spo cdn origin add --type [Public | Private] --origin <path>
Var path finns den relativa sökvägen till mappen som innehåller tillgångarna. Du kan använda jokertecken utöver relativa sökvägar.
Om du vill ta med alla tillgångar i huvudsidesgalleriet för alla webbplatser som ett offentligt ursprung kör du:
spo cdn origin add --type Public --origin */masterpage
Om du vill konfigurera ett privat ursprung för en viss webbplatssamling kör du:
spo cdn origin add --type Private --origin sites/site1/siteassets
Anteckning
När du har CDN ett ursprung kan det ta upp till 15 minuter innan du kan hämta filer via CDN tjänsten. Du kan kontrollera om det specifika ursprunget redan har aktiverats med hjälp av kommandot för spo cdn-ursprung.
Ta bort ett Office 365 CDN ursprung
Använd kommandot ta bort spo cdn-ursprung för att ta bort ett CDN ursprung för den angivna CDN typen.
Om du vill ta bort ett offentligt ursprung CDN konfigurationen kör du:
spo cdn origin remove --type Public --origin */masterpage
Anteckning
När du tar CDN ett ursprung påverkas inte de filer som lagrats i något dokumentbibliotek som matchar ursprunget. Om tillgångarna har refererats med sina URL-SharePoint, växlar SharePoint automatiskt tillbaka till den ursprungliga URL:en som pekar till dokumentbiblioteket. Om däremot tillgångar har refererats med en offentlig URL CDN bryts länken om du tar bort ursprunget och du måste ändra dem manuellt.
Ändra ett Office 365 CDN ursprung
Det går inte att ändra ett befintligt CDN ursprung. I stället bör du ta bort det tidigare CDN ursprunget med kommandot spo cdn origin remove och lägga till ett nytt med hjälp av spo cdn origin add kommandot.
Ändra vilka typer av filer som ska ingå i Office 365 CDN
Som standard ingår följande filtyper i CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff och .woff2. Om du behöver ta med ytterligare filtyper i CDN kan du CDN konfiguration med hjälp av kommandot för spo cdn-principuppsättning.
Anteckning
När du ändrar listan över filtyper skriver du över den aktuella definierade listan. Om du vill ta med ytterligare filtyper använder du först spo cdn-principlistan för att ta reda på vilka filtyper som är konfigurerade.
Om du vill lägga till JSON-filtypen i standardlistan över filtyper som ingår i den offentliga CDN kör du:
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 webbplatsklassificeringarna som du vill utesluta från Office 365 CDN
Använd kommandot för spo cdn-principuppsättningen för att utesluta webbplatsklassificering som du inte vill ska vara tillgängliga via CDN. Som standard utesluts inga webbplatsklassificeringar.
Anteckning
När du ändrar listan med undantagna webbplatsklassificeringar skriver du över den definierade listan. Om du vill utesluta ytterligare klassificeringar använder du först listkommandot för spo cdn-principen för att ta reda på vilka klassificeringar som är konfigurerade.
Om du vill utesluta webbplatser som klassificerats som HBI från den offentliga CDN ska du utföra
spo cdn policy set --type Public --policy ExcludeRestrictedSiteClassifications --value "HBI"
Inaktivera Office 365 CDN
Om du vill Office 365 CDN du spo cdn set använda kommandot, till exempel:
spo cdn set --type Public --enabled false
Använda dina CDN tillgångar
Nu när du har aktiverat CDN och konfigurerade ursprung och principer kan du börja använda dina CDN tillgångar.
Det här avsnittet hjälper dig att förstå hur du använder URL-adresser för CDN på dina SharePoint-sidor och innehåll så att SharePoint omdirigerar förfrågningar om tillgångar i både offentliga och privata ursprung till CDN.
- Uppdatera länkar till CDN tillgångar
- Använda tillgångar i offentliga ursprung
- Använda tillgångar i privata ursprung
Information om hur du använder CDN för värd för klientwebbdelar finns i avsnittet Värd för din klientwebbdel från Office 365 CDN (Hello World del 4).
Anteckning
Om du lägger till mappen ClientSideAssets i CDN privata ursprungslista går det CDN anpassade webbdelar som är värd inte att återges. Filer som används av SPFX-webbdelar kan endast använda offentliga CDN och mappen ClientSideAssets är ett standard ursprung för offentliga CDN.
Uppdatera länkar till CDN tillgångar
Om du vill använda tillgå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 ursprunget.
- Redigera sidan eller innehållet som innehåller länkar till tillgångar som du har lagt till i ett ursprung. Du kan också använda en av flera metoder för att globalt söka och ersätta länkar över en ange webbplats eller webbplatssamling om du vill uppdatera länken till en viss tillgång överallt där den visas.
- För varje länk till en tillgång i ett ursprung ersätter du sökvägen med sökvägen till filen i CDN ursprung. Du kan använda relativa sökvägar.
- Spara sidan eller innehållet.
Överväg till exempel bilden /site/SiteAssets/images/image.png, som du har kopierat till dokumentbiblioteksmappen /site/CDN_origins/public/. Om du vill använda CDN-tillgången ersätter du den ursprungliga sökvägen till bildfilens plats med sökvägen till ursprunget för att göra den nya URL:en /webbplats/CDN_origins/offentlig/image.png.
Om du vill använda den fullständiga URL:en till tillgången i stället för en relativ sökväg skapar du länken så här:
https://<TenantHostName>.sharepoint.com/sites/site/CDN_origins/public/image.png
Anteckning
I allmänhet bör du inte hårdkoda URL-adresser direkt till tillgångar i CDN. Om det behövs kan du dock manuellt skapa URL-adresser för tillgångar i offentliga ursprung. Mer information finns i Hardcoding CDN URL:er för offentliga tillgångar.
Mer information om hur du verifierar att tillgångar kommer från CDN finns i Hur bekräftar jag att tillgångarna CDN? i Felsökning av Office 365 CDN.
Använda tillgångar i offentliga ursprung
Publiceringsfunktionen i SharePoint Online skriver automatiskt om URL-adresser för tillgångar som lagras i offentliga ursprung till sina CDN-motsvarigheter så att tillgångar hämtas från CDN-tjänsten i stället för SharePoint.
Om ditt ursprung är på en webbplats där publiceringsfunktionen är aktiverad och tillgångarna du vill lägga i förs över till CDN finns i någon av följande kategorier skriver SharePoint automatiskt om URL-adresser för tillgångar i ursprunget, förutsatt att tillgången inte har uteslutits av en CDN-princip.
Nedan följer en översikt över vilka länkar som automatiskt skrivs om av SharePoint Publiceringsfunktion:
- HTML-svar för IMG/LINK/CSS
- Det omfattar bilder som har lagts till av författare i HTML-innehåll på en sida
- URL-adresser för webbdelen Bildspel för bildbibliotek
- Bildfält i SPList REST API-resultat (RenderListDataAsStream)
- Använda den nya egenskapen ImageFieldsToTryRewriteToCdnUrls till att ange en kommaavgränsad lista med fält
- Stöd för hyperlänkfält och publiceringsbildfält
- SharePoint bildåtergivningar
Följande diagram visar arbetsflödet när en SharePoint får en begäran om en sida som innehåller tillgångar från ett offentligt ursprung.

Tips
Om du vill inaktivera automatisk omskrivning av specifika URL:er på en sida kan du gå till sidan och lägga till frågesträngparametern ? NoAutoReWrites=true i slutet av varje länk du vill inaktivera.
Konstruera CDN URL:er för offentliga tillgångar
Om funktionen Publicera inte är aktiverad för ett offentligt ursprung, eller om tillgången inte är en av de länktyper som stöds av funktionen för automatisk omskrivning i CDN-tjänsten, kan du manuellt skapa URL-adresser till tillgångarnas CDN-plats och använda url:erna i innehållet.
Anteckning
Du kan inte hårdkoda eller skapa CDN URL-adresser till tillgångar i ett privat ursprung eftersom den obligatoriska åtkomsttoken som utgör url-adressens sista avsnitt genereras när resursen begärs. Du kan skapa URL-adressen för offentliga CDN och URL-adressen ska inte vara hårdkodad eftersom den kan komma att ändras.
För offentliga CDN tillgångar ser URL-formatet ut så här:
https://publiccdn.sharepointonline.com/<TenantHostName>/sites/site/library/asset.png
Ersätt TenantHostName med ditt klientnamn. Exempel:
https://publiccdn.sharepointonline.com/contoso.sharepoint.com/sites/site/library/asset.png
Anteckning
Sidsammanhangsegenskapen ska användas för att skapa prefixet i stället för hårdkodning " https://publiccdn.sharepointonline.com ". URL-adressen kan komma att ändras och ska inte vara hårdkodad. Om du använder visningsmallar med Classic SharePoint Online kan du använda egenskapen "window._spPageContextInfo.publicCdnBaseUrl" i visningsmallen för prefixet på URL-adressen. Om du är SPFx-webbdelar för moderna och klassiska SharePoint kan du använda egenskapen "this.context.pageContext.legacyPageContext.publicCdnBaseUrl". Det ger prefixet så att din implementering uppdateras med den om den ändras. Som exempel för SPFx kan URL-adressen skapas med egenskapen "this.context.pageContext.legacyPageContext.publicCdnBaseUrl" + "/" + "host" + "/" + "relativeURL för objektet". Se Använda CDN i Klientkod som är en del av prestandaserien för säsong 1
Använda tillgångar i privata ursprung
Ingen ytterligare konfiguration krävs för att använda tillgångar i privata ursprung. SharePoint Online skriver automatiskt om URL-adresser för tillgångar i privata ursprung, så förfrågningar om dessa tillgångar kommer alltid att hämtas från CDN. Du kan inte skapa URL-adresser manuellt till CDN-tillgångar i privata ursprung eftersom dessa URL:er innehåller token som måste skapas automatiskt av SharePoint Online när tillgången begärs.
Åtkomst till tillgångar i privata ursprung skyddas av dynamiskt genererade token baserat på användarbehörigheter till ursprunget, med de varningar som beskrivs i följande avsnitt. Användarna måste ha minst läsbehörighet till ursprungen för att CDN återge innehåll.
Följande diagram visar arbetsflödet när en SharePoint får en begäran om en sida som innehåller tillgångar från ett privat ursprung.

Tokenbaserad auktorisering i privata ursprung
Åtkomst till tillgångar i privata ursprung i Office 365 CDN tilldelas med token som genereras av SharePoint Online. Användare som redan har åtkomst till mappen eller biblioteket som anges av ursprunget tilldelas automatiskt token som tillåter användaren att komma åt filen baserat på deras behörighetsnivå. Dessa åtkomsttoken är giltiga i 30 till 90 minuter efter att de har skapats för att förhindra attacker vid tokenuppspelning.
När åtkomsttoken har skapats returnerar SharePoint Online en anpassad URI till klienten som innehåller två auktoriseringsparametrar äter (edge authorization token) och oat (origin authorization token). Strukturen för varje token är< förfallotid i Epoch-tidsformatet som är >__< signaturens säkra >. Till exempel:
https://privatecdn.sharepointonline.com/contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg?eat=1486154359_cc59042c5c55c90b26a2775323c7c8112718431228fe84d568a3795a63912840&oat=1486154359_7d73c2e3ba4b7b1f97242332900616db0d4ffb04312
Anteckning
Alla som äger token kan komma åt resursen i CDN. Url-adresser som innehåller dessa åtkomsttoken delas däremot bara över HTTPS, så om inte URL-adressen uttryckligen delas av en slutanvändare innan tokenen löper ut kommer tillgången inte att vara tillgänglig för obehöriga användare.
Behörigheter på objektnivå stöds inte för tillgångar i privata ursprung
Det är viktigt att observera att SharePoint Online inte har stöd för behörigheter på objektnivå för tillgångar i privata ursprung. För en fil som finns på https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg , har användarna till exempel effektiv åtkomst till filen enligt följande villkor:
| Användare | Behörigheter | Effektiv åtkomst |
|---|---|---|
| Användare 1 | Har åtkomst till mapp1 | Kan komma image1.jpg från CDN |
| Användare 2 | Har inte åtkomst till mapp1 | Det går inte image1.jpg åtkomst från CDN |
| Användare 3 | Har inte åtkomst till mapp1, men tilldelas uttrycklig åtkomstbehörighet för image1.jpg i SharePoint Online | Kan komma åt image1.jpg direkt SharePoint Online, men inte från CDN |
| Användare 4 | Har åtkomst till mapp1, men har uttryckligen nekats åtkomst till image1.jpg i SharePoint Online | Det går inte att komma åt tillgången från SharePoint Online, men kan komma åt tillgången från CDN trots att åtkomst till filen nekas i SharePoint Online |
Felsöka Office 365 CDN
Hur bekräftar jag att tillgångar används av CDN?
När du har lagt till länkar till CDN-tillgångar på en sida kan du bekräfta att tillgången kommer från CDN genom att gå till sidan, högerklicka på bilden när den har återgets och granskar bild-URL:en.
Du kan också använda webbläsarens utvecklarverktyg för att visa URL-adressen för varje tillgång på en sida, eller använda ett nätverksspårningsverktyg från tredje part.
Anteckning
Om du använder ett nätverksverktyg, till exempel Fiddler, för att testa dina tillgångar utanför att återge tillgången från en SharePoint-sida, måste du manuellt lägga till refererhuvudet "Referer: " i Get https://yourdomain.sharepoint.com request where the URL is the root URL of your SharePoint Online tenant.
Du kan inte CDN url-adresser direkt i en webbläsare eftersom du måste ha en SharePoint Online. Men om du lägger till URL CDN för CDN-tillgång på en SharePoint-sida och sedan öppnar sidan i en webbläsare, ser du CDN tillgång återges på sidan.
Mer information om hur du använder utvecklarverktygen i webbläsaren Microsoft Edge finns i Microsoft Edge Utvecklarverktyg.
Om du vill titta på en kort video som finns i youTube-kanalen SharePoint Developer Patterns och Practices som visar hur du verifierar att din CDN fungerar kan du gå till Verifiera din CDN-användning och säkerställa optimal nätverksanslutning.
Varför är tillgångar från ett nytt ursprung inte tillgängliga?
Tillgångar i nya ursprung blir inte omedelbart tillgängliga för användning eftersom det tar tid för registreringen att spridas genom CDN och för att tillgångarna ska laddas upp från ursprunget till CDN lagring. Tiden som krävs för att tillgångar ska vara tillgänglig i CDN beror på hur många tillgångar och filstorlekar.
Min klientwebbdel eller SharePoint Framework inte fungerar
När du aktiverar Office 365 CDN för offentliga ursprung skapas CDN ursprung automatiskt:
- */MASTERPAGE
- */STYLE LIBRARY
- */CLIENTSIDEASSETS
Om ursprunget */clientsideassets saknas kommer SharePoint Framework misslyckas och inga varningar eller felmeddelanden skapas. Det här ursprunget kan saknas antingen eftersom CDN var aktiverat med parametern -NoDefaultOrigins inställt på $true, eller för att ursprunget togs bort manuellt.
Du kan kontrollera vilka ursprung som finns med följande PowerShell-kommando:
Get-SPOTenantCdnOrigins -CdnType Public
Du kan också kontrollera med Office 365 CLI:
spo cdn origin list
Så här lägger du till ursprunget i PowerShell:
Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS
Så här lägger du till ursprunget i Office 365 CLI:
spo cdn origin add --origin */CLIENTSIDEASSETS
Vilka PowerShell-moduler och CLI-gränssnitt behöver jag arbeta med Office 365 CDN?
Du kan välja att arbeta med Office 365 CDN med hjälp SharePoint Online Management Shell PowerShell-modulen eller Office 365 CLI.
Se även
Nätverk för innehållsleverans (CDN)