Office 365 sisällön toimitusverkoston (CDN) käyttäminen SharePoint Onlinen kanssa

  • Artikkeli
  • 29 minuutin lukuaika

Voit käyttää sisäistä Office 365 Content Delivery Networkia (CDN) staattisten resurssien isännöinnissä, mikä parantaa SharePoint Online -sivujen suorituskykyä. Office 365 CDN parantaa suorituskykyä tallentamalla staattisia resursseja välimuistiin, joka on lähempänä niitä pyytäviä selaimia, mikä auttaa nopeuttamaan latauksia ja pienentämään viivettä. Lisäksi Office 365 CDN käyttää HTTP/2-protokollaa parannetun pakkaamisen ja HTTP-pipelinoinnin parantamiseen. Office 365 CDN -palvelu sisältyy SharePoint Online -tilaukseesi.

Varoitus

Koska kuvia hallitaan nyt automaattisesti SharePoint Online -palvelun hallitsemassa yksityisessä CDN:ssä, manuaalisesti määritetty yksityinen CDN on vanhentumassa. Tämä tarkoittaa sitä, että asiakkaiden ei enää tarvitse määrittää yksityistä CDN:tä. Suositeltu käytäntö pysyy samana, sillä kuvia isännöidään automaattisesti palvelun hallitseman yksityisen CDN:n kautta, ja julkinen sisältöverkko on edelleen käytettävissä kaikissa muissa tiedostotyypeissä, kuten CSS:ssä ja JS:ssä. Asiakkaiden, jotka käyttävät yksityistä CDN:tä muille tiedostotyypeille kuin kuville, on siirrettävä nämä tiedostot julkiseen sisältöverkkoon. Näiden tiedostotyyppien suorituskyvyn parantamiseksi suositellaan julkista cdn-levyä.

Huomautus

Office 365 CDN on käytettävissä vain tuotannon (maailmanlaajuisen) pilvipalvelun vuokraajille. Yhdysvaltain valtionhallinnon ja Kiinan pilvipalveluiden vuokraajat eivät tällä hetkellä tue Office 365 CDN:tä.

Office 365 CDN koostuu useista CDN:istä, joiden avulla voit isännöidä staattisia resursseja useissa sijainneissa tai alkuperässä ja palvella niitä globaaleista nopeista verkoista. Sen mukaan, millaista sisältöä haluat isännöidä Office 365 CDN:ssä, voit lisätä julkista alkuperää, yksityistä alkuperää tai molempia. Lisätietoja julkisten ja yksityisten alkuperän eroista on kohdassa Valitse, tuleeko kunkin alkuperän olla julkinen vai yksityinen .

Office 365 CDN-käsitekaaviota.

Jos cdn-levyjen toiminta on sinulle jo tuttua, sinun tarvitsee suorittaa vain muutama vaihe, jotta voit ottaa Office 365 CDN:n käyttöön vuokraajassasi. Tässä aiheessa kuvataan, miten. Lue lisätietoja staattisten resurssien isännöinnin aloittamisesta.

Vihje

On myös muita Microsoftin isännöimät CDN-levyt, joita voidaan käyttää Office 365 kanssa erityisissä käyttötilanteissa, mutta joita ei käsitellä tässä ohjeaiheessa, koska ne eivät kuulu Office 365 CDN:n piiriin. Lisätietoja on kohdassa Muut MicrosoftIN CDN-levyt.

Palaa Office 365 verkon suunnitteluun ja suorituskyvyn säätöön.

Yleiskatsaus Office 365 CDN:n käsittelemiseen SharePoint Onlinessa

Voit määrittää Office 365 CDN:n organisaatiollesi seuraavasti:

Kun asennus on valmis, voit hallita Office 365 CDN:n ajan kuluessa seuraavasti:

  • Resurssien lisääminen, päivittäminen ja poistaminen
  • Origojen lisääminen ja poistaminen
  • MÄÄRITETÄÄN CDN-käytäntöjä
  • Poista CDN tarvittaessa käytöstä

Katso lopuksi artikkelista CDN-resurssien käyttäminen lisätietoja CDN-resurssien käytöstä sekä julkisista että yksityisistä lähteistä.

Lisätietoja yleisten ongelmien ratkaisemisesta on artikkelissa Office 365 CDN:n vianmääritys.

Office 365 CDN:n käyttöönottosuunnitelma

Ennen kuin otat Office 365 CDN:n käyttöön Office 365 vuokraajassasi, suunnitteluprosessissa kannattaa ottaa huomioon seuraavat tekijät.

Määritä, mitä staattisia resursseja haluat isännöidä CDN:ssä

Yleensä CDN:t ovat tehokkaimpia staattisten resurssien isännöinnissä tai resursseissa, jotka eivät muutu kovin usein. Hyvä ohjesääntö on tunnistaa tiedostot, jotka täyttävät kaikki tai jotkin näistä ehdoista:

  • Sivulle upotetut staattiset tiedostot (kuten komentosarjat ja kuvat), joilla voi olla merkittävä lisäävä vaikutus sivun latausajainteihin
  • Suuret tiedostot, kuten suoritettavat tiedostot ja asennustiedostot
  • Asiakaspuolen koodia tukevat resurssikirjastot

Esimerkiksi pieniä tiedostoja, joita pyydetään toistuvasti, kuten sivuston kuvia ja komentosarjoja, voidaan parantaa merkittävästi sivuston hahmonnuksen suorituskykyä ja vähentää lisäävästi SharePoint Online -sivustojen kuormitusta, kun lisäät ne CDN-alkuperään. Suuremmat tiedostot, kuten asennustiedostot, voidaan ladata CDN:stä, mikä heikentää suorituskykyä ja vähentää näin SharePoint Online -sivuston kuormitusta, vaikka niitä ei käytetä yhtä usein.

Tiedostokohtainen suorituskyvyn parannus riippuu useista tekijöistä, kuten asiakkaan läheisyydestä lähimpään CDN-päätepisteeseen, tilapäisistä olosuhteista paikallisessa verkossa ja niin edelleen. Monet staattiset tiedostot ovat melko pieniä, ja ne voidaan ladata Office 365 alle sekunnissa. Verkkosivu saattaa kuitenkin sisältää useita upotettuja tiedostoja, joiden kumulatiivinen latausaika on useita sekunteja. Näiden tiedostojen toimittaminen CDN:stä voi lyhentää merkittävästi sivun kokonaiskuormitusaikaa. Katso esimerkiksi, mitä suorituskykyhyötyjä CDN tarjoaa?

Määritä, minne haluat tallentaa resurssit

CDN noutaa resurssisi sijainnista, jonka nimi on alkuperä. Alkuperä voi olla SharePoint-sivusto, tiedostokirjasto tai kansio, jota VOI käyttää URL-osoitteen kautta. Sinulla on suuri joustavuus, kun määrität alkuperän organisaatiollesi. Voit esimerkiksi määrittää useita alkuperänimiä tai yhden alkuperän, johon haluat sijoittaa kaikki CDN-resurssisi. Voit valita organisaatiollesi sekä julkisen että yksityisen alkuperän. Useimmat organisaatiot päättävät ottaa käyttöön yhdistelmän näistä kahdesta.

Voit luoda uuden säilön origoillesi, kuten kansioille tai tiedostokirjastoille, ja lisätä tiedostoja, jotka haluat ottaa käyttöön CDN:ssä. Tämä on hyvä tapa, jos sinulla on tietty joukko resursseja, joiden haluat olevan käytettävissä CDN:stä, ja haluat rajoittaa CDN-resurssien joukon vain säilössä oleviin tiedostoihin.

Voit myös määrittää alkuperäksi aiemmin luodun sivustokokoelman, sivuston, kirjaston tai kansion, jolloin kaikki säilön oikeutetut resurssit ovat käytettävissä CDN:ssä. Ennen kuin lisäät olemassa olevan säilön alkuperäksi, on tärkeää varmistaa, että olet tietoinen sen sisällöstä ja käyttöoikeuksista, jotta et tahattomasti paljasta resursseja anonyymille käyttöoikeudelle tai valtuuttamattomille käyttäjille.

Voit määrittää CDN-käytäntöjä , jos haluat jättää alkuperäsi sisällön pois CDN:stä. CDN-käytännöt sulkevat pois julkisen tai yksityisen alkuperän kohteet määritteiden, kuten tiedostotyypin ja sivustoluokituksen, mukaan, ja niitä sovelletaan käytännön määrittämän CdnType-tyypin (yksityinen tai julkinen) kaikkiin alkuperään. Jos esimerkiksi lisäät yksityisen alkuperän, joka koostuu useita alisivustoja sisältävästä sivustosta, voit määrittää käytännön, joka sulkee pois Luottamuksellisiksi merkityt sivustot, joten sisältöä sivustoista, joissa luokitusta sovelletaan, ei paljaiteta CDN:stä. Käytäntöä sovelletaan sisältöön kaikista yksityisistä alkuperästä, jotka olet lisännyt CDN:hen.

Muista, että mitä suurempi alkuperän määrä, sitä suurempi vaikutus siihen, kuinka kauan CDN-palvelulla kestää käsitellä pyyntöjä. Suosittelemme, että rajoitat alkuperän määrää mahdollisimman paljon.

Valitse, onko kunkin alkuperän oltava julkinen vai yksityinen

Kun tunnistat alkuperän, määrität, tehdäänkö siitä julkinen vai yksityinen. CdN-resurssien käyttö julkisissa lähteissä on anonyymiä sisältöä, ja yksityisen alkuperän CDN-sisältö suojataan dynaamisesti luoduilla tunnuksilla suojauksen lisäämiseksi. Riippumatta siitä, minkä vaihtoehdon valitset, Microsoft tekee kaiken raskaan työn puolestasi, kun kyse on itse CDN:n hallinnoinnista. Voit myös muuttaa mielesi myöhemmin, kun olet määrittänyt CDN:n ja tunnistanut alkuperäsi.

Sekä julkiset että yksityiset vaihtoehdot tarjoavat samanlaisia suorituskykyhyötyjä, mutta kummallakin on ainutlaatuisia ominaisuuksia ja etuja.

CDN Office 365 säätöpalvelun julkiset alkuperät ovat käytettävissä anonyymisti, ja isännöityjä resursseja voivat käyttää kaikki, joilla on resurssin URL-osoite. Koska julkisen alkuperän sisällön käyttöoikeus on anonyymi, niitä tulisi käyttää vain ei-luottamuksellisen yleisen sisällön, kuten JavaScript-tiedostojen, komentosarjojen, kuvakkeiden ja kuvien, välimuistiin välimuistiin.

OFFICE 365 CDN:n yksityiset alkuperät tarjoavat yksityisen käyttöoikeuden käyttäjäsisältöön, kuten SharePoint Online -tiedostokirjastoihin, sivustoihin ja omistusoikeudellisia kuvia. Yksityisen alkuperän sisällön käyttöoikeus suojataan dynaamisesti luoduilla tunnuksilla, joten vain käyttäjät, joilla on alkuperäisen tiedostokirjaston tai tallennussijainnin käyttöoikeudet, voivat käyttää sitä. OFFICE 365 CDN:n yksityisiä alkuperänimiä voi käyttää vain SharePoint Online -sisällössä, ja voit käyttää vain yksityisperäisiä resursseja sharepoint online -vuokraajan uudelleenohjauksen avulla.

Voit lukea lisää siitä, miten CDN:n yksityisen alkuperän resurssien käyttö toimii kohdassa Resurssien käyttäminen yksityisissä lähteissä.

Julkisten resurssien isännöinnin ominaisuudet ja edut

  • Kaikki, jotka ovat alttiina julkisessa alkuperässä, voivat käyttää resursseja anonyymisti.

    Tärkeää

    Älä koskaan sijoita resursseja, jotka sisältävät käyttäjätietoja tai joita pidetään luottamuksellisina organisaatiollesi julkisessa alkuperässä.

  • Jos poistat omaisuuden julkisesta alkuperästä, resurssi voi olla käytettävissä jopa 30 päivää välimuistista. Linkit sisältöverkkoon mitätöidään 15 minuutin kuluessa.

  • Kun isännöit tyylisivuja (CSS-tiedostoja) julkisessa alkuperässä, voit käyttää koodissa suhteellisia polkuja ja URI-osoitteita. Tämä tarkoittaa sitä, että voit viitata taustakuvien ja muiden objektien sijaintiin suhteessa sitä kutsuvan resurssin sijaintiin.

  • Vaikka voit muodostaa julkisen alkuperän URL-osoitteen, sinun on toimittava varovasti ja varmistettava, että käytät sivukontekstiominaisuutta, ja noudata ohjeita. Tämä johtuu siitä, että jos CDN:n käyttö ei ole enää käytettävissä, URL-osoite ei automaattisesti toimi sharepoint online -organisaatiossasi ja se voi aiheuttaa katkenneita linkkejä ja muita virheitä. URL-osoite voi myös muuttua, minkä vuoksi se ei saa olla kiinteästi koodattu nykyiseen arvoonsa.

  • Julkisen alkuperän oletustiedostotyypit ovat .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff ja .woff2. Voit määrittää muita tiedostotyyppejä.

  • Voit määrittää käytännön, joka sulkee pois resurssit, jotka on tunnistettu määrittämieni sivustoluokittelujen perusteella. Voit esimerkiksi jättää pois kaikki resurssit, jotka on merkitty luottamuksellisiksi tai rajoitetuiksi, vaikka ne olisivat sallittuja tiedostotyyppejä ja sijaitsevat julkisessa alkuperässä.

Yksityisomistuksessa olevien resurssien isännöinnin ominaisuudet ja edut

  • Yksityisiä alkuperää voi käyttää vain SharePoint Online -resursseille.

  • Käyttäjät voivat käyttää resursseja vain yksityisestä alkuperästä, jos heillä on oikeudet käyttää säilöä. Näiden resurssien anonyymi käyttö estetään.

  • Yksityiseen alkuperään kuuluviin resursseihin on viitattava SharePoint Online -vuokraajassa. Yksityisten CDN-resurssien suora käyttö ei toimi.

  • Jos poistat omaisuuden yksityisestä alkuperästä, resurssi saattaa olla käytettävissä jopa tunnin ajan välimuistista. Mitätöimme kuitenkin linkit resurssiin CDN:ssä 15 minuutin kuluessa omaisuuden poistamisesta.

  • Yksityisiin alkuperään sisältyvät oletustiedostotyypit ovat .gif, .ico, .jpeg, .jpg, .js ja .png. Voit määrittää muita tiedostotyyppejä.

  • Kuten julkisissakin luokissa, voit määrittää käytännön siten, että se sulkee pois resurssit, jotka on tunnistettu määrittämälläsi sivustoluokittelulla, vaikka käyttäisit yleismerkkejä kaikkien kansioon tai tiedostokirjastoon kuuluvien resurssien sisällyttämiseen.

Lisätietoja Office 365 CDN:n käytöstä, yleisistä CDN-käsitteistä ja muista MicrosoftIN CDN-levyistä, joita voit käyttää Office 365 vuokraajan kanssa, on kohdassa Sisällön toimitusverkot.

CDN:n oletusalkuperät

Jos et määritä toisin, Office 365 määrittää sinulle oletusalkuperät, kun otat Office 365 CDN:n käyttöön. Jos päätät olla valmistelematta niitä, voit lisätä nämä alkuperät asennuksen jälkeen. Jos et ymmärrä oletusalkuperän määrityksen ohittamisen seurauksia ja sinulla on siihen erityinen syy, salli niiden luominen, kun otat CDN:n käyttöön.

Oletusarvoiset yksityiset CDN-alkuperät:

  • */työmaakokoonpanot

Julkiset CDN-oletusalkuperät:

  • */perustyylisivu
  • */tyylikirjasto
  • */asiakasohjelmat

Huomautus

clientsideassets on julkinen oletusalkuperä, joka lisättiin Office 365 CDN -palveluun joulukuussa 2017. Tämä alkuperä on oltava olemassa, jotta SharePoint Framework ratkaisut CDN:ssä toimivat. Jos otit Office 365 CDN:n käyttöön ennen joulukuuta 2017 tai jos ohitit oletusalkuperän määrityksen, kun otit CDN:n käyttöön, voit lisätä tämän alkuperän manuaalisesti. Lisätietoja on kohdassa Oma asiakaspuolen verkko-osa tai SharePoint Framework ratkaisu ei toimi.

Office 365 CDN:n määrittäminen ja määrittäminen SharePoint Online Management Shellin avulla

Tämän osion toimintosarjoissa edellytetään, että muodostat yhteyden SharePoint Onlineen SharePoint Online -hallintaliittymän avulla. Katso ohjeet artikkelista Yhteyden muodostaminen SharePoint Online PowerShelliin.

Suorita nämä vaiheet, kun haluat määrittää CDN:n isännöimään resurssejasi SharePoint Onlinessa SharePoint Online Management Shellin avulla.

Laajenna napsauttamalla

Salli organisaatiosi käyttää Office 365 CDN:tä

Ennen kuin teet muutoksia vuokraajan CDN-asetuksiin, sinun on noudettava yksityisen CDN-määrityksen nykyinen tila Office 365 vuokraajassa. Muodosta yhteys vuokraajaan SharePoint Online Management Shellin avulla:

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

Hae nyt CDN-tila-asetukset vuokraajasta Get-SPOTenantCdnEnabled-cmdlet-komennolla :

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Määritetyn CdnType-arvon CDN-tila tulostuu näyttöön.

Käytä Set-SPOTenantCdnEnabled cmdlet-komentoa, jotta organisaatiosi voi käyttää Office 365 CDN:n. Voit antaa organisaatiollesi mahdollisuuden käyttää julkista alkuperää, yksityistä alkuperää tai molempia kerralla. Voit myös määrittää CDN:n ohittamaan oletusaloitusten määritykset, kun otat sen käyttöön. Voit aina lisätä nämä alkuperät myöhemmin tässä ohjeaiheessa kuvatulla tavalla.

SharePoint Onlinen Windows PowerShell:

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

Jos haluat esimerkiksi, että organisaatiosi voi käyttää sekä julkista että yksityistä alkuperää, kirjoita seuraava komento:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Jos haluat, että organisaatiosi voi käyttää sekä julkisia että yksityisiä alkuperätietoja, mutta ohittaa oletusalkuperän määrittämisen, kirjoita seuraava komento:

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

Katso cdn-oletusalkuperästä lisätietoja alkuperästä, joka valmistellaan oletusarvoisesti, kun Office 365 CDN otetaan käyttöön, sekä oletusalkuperän määrityksen ohittamisen mahdollisista vaikutuksista.

Jos haluat, että organisaatiosi voi käyttää julkista alkuperää, kirjoita seuraava komento:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Jos haluat, että organisaatiosi voi käyttää yksityisiä alkuperätietoja, kirjoita seuraava komento:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Lisätietoja tästä cmdlet-komennosta on kohdassa Set-SPOTenantCdnEnabled.

Muuta Office 365 CDN:hen sisällytettävien tiedostotyyppien luettelo (valinnainen)

Vihje

Kun määrität tiedostotyyppejä Set-SPOTenantCdnPolicy cmdlet-komennolla , korvaat tällä hetkellä määritetyn luettelon. Jos haluat lisätä luetteloon lisää tiedostotyyppejä, selvitä ensin cmdlet-komennolla, mitkä tiedostotyypit ovat jo sallittuja, ja sisällytä ne luetteloon uusien tiedostotyyppien ohella.

Set-SPOTenantCdnPolicy cmdlet-komennolla voit määrittää staattisia tiedostotyyppejä, joita voidaan isännöidä cdn-levyn julkisen ja yksityisen alkuperän mukaan. Oletusarvoisesti sallitaan yleiset resurssityypit, kuten .css, .gif, .jpg ja .js.

SharePoint Onlinen Windows PowerShell:

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

Jos haluat esimerkiksi, että CDN isännöi .css- ja .png-tiedostoja, anna komento:

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

Jos haluat nähdä, mitä tiedostotyyppejä CDN tällä hetkellä sallii, käytä Get-SPOTenantCdnPolicies cmdlet-komentoa :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Lisätietoja näistä cmdlet-komennoista on kohdassa Set-SPOTenantCdnPolicy ja Get-SPOTenantCdnPolicies.

Muuta niiden sivustoluokittelujen luetteloa, jotka haluat jättää pois Office 365 CDN:stä (valinnainen)

Vihje

Kun suljet sivustoluokitukset pois set-SPOTenantCdnPolicy cmdlet-komennolla , korvaat tällä hetkellä määritetyn luettelon. Jos haluat jättää pois muita sivustoluokitteluja, käytä ensin cmdlet-komentoa selvittääksesi, mitkä luokitukset on jo jätetty pois, ja lisätä ne sitten uusien luokitusten ohella.

Käytä Set-SPOTenantCdnPolicy cmdlet-komentoa, jos haluat jättää pois sivustoluokitukset, joita et halua käyttää CDN:ssä. Sivustoluokitteluja ei oletusarvoisesti suljeta pois.

SharePoint Onlinen Windows PowerShell:

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

Jos haluat nähdä, mitä sivustoluokitteluja on rajoitettu tällä hetkellä, käytä Get-SPOTenantCdnPolicies cmdlet-komentoa :

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Palautettavat ominaisuudet ovat IncludeFileExtensions, ExcludeRestrictedSiteClassifications ja ExcludeIfNoScriptDisabled.

IncludeFileExtensions-ominaisuus sisältää luettelon tiedostotunnisteista, jotka tarjotaan CDN:ltä.

Huomautus

Oletusarvoiset tiedostotunnisteet eroavat julkisen ja yksityisen tiedostotunnisteen välillä.

ExcludeRestrictedSiteClassifications-ominaisuus sisältää sivuston luokitukset, jotka haluat jättää pois CDN:stä. Voit esimerkiksi jättää pois Sivustot, jotka on merkitty luottamuksellisiksi , joten sisältöä sivustoista, joiden luokitusta käytetään, ei toimiteta CDN:stä.

ExcludeIfNoScriptDisabled-ominaisuus jättää pois SISÄLTÖÄ CDN:stä sivustotason NoScript-määriteasetusten perusteella. Oletuksena NoScript-määritteen arvoksi on määritetty Käytössämoderneille sivustoille ja Poistettu käytöstäperinteisissä sivustoissa. Tämä riippuu vuokraaja-asetuksistasi.

Lisätietoja näistä cmdlet-komennoista on kohdassa Set-SPOTenantCdnPolicy ja Get-SPOTenantCdnPolicies.

Lisää alkuperä resursseillesi

Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa alkuperän määrittämiseen. Voit määrittää useita origoja. Alkuperä on URL-osoite, joka osoittaa SharePoint-kirjastoon tai -kansioon, joka sisältää resurssit, joita haluat käyttää CDN:n isännöimänä.

Tärkeää

Älä koskaan sijoita resursseja, jotka sisältävät käyttäjätietoja tai joita pidetään luottamuksellisina organisaatiollesi julkisessa alkuperässä.

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

Polun arvo on sen kirjaston tai kansion suhteellinen polku, joka sisältää resurssit. Voit käyttää yleismerkkejä suhteellisten polkujen lisäksi. Alkuperät tukevat URL-osoitteeseen liitettyjä yleismerkkejä. Näin voit luoda origoja, jotka ulottuvat useille sivustoille. Jos esimerkiksi haluat sisällyttää kaikkien sivustojesi kaikki resurssit perustyylisivujen kansioon julkisena alkuperänä CDN:ssä, kirjoita seuraava komento:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Yleismerkkimuunninta */ voi käyttää vain polun alussa, ja se vastaa kaikkia määritetyn URL-osoitteen URL-segmenttejä.
  • Polku voi osoittaa tiedostokirjastoon, kansioon tai sivustoon. Esimerkiksi polku */sivusto1 vastaa kaikkia sivuston tiedostokirjastoja.

Voit lisätä origon tietyllä suhteellisella polulla. Origoa ei voi lisätä käyttämällä täyttä polkua.

Tässä esimerkissä sivustokokoonpanokirjaston yksityinen alkuperä lisätään tiettyyn sivustoon:

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

Tässä esimerkissä lisätään sivustokokoelman sivustoresurssikirjaston folder1-kansion yksityinen alkuperä:

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

Jos polussa on välilyönti, voit joko ympäröidä polun lainausmerkeissä tai korvata välilyönnin URL-koodauksella %20. Seuraavissa esimerkeissä lisätään sivustokokoelman sivustoresurssikirjaston kansion 1 kansion yksityinen alkuperä:

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

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

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-SPOTenantCdnOrigin.

Huomautus

Yksityisissä lähteissä alkuperästä jaettavien resurssien pääversion on oltava julkaistu, ennen kuin niitä voidaan käyttää CDN:stä.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: Määritä julkinen alkuperä perustyylisivuille ja SharePoint Onlinen tyylikirjastolle

Yleensä nämä alkuperät määritetään oletusarvoisesti, kun otat Office 365 CDN:n käyttöön. Jos kuitenkin haluat ottaa ne käyttöön manuaalisesti, toimi seuraavasti.

  • Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa, kun haluat määrittää tyylikirjaston julkiseksi alkuperäksi.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa perustyylisivujen määrittämiseen julkiseksi alkuperäksi.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-SPOTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: Sivuston resurssien, sivustosivujen ja kuvien julkaisemisen yksityisen alkuperän määrittäminen SharePoint Onlinessa

  • Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa sivuston assets-kansion määrittämiseen yksityiseksi alkuperäksi.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa sivuston sivujen kansion määrittämiseen yksityiseksi alkuperäksi.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa julkaisukuvakansion määrittämiseen yksityiseksi alkuperäksi.

    Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-SPOTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: SharePoint Onlinen sivustokokoelman yksityisen alkuperän määrittäminen

Käytä Add-SPOTenantCdnOrigin cmdlet-komentoa sivustokokoelman määrittämiseen yksityiseksi alkuperäksi. Esimerkiksi:

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

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-SPOTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Saatat saada määritystä odottavan sanoman, joka on odotettavissa, kun SharePoint Online -vuokraaja muodostaa yhteyden CDN-palveluun. Tämä voi kestää jopa 15 minuuttia.

Office 365 CDN:n hallinta

Kun olet määrittänyt CDN:n, voit tehdä muutoksia määrityksiin, kun päivität sisältöä tai kun tarpeesi muuttuvat tässä osiossa kuvatulla tavalla.

Resurssien lisääminen, päivittäminen tai poistaminen Office 365 CDN:stä

Kun olet suorittanut määritysvaiheet, voit lisätä uusia resursseja ja päivittää tai poistaa olemassa olevia resursseja milloin tahansa. Tee haluamasi muutokset kansion tai SharePoint-kirjaston resursseiksi, jotka olet tunnistanut alkuperäksi. Jos lisäät uuden resurssin, se on heti käytettävissä CDN:n kautta. Jos kuitenkin päivität resurssin, uuden kopion levittyminen ja tuleminen saataville CDN:ssä kestää jopa 15 minuuttia.

Jos sinun on noudettava alkuperän sijainti, voit käyttää Get-SPOTenantCdnOrigins cmdlet-komentoa . Lisätietoja tämän cmdlet-komennon käyttämisestä on kohdassa Get-SPOTenantCdnOrigins.

Poista alkuperä CDN Office 365 komennon perusteella

Voit poistaa käyttöoikeuden kansioon tai SharePoint-kirjastoon, jonka tunnistit alkuperäksi. Voit tehdä tämän käyttämällä Remove-SPOTenantCdnOrigin cmdlet-komentoa .

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

Lisätietoja tämän cmdlet-komennon käyttämisestä on kohdassa Remove-SPOTenantCdnOrigin.

Alkuperän muokkaaminen cdn Office 365 komennon avulla

Et voi muokata luomaasi alkuperää. Poista sen sijaan alkuperä ja lisää sitten uusi. Lisätietoja on ohjeaiheessa Alkuperän poistaminen Office 365 CDN:stä ja Alkuperän lisääminen resursseille.

Office 365 CDN:n poistaminen käytöstä

Käytä Set-SPOTenantCdnEnabled cmdlet-komentoa CDN:n poistamiseen käytöstä organisaatiossasi. Jos sekä julkinen että yksityinen alkuperä on otettu käyttöön CDN:lle, cmdlet-komento on suoritettava kahdesti seuraavissa esimerkeissä esitetyllä tavalla.

Jos haluat poistaa käytöstä julkisen alkuperän käytön CDN:ssä, anna seuraava komento:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Voit poistaa käytöstä yksityiset alkuperät CDN:ssä antamalla seuraavan komennon:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Lisätietoja tästä cmdlet-komennosta on kohdassa Set-SPOTenantCdnEnabled.

CDN:n Office 365 määrittäminen ja määrittäminen PnP PowerShellin avulla

Tämän osion toimintosarjoissa edellytetään, että muodostat yhteyden SharePoint Onlineen PnP PowerShellin avulla. Katso ohjeet kohdasta PnP PowerShellin käytön aloittaminen.

Suorita nämä vaiheet määrittääksesi CDN:n isännöimään resurssejasi SharePoint Onlinessa PnP PowerShellin avulla.

Laajenna napsauttamalla

Salli organisaatiosi käyttää Office 365 CDN:tä

Ennen kuin teet muutoksia vuokraajan CDN-asetuksiin, sinun on noudettava yksityisen CDN-määrityksen nykyinen tila Office 365 vuokraajassa. Muodosta yhteys vuokraajaan PnP PowerShellin avulla:

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

Hae nyt CDN-tila-asetukset vuokraajasta Get-PnPTenantCdnEnabled cmdlet-komennolla:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Määritetyn CdnType-arvon CDN-tila tulostuu näyttöön.

Käytä Set-PnPTenantCdnEnabled cmdlet-komentoa, jotta organisaatiosi voi käyttää Office 365 CDN:tä. Voit antaa organisaatiollesi mahdollisuuden käyttää julkista alkuperää, yksityistä alkuperää tai molempia samanaikaisesti. Voit myös määrittää CDN:n ohittamaan oletusaloitusten määritykset, kun otat sen käyttöön. Voit aina lisätä nämä alkuperät myöhemmin tässä ohjeaiheessa kuvatulla tavalla.

PnP PowerShellissä:

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

Jos haluat esimerkiksi, että organisaatiosi voi käyttää sekä julkista että yksityistä alkuperää, kirjoita seuraava komento:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Jos haluat, että organisaatiosi voi käyttää sekä julkisia että yksityisiä alkuperätietoja, mutta ohittaa oletusalkuperän määrittämisen, kirjoita seuraava komento:

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

Katso cdn-oletusalkuperästä lisätietoja alkuperästä, joka valmistellaan oletusarvoisesti, kun Office 365 CDN otetaan käyttöön, sekä oletusalkuperän määrityksen ohittamisen mahdollisista vaikutuksista.

Jos haluat, että organisaatiosi voi käyttää julkista alkuperää, kirjoita seuraava komento:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Jos haluat, että organisaatiosi voi käyttää yksityisiä alkuperätietoja, kirjoita seuraava komento:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Lisätietoja tästä cmdlet-komennosta on kohdassa Set-PnPTenantCdnEnabled.

Muuta Office 365 CDN:hen sisällytettävien tiedostotyyppien luettelo (valinnainen)

Vihje

Kun määrität tiedostotyyppejä Set-PnPTenantCdnPolicy cmdlet-komennolla , korvaat tällä hetkellä määritetyn luettelon. Jos haluat lisätä luetteloon lisää tiedostotyyppejä, selvitä ensin cmdlet-komennolla, mitkä tiedostotyypit ovat jo sallittuja, ja sisällytä ne luetteloon uusien tiedostotyyppien ohella.

Määritä Set-PnPTenantCdnPolicy cmdlet-komennolla staattiset tiedostotyypit, joita voidaan isännöidä cdn:n julkisen ja yksityisen alkuperän mukaan. Oletusarvoisesti sallitaan yleiset resurssityypit, kuten .css, .gif, .jpg ja .js.

PnP PowerShellissä:

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

Jos haluat esimerkiksi, että CDN isännöi .css- ja .png-tiedostoja, anna komento:

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

Jos haluat nähdä, mitä tiedostotyyppejä CDN tällä hetkellä sallii, käytä Get-PnPTenantCdnPolicies cmdlet-komentoa :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Lisätietoja näistä cmdlet-komennoista on kohdassa Set-PnPTenantCdnPolicy ja Get-PnPTenantCdnPolicies.

Muuta niiden sivustoluokittelujen luetteloa, jotka haluat jättää pois Office 365 CDN:stä (valinnainen)

Vihje

Kun jätät sivustoluokittelut pois set-PnPTenantCdnPolicy cmdlet-komennolla , korvaat tällä hetkellä määritetyn luettelon. Jos haluat jättää pois muita sivustoluokitteluja, käytä ensin cmdlet-komentoa selvittääksesi, mitkä luokitukset on jo jätetty pois, ja lisätä ne sitten uusien luokitusten ohella.

Käytä Set-PnPTenantCdnPolicy cmdlet-komentoa, jos haluat jättää pois sivustoluokitukset, joita et halua käyttää CDN:ssä. Sivustoluokitteluja ei oletusarvoisesti suljeta pois.

PnP PowerShellissä:

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

Jos haluat nähdä, mitä sivustoluokituksia on rajoitettu tällä hetkellä, käytä Get-PnPTenantCdnPolicies cmdlet-komentoa :

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Palautettavat ominaisuudet ovat IncludeFileExtensions, ExcludeRestrictedSiteClassifications ja ExcludeIfNoScriptDisabled.

IncludeFileExtensions-ominaisuus sisältää luettelon tiedostotunnisteista, jotka tarjotaan CDN:ltä.

Huomautus

Oletusarvoiset tiedostotunnisteet eroavat julkisen ja yksityisen tiedostotunnisteen välillä.

ExcludeRestrictedSiteClassifications-ominaisuus sisältää sivuston luokitukset, jotka haluat jättää pois CDN:stä. Voit esimerkiksi jättää pois Sivustot, jotka on merkitty luottamuksellisiksi , joten sisältöä sivustoista, joiden luokitusta käytetään, ei toimiteta CDN:stä.

ExcludeIfNoScriptDisabled-ominaisuus jättää pois SISÄLTÖÄ CDN:stä sivustotason NoScript-määriteasetusten perusteella. Oletuksena NoScript-määritteen arvoksi on määritetty Käytössämoderneille sivustoille ja Poistettu käytöstäperinteisissä sivustoissa. Tämä riippuu vuokraaja-asetuksistasi.

Lisätietoja näistä cmdlet-komennoista on kohdassa Set-PnPTenantCdnPolicy ja Get-PnPTenantCdnPolicies.

Lisää alkuperä resursseillesi

Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa alkuperän määrittämiseen. Voit määrittää useita origoja. Alkuperä on URL-osoite, joka osoittaa SharePoint-kirjastoon tai -kansioon, joka sisältää resurssit, joita haluat käyttää CDN:n isännöimänä.

Tärkeää

Älä koskaan sijoita resursseja, jotka sisältävät käyttäjätietoja tai joita pidetään luottamuksellisina organisaatiollesi julkisessa alkuperässä.

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

Polun arvo on sen kirjaston tai kansion suhteellinen polku, joka sisältää resurssit. Voit käyttää yleismerkkejä suhteellisten polkujen lisäksi. Alkuperät tukevat URL-osoitteeseen liitettyjä yleismerkkejä. Näin voit luoda origoja, jotka ulottuvat useille sivustoille. Jos esimerkiksi haluat sisällyttää kaikkien sivustojesi kaikki resurssit perustyylisivujen kansioon julkisena alkuperänä CDN:ssä, kirjoita seuraava komento:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Yleismerkkimuunninta */ voi käyttää vain polun alussa, ja se vastaa kaikkia määritetyn URL-osoitteen URL-segmenttejä.
  • Polku voi osoittaa tiedostokirjastoon, kansioon tai sivustoon. Esimerkiksi polku */sivusto1 vastaa kaikkia sivuston tiedostokirjastoja.

Voit lisätä origon tietyllä suhteellisella polulla. Origoa ei voi lisätä käyttämällä täyttä polkua.

Tämä esimerkki lisää sivuston resurssikirjaston yksityisen alkuperän tiettyyn sivustoon:

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

Tässä esimerkissä lisätään sivustokokoelman sivustoresurssikirjaston folder1-kansion yksityinen alkuperä:

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

Jos polussa on välilyönti, voit joko ympäröidä polun lainausmerkeissä tai korvata välilyönnin URL-koodauksella %20. Seuraavissa esimerkeissä lisätään sivustokokoelman sivustoresurssikirjaston kansion 1 kansion yksityinen alkuperä:

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

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

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-PnPTenantCdnOrigin.

Huomautus

Yksityisissä lähteissä alkuperästä jaettavien resurssien pääversion on oltava julkaistu, ennen kuin niitä voidaan käyttää CDN:stä.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: Määritä julkinen alkuperä perustyylisivuille ja SharePoint Onlinen tyylikirjastolle

Yleensä nämä alkuperät määritetään oletusarvoisesti, kun otat Office 365 CDN:n käyttöön. Jos kuitenkin haluat ottaa ne käyttöön manuaalisesti, toimi seuraavasti.

  • Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa, kun haluat määrittää tyylikirjaston julkiseksi alkuperäksi.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library

  • Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa perustyylisivujen määrittämiseen julkiseksi alkuperäksi.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-PnPTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: Sivuston resurssien, sivustosivujen ja kuvien julkaisemisen yksityisen alkuperän määrittäminen SharePoint Onlinessa

  • Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa sivuston assets-kansion määrittämiseen yksityiseksi alkuperäksi.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets

  • Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa sivuston sivujen kansion määrittämiseen yksityiseksi alkuperäksi.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages

  • Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa julkaisukuvakansion määrittämiseen yksityiseksi alkuperäksi.

    Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-PnPTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Tämä voi kestää jopa 15 minuuttia.

Esimerkki: SharePoint Onlinen sivustokokoelman yksityisen alkuperän määrittäminen

Käytä Add-PnPTenantCdnOrigin cmdlet-komentoa sivustokokoelman määrittämiseen yksityiseksi alkuperäksi. Esimerkiksi:

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

Lisätietoja tästä komennosta ja sen syntaksista on kohdassa Add-PnPTenantCdnOrigin.

Kun komento on tehty, järjestelmä synkronoi määritykset palvelinkeskuksessa. Saatat saada määritystä odottavan sanoman, joka on odotettavissa, kun SharePoint Online -vuokraaja muodostaa yhteyden CDN-palveluun. Tämä voi kestää jopa 15 minuuttia.

Office 365 CDN:n hallinta

Kun olet määrittänyt CDN:n, voit tehdä muutoksia määrityksiin, kun päivität sisältöä tai kun tarpeesi muuttuvat tässä osiossa kuvatulla tavalla.

Resurssien lisääminen, päivittäminen tai poistaminen Office 365 CDN:stä

Kun olet suorittanut määritysvaiheet, voit lisätä uusia resursseja ja päivittää tai poistaa olemassa olevia resursseja milloin tahansa. Tee haluamasi muutokset kansion tai SharePoint-kirjaston resursseiksi, jotka olet tunnistanut alkuperäksi. Jos lisäät uuden resurssin, se on heti käytettävissä CDN:n kautta. Jos kuitenkin päivität resurssin, uuden kopion levittyminen ja tuleminen saataville CDN:ssä kestää jopa 15 minuuttia.

Jos sinun on noudettava alkuperän sijainti, voit käyttää Get-PnPTenantCdnOrigin cmdlet-komentoa . Lisätietoja tämän cmdlet-komennon käyttämisestä on kohdassa Get-PnPTenantCdnOrigin.

Poista alkuperä CDN Office 365 komennon perusteella

Voit poistaa käyttöoikeuden kansioon tai SharePoint-kirjastoon, jonka tunnistit alkuperäksi. Voit tehdä tämän käyttämällä Remove-PnPTenantCdnOrigin cmdlet-komentoa .

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

Lisätietoja tämän cmdlet-komennon käyttämisestä on kohdassa Remove-PnPTenantCdnOrigin.

Alkuperän muokkaaminen cdn Office 365 komennon avulla

Et voi muokata luomaasi alkuperää. Poista sen sijaan alkuperä ja lisää sitten uusi. Lisätietoja on ohjeaiheessa Alkuperän poistaminen Office 365 CDN:stä ja Alkuperän lisääminen resursseille.

Office 365 CDN:n poistaminen käytöstä

Käytä Set-PnPTenantCdnEnabled cmdlet-komentoa CDN:n poistamiseen käytöstä organisaatiossasi. Jos sekä julkinen että yksityinen alkuperä on otettu käyttöön CDN:lle, cmdlet-komento on suoritettava kahdesti seuraavissa esimerkeissä esitetyllä tavalla.

Jos haluat poistaa käytöstä julkisen alkuperän käytön CDN:ssä, anna seuraava komento:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Voit poistaa käytöstä yksityiset alkuperät CDN:ssä antamalla seuraavan komennon:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Lisätietoja tästä cmdlet-komennosta on kohdassa Set-PnPTenantCdnEnabled.

Office 365 CDN:n määrittäminen ja määrittäminen Microsoft 365:n komentorivikäyttöliittymän avulla

Tämän osion toimintatavat edellyttävät, että olet asentanut Microsoft 365:n komentorivikäyttöliittymän. Muodosta seuraavaksi yhteys Office 365 vuokraajaan kirjautumiskomennon avulla.

Suorita nämä vaiheet, jotta voit määrittää CDN:n isännöimään resurssejasi SharePoint Onlinessa Microsoft 365:n komentorivikäyttöliittymän avulla.

Laajenna napsauttamalla

Ota Office 365 CDN käyttöön

Voit hallita Office 365 CDN:n tilaa vuokraajassa spo cdn set -komennolla.

Jos haluat ottaa julkisen Office 365 CDN:n käyttöön vuokraajassasi, suorita seuraava komento:

m365 spo cdn set --type Public --enabled true

Voit ottaa SharePoint-Office 365 CDN:n käyttöön suorittamalla seuraavat:

m365 spo cdn set --type Private --enabled true

Näytä Office 365 CDN:n nykyinen tila

Jos haluat tarkistaa, onko tietyntyyppinen Office 365 CDN käytössä vai poistettu käytöstä, käytä spo cdn get -komentoa.

Jos haluat tarkistaa, onko julkinen Office 365 CDN käytössä, suorita:

m365 spo cdn get --type Public

Office 365 CDN-alkuperän tarkasteleminen

Voit tarkastella julkisten CDN-alkuperätietojen tällä hetkellä määritettyjä Office 365 suorittamalla:

m365 spo cdn origin list --type Public

Lisätietoja alkuperästä, joka valmistellaan oletusarvoisesti, kun Office 365 CDN otetaan käyttöön, on kohdassa CdN:n oletusaloitus.

Lisää Office 365 CDN-alkuperä

Tärkeää

Resursseja, joita pidetään luottamuksellisina organisaatiollesi, ei pidä sijoittaa SharePoint-tiedostokirjastoon, joka on määritetty julkiseksi alkuperäksi.

Määritä CDN-alkuperä käyttämällä spo cdn origin add -komentoa. Voit määrittää useita origoja. Alkuperä on URL-osoite, joka osoittaa SharePoint-kirjastoon tai -kansioon, joka sisältää resurssit, joita haluat käyttää CDN:n isännöimänä.

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

Jossa path on suhteellinen polku kansioon, joka sisältää resurssit. Voit käyttää yleismerkkejä suhteellisten polkujen lisäksi.

Jos haluat sisällyttää kaikkien sivustojen perustyylisivujen valikoimaan kaikki resurssit julkisena alkuperänä, suorita:

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

Jos haluat määrittää tietyn sivustokokoelman yksityisen alkuperän, suorita:

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

Huomautus

CdN-alkuperän lisäämisen jälkeen saattaa kestää jopa 15 minuuttia, ennen kuin voit noutaa tiedostoja CDN-palvelun kautta. Voit tarkistaa, onko tietty alkuperä jo otettu käyttöön spo cdn origin -luettelokomennon avulla.

Office 365 CDN-alkuperän poistaminen

Poista CDN-alkuperä määritetylle CDN-tyypille käyttämällä spo cdn origin remove -komentoa.

Jos haluat poistaa julkisen alkuperän CDN-määrityksestä, suorita:

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

Huomautus

CDN-alkuperän poistaminen ei vaikuta mihinkään kyseistä alkuperää vastaavaan tiedostokirjastoon tallennettuihin tiedostoihin. Jos näihin resurssihin on viitattu niiden SharePoint-URL-osoitteella, SharePoint vaihtaa automaattisesti takaisin alkuperäiseen tiedostokirjastoon viittaamaan URL-osoitteeseen. Jos resurssteihin on kuitenkin viitattu julkisen CDN-URL-osoitteen avulla, alkuperän poistaminen katkaisee linkin, ja sinun on muutettava niitä manuaalisesti.

CdN Office 365 alkuperän muokkaaminen

Olemassa olevaa CDN-alkuperää ei voi muokata. Poista sen sijaan aiemmin määritetty CDN-alkuperä komennolla spo cdn origin remove ja lisää uusi komennolla spo cdn origin add .

Muuta Office 365 CDN:hen sisällytettävien tiedostojen tyyppejä

CDN sisältää oletusarvoisesti seuraavat tiedostotyypit: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff ja .woff2. Jos haluat sisällyttää CDN:hen lisää tiedostotyyppejä, voit muuttaa CDN-määritystä käyttämällä spo cdn -käytäntöjoukkokomentoa .

Huomautus

Kun muutat tiedostotyyppien luetteloa, korvaat tällä hetkellä määritetyn luettelon. Jos haluat sisällyttää muita tiedostotyyppejä, käytä ensin spo cdn -käytäntöluettelokomentoa selvittääksesi, mitkä tiedostotyypit on määritetty tällä hetkellä.

Jos haluat lisätä JSON-tiedostotyypin julkisen sisältöverkkoon sisältyvien tiedostotyyppien oletusluetteloon, suorita:

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

Muuta sivustoluokitteluluetteloa, jonka haluat jättää pois Office 365 CDN:stä

Spo cdn -käytäntöjoukkokomennon avulla voit sulkea pois sivustoluokittelut, joita et halua käyttää CDN:n kautta. Sivustoluokitteluja ei oletusarvoisesti suljeta pois.

Huomautus

Muuttaessasi pois jätettyjen sivustoluokittelujen luetteloa korvaat tällä hetkellä määritetyn luettelon. Jos haluat jättää pois muita luokituksia, käytä ensin spo cdn -käytäntöluettelokomentoa selvittääksesi, mitkä luokitukset on määritetty tällä hetkellä.

Jos haluat jättää HBI-luokitukseksi luokitellut sivustot pois julkisesta CDN:stä, suorita

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

Office 365 CDN:n poistaminen käytöstä

Jos haluat poistaa Office 365 CDN:n käytöstä, käytä komentoaspo cdn set, esimerkiksi:

m365 spo cdn set --type Public --enabled false

CDN-resurssien käyttäminen

Nyt kun olet ottanut CDN:n käyttöön ja määrittänyt alkuperän ja käytännöt, voit aloittaa CDN-resurssien käytön.

Tässä osassa kerrotaan, miten voit käyttää CDN-URL-osoitteita SharePoint-sivuillasi ja sisällössäsi niin, että SharePoint ohjaa sekä julkisessa että yksityisessä lähteessä olevien resurssien pyynnöt CDN:hen.

Lisätietoja CDN:n käyttämisestä asiakaspuolen verkko-osien isännöinnissä on ohjeaiheessa Asiakaspuolen verkko-osan isännöinti Office 365 CDN:stä (Hei maailma osa 4)..

Huomautus

Jos lisäät ClientSideAssets-kansionyksityiseen CDN-alkuperäluetteloon, CDN:n isännöimien mukautettujen VERKKO-osien hahmontaminen epäonnistuu. SPFX-VERKKO-osien käyttämissä tiedostoissa voi käyttää vain julkista CDN:ää, ja ClientSideAssets-kansio on julkisen CDN:n oletusaloitus.

Jos haluat käyttää resursseja, jotka olet lisännyt alkuperään, päivitä vain linkit alkuperäiseen tiedostoon, joka sisältää polun tiedostoon alkuperästä.

  • Muokkaa sivua tai sisältöä, joka sisältää linkkejä resursseista, jotka olet lisännyt alkuperään. Voit myös käyttää yhtä useista menetelmistä hakeaksesi ja korvataksesi linkkejä enter-sivustossa tai sivustokokoelmassa, jos haluat päivittää linkin tiettyyn resurssiin kaikkialla, missä se näkyy.
  • Korvaa jokaista alkuperässä olevan resurssin linkkiä kohden polku polulla tiedostoon CDN-alkuperässä. Voit käyttää suhteellisia polkuja.
  • Tallenna sivu tai sisältö.

Otetaan esimerkiksi kuva /sivusto/SiteAssets/images/image.png, jonka olet kopioinut tiedostokirjaston kansioon /sivusto/CDN_origins/public/. Jos haluat käyttää CDN-resurssia, korvaa kuvatiedoston sijainnin alkuperäinen polku alkuperän polulla, jotta uusi URL-osoite /sivusto/CDN_origins/julkinen/image.png.

Jos haluat käyttää resurssin täydellistä URL-osoitetta suhteellisen polun sijaan, muodosta linkki seuraavasti:

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

Huomautus

Yleensä URL-osoitteita ei pidä koodata suoraan CDN-resursseista. Voit kuitenkin tarvittaessa luoda manuaalisesti URL-osoitteita julkisen alkuperän resursseille. Lisätietoja on artikkelissa Julkisten resurssien CDN-URL-osoitteiden kiinteä koodaus.

Jos haluat lisätietoja siitä, miten voit varmistaa, että resurssit tarjotaan CDN:ltä, katso Ohjevalikko vahvista, että CDN palvelee resursseja?Office 365 CDN:n vianmäärityksessä.

Omaisuuden käyttö julkisissa lähteissä

SharePoint Onlinen julkaisuominaisuus kirjoittaa automaattisesti julkiseen alkuperään tallennettujen resurssien URL-osoitteet CDN-vastaavuksi niin, että resurssit tarjotaan CDN-palvelusta SharePointin sijaan.

Jos alkuperäsi sijaitsee sivustossa, jossa on käytössä julkaisuominaisuus ja resurssit, jotka haluat ladata CDN:hen, kuuluvat johonkin seuraavista luokista, SharePoint kirjoittaa automaattisesti uudelleen alkuperässä olevien resurssien URL-osoitteet, jos CDN-käytäntö ei ole sulkenut resurssia pois.

Seuraavassa on yleiskatsaus siitä, mitkä linkit SharePoint-julkaisuominaisuus kirjoittaa automaattisesti uudelleen:

  • IMG/LINK/CSS-URL-osoitteet klassisen julkaisusivun HTML-vastauksissa
    • Tämä sisältää kuvat, jotka tekijät ovat lisänneet sivun HTML-sisältöön
  • Kuvakirjaston diaesityksen WWW-osan kuvien URL-osoitteet
  • KUVAkentät SPList REST -ohjelmointirajapinnan (RenderListDataAsStream) tuloksissa
    • Käytä uutta ominaisuutta ImageFieldsToTryRewriteToCdnUrls ja anna pilkuin eroteltu kenttäluettelo
    • Tukee hyperlinkkikenttiä ja PublishingImage-kenttiä
  • SharePoint-kuvakäännökset

Seuraava kaavio havainnollistaa työnkulkua, kun SharePoint vastaanottaa pyynnön sivusta, joka sisältää julkisen alkuperän resursseja.

Työnkulkukaavio: noudetaan Office 365 CDN-resursseja julkisesta alkuperästä.

Vihje

Jos haluat poistaa automaattisen uudelleenkirjoituksen käytöstä tietyille sivun URL-osoitteille, voit kuitata sivun ulos ja lisätä kyselymerkkijonoparametrin ? NoAutoReWrites=true jokaisen linkin loppuun asti, jonka haluat poistaa käytöstä.

Julkisten resurssien CDN-URL-osoitteiden muodostaminen

Jos julkaisuominaisuus ei ole käytössä julkisessa alkuperässä tai resurssi ei ole cdn-palvelun automaattisen uudelleenkirjoitusominaisuuden tukema linkkityyppi, voit luoda URL-osoitteet manuaalisesti resurssien CDN-sijaintiin ja käyttää näitä URL-osoitteita sisällössäsi.

Huomautus

ET voi kiinteästi koodata tai muodostaa CDN-URL-osoitteita yksityisessä alkuperässä olevalle resurssille, koska URL-osoitteen viimeisen osan muodostava pakollinen käyttöoikeustietue luodaan resurssin pyyntöhetkellä. Voit muodostaa julkisen CDN:n URL-osoitteen, eikä URL-osoitetta tulisi koodata kiinteästi, koska se saattaa muuttua.

Julkisten CDN-resurssien URL-muoto näyttää seuraavalta:

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

Korvaa TenantHostName vuokraajan nimelläsi. Esimerkki:

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

Huomautus

Sivukontekstiominaisuutta tulee käyttää etuliitteen muodostamiseen kovan koodauksen sijaan "https://publiccdn.sharepointonline.com". URL-osoite voi muuttua, eikä sitä tulisi koodata kiinteästi. Jos käytät näyttömalleja perinteisen SharePoint Onlinen kanssa, voit käyttää näyttömallissa ominaisuutta window._spPageContextInfo.publicCdnBaseUrl URL-osoitteen etuliitteenä. Jos olet modernin ja perinteisen SharePointin SPFx-www-osia, voit käyttää ominaisuutta this.context.pageContext.legacyPageContext.publicCdnBaseUrl. Tämä antaa etuliitteen niin, että jos sitä muutetaan, toteutus päivittyy sen mukana. Esimerkiksi SPFx:n URL-osoite voidaan muodostaa käyttämällä ominaisuutta this.context.pageContext.legacyPageContext.publicCdnBaseUrl + "/" + "host" + "/" + "relativeURL kohteelle". Katso CDN:n käyttäminen asiakaspuolen koodissa , joka on osa kauden 1 suoritussarjaa

Omaisuuden käyttäminen yksityisissä lähteissä

Resurssien käyttämiseen yksityisissä lähteissä ei tarvita lisämäärityksiä. SharePoint Online kirjoittaa automaattisesti uudelleen yksityisperäisten resurssien URL-osoitteet, joten näitä resursseja koskevat pyynnöt lähetetään aina CDN:ltä. URL-osoitteita ei voi luoda manuaalisesti CDN-resursseihin yksityisesti, koska nämä URL-osoitteet sisältävät tunnuksia, jotka SharePoint Onlinen on luotava automaattisesti resurssia pyydettäessä.

Yksityisissä alkuperässä olevien resurssien käyttöoikeus on suojattu dynaamisesti luoduilla tunnuksilla, jotka perustuvat alkuperän käyttöoikeuksiin, seuraavissa osioissa kuvatuilla huomautuksella. Käyttäjillä on oltava sisällön hahmontamista varten vähintään lukuoikeudet CDN:n alkuperään.

Seuraava kaavio havainnollistaa työnkulkua, kun SharePoint vastaanottaa pyynnön sivusta, joka sisältää yksityisestä alkuperästä peräisin olevia resursseja.

Työnkulkukaavio: noudetaan Office 365 CDN-resursseja yksityisestä alkuperästä.

Tunnuspohjainen valtuutus yksityisissä lähteissä

Office 365 CDN:n yksityisomistuksessa olevien resurssien käyttöoikeus myönnetään SharePoint Onlinen luomien tunnuksien avulla. Käyttäjille, joilla on jo oikeus käyttää alkuperän määrittämää kansiota tai kirjastoa, myönnetään automaattisesti tunnukset, joiden avulla käyttäjä voi käyttää tiedostoa käyttöoikeustasonsa perusteella. Nämä käyttöoikeustietueet ovat voimassa 30–90 minuuttia niiden luomisen jälkeen, jotta tunnusten toistamisen hyökkäykset voidaan estää.

Kun käyttöoikeustietue on luotu, SharePoint Online palauttaa asiakkaalle mukautetun URI-tunnuksen, joka sisältää kaksi syömää valtuutusparametria (edge-valtuutustunnus) ja kaura (alkuperän valtuutustunnus). Kunkin tunnuksen rakenne on <"Vanhentumisaika Epoch-aikamuodossa">__<'suojattu allekirjoitus">. Esimerkiksi:

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

Huomautus

Kuka tahansa, jolla on tunnus, voi käyttää resurssia CDN:ssä. Nämä käyttöoikeustietueet sisältävät URL-osoitteet jaetaan kuitenkin vain HTTPS:n kautta, joten ellei loppukäyttäjä nimenomaisesti jaa URL-osoitetta ennen tunnuksen vanhenemista, valtuuttamattomat käyttäjät eivät voi käyttää resurssia.

Kohdetason käyttöoikeuksia ei tueta yksityisistä alkuperästä peräisin oleville resursseille

On tärkeää huomata, että SharePoint Online ei tue kohdetason käyttöoikeuksia yksityisistä alkuperästä peräisin olevissa resursseissa. Esimerkiksi tiedosto, jonka sijainti on , https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpgkäyttäjät voivat käyttää tiedostoa seuraavien ehtojen mukaisesti:

Käyttäjä Käyttöoikeudet Voimassa oleva käyttöoikeus
Käyttäjä 1 Voi käyttää kansiota 1 Voi käyttää image1.jpg CDN:stä
Käyttäjä 2 Ei voi käyttää kansiota 1 image1.jpg cdn-levyltä ei voi käyttää
Käyttäjä 3 Kansio1:n käyttöoikeutta ei ole, mutta hänelle on myönnetty eksplisiittinen oikeus käyttää image1.jpg SharePoint Onlinessa Voi käyttää resurssia image1.jpg suoraan SharePoint Onlinesta, mutta ei CDN:stä
Käyttäjä 4 Saa kansion 1 käyttöoikeuden, mutta häneltä on eksplisiittisesti estetty image1.jpg SharePoint Onlinessa Resurssia ei voi käyttää SharePoint Onlinesta, mutta se voi käyttää resurssia CDN:stä huolimatta siitä, että sen käyttö SharePoint Onlinessa on estetty

OFFICE 365 CDN:n vianmääritys

Ohjevalikko vahvistaa, että CDN palvelee varoja?

Kun olet lisännyt sivuun linkkejä CDN-resursseista, voit vahvistaa, että resurssi tarjotaan CDN:stä, selaamalla sivulle napsauttamalla kuvaa hiiren kakkospainikkeella, kun se on hahmonnettu, ja tarkistamalla kuvan URL-osoitteen.

Voit myös käyttää selaimen kehittäjätyökaluja sivun kunkin resurssin URL-osoitteen tarkastelemiseen tai kolmannen osapuolen verkon jäljitystyökalun avulla.

Huomautus

Jos käytät Fiddler-verkkotyökalua resurssien testaamiseen sharepoint-sivulta hahmonnetun resurssin ulkopuolella, sinun on lisättävä viittaajaotsikko "Viite: https://yourdomain.sharepoint.com" manuaalisesti GET-pyyntöön, jossa URL-osoite on SharePoint Online -vuokraajan URL-pääosoite.

ET voi testata CDN:n URL-osoitteita suoraan selaimessa, koska sinulla on oltava SharePoint Onlinesta tuleva viittaaja. Jos kuitenkin lisäät CDN-resurssin URL-osoitteen SharePoint-sivulle ja avaat sivun selaimessa, näet CDN-resurssin hahmonnettuna sivulla.

Lisätietoja kehittäjätyökalujen käyttämisestä Microsoft Edge -selaimessa on kohdassa Microsoft Edgen kehittäjätyökalut.

Jos haluat katsoa lyhyen videon, jota isännöidaan SharePoint Developer Patterns and Practices -YouTube-kanavalla ja jossa kerrotaan, miten voit varmistaa CDN:n toiminnan, katso cdn-yhteyden käytön tarkistaminen ja optimaalisen verkkoyhteyden varmistaminen.

Miksi uudesta alkuperästä peräisin olevat resurssit eivät ole käytettävissä?

Uudet resurssit eivät ole heti käytettävissä, koska rekisteröinnillä kestää kauan, ennen kuin rekisteröinti välitetään CDN:n kautta ja että resurssit ladataan alkuperästä CDN-tallennustilaan. Resurssien CDN:ssä käytettävissä oleva aika määräytyy resurssien ja tiedostojen koon mukaan.

Oma asiakaspuolen verkko-osa tai SharePoint Framework ratkaisu ei toimi

Kun otat Office 365 CDN:n käyttöön julkisessa alkuperässä, CDN-palvelu luo automaattisesti seuraavat oletusalkuperät:

  • */PERUSTYYLISIVU
  • */TYYLIKIRJASTO
  • */ASIAKKAATIDEASSETS

Jos */clientsideassets-alkuperä puuttuu, SharePoint Framework ratkaisut epäonnistuvat, eikä varoitus- tai virhesanomia luoda. Tämä alkuperä saattaa puuttua, joko koska CDN on otettu käyttöön ja -NoDefaultOrigins-parametrin arvoksi on määritetty $true tai alkuperä on poistettu manuaalisesti.

Voit tarkistaa, mitkä alkuperät ovat olemassa seuraavan PowerShell-komennon avulla:

Get-SPOTenantCdnOrigins -CdnType Public

Voit myös tarkistaa Microsoft 365:n komentorivikäyttöliittymästä:

m365 spo cdn origin list

Origon lisääminen PowerShellissä:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Origon lisääminen Microsoft 365:n komentorivikäyttöliittymän avulla:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

Mitä PowerShell-moduuleja ja komentorivikäyttöliittymän hylsyjä tarvitsen Office 365 CDN:n kanssa?

Voit käyttää Office 365 CDN:ää joko SharePoint Online Management Shell PowerShell -moduulin tai Microsoft 365:n komentorivikäyttöliittymän avulla.

Tutustu myös seuraaviin ohjeartikkeleihin:

Sisällön toimitusverkostot

Network planning and performance tuning for Office 365

SharePoint Performance Series – Office 365 CDN -videosarja