Condividi tramite

Usare la rete per la distribuzione di contenuti di Office 365 con SharePoint Online

  • Articolo

È possibile usare la rete per la distribuzione di contenuti di Office 365 predefinita per ospitare risorse statiche e migliorare le prestazioni delle pagine di SharePoint Online. La rete per la distribuzione di contenuti di Office 365 consente di migliorare le prestazioni in quanto le risorse statiche vengono memorizzate nella cache più vicina ai browser che le richiedono. Questo consente di velocizzare i download e ridurre la latenza. Inoltre, la rete CDN Office 365 usa il protocollo HTTP/2 per migliorare la compressione e il pipelining HTTP. Il servizio della rete per la distribuzione di contenuti di Office 365 è incluso nell'abbonamento a SharePoint Online.

Nota

La rete CDN Office 365 è disponibile solo per i tenant nel cloud di produzione (in tutto il mondo). I tenant nei cloud del governo degli Stati Uniti e della Cina attualmente non supportano la rete CDN Office 365.

La rete per la distribuzione di contenuti di Office 365 è costituita da diverse reti per la distribuzione di contenuti che consentono di ospitare le risorse statiche in più località o origini e gestirle da reti globali ad alta velocità. A seconda del tipo di contenuto che si vuole ospitare nella rete CDN Office 365, ad esempio è possibile aggiungere origini pubbliche.

Se si ha già familiarità con il funzionamento delle reti CDN, è sufficiente completare alcuni passaggi per abilitare la rete CDN Office 365 per il tenant. In questo articolo viene descritto come. Per informazioni su come iniziare a ospitare gli asset statici, leggere questa pagina.

Consiglio

Esistono altre reti CDN ospitate da Microsoft che possono essere usate con Office 365 per scenari di utilizzo specializzati, ma non sono descritte in questo articolo perché esulano dall'ambito della rete CDN Office 365. Per altre informazioni, vedere Altre reti CDN Microsoft.

Tornare alla pianificazione della rete e all'ottimizzazione delle prestazioni per Office 365.

Panoramica dell'uso della rete CDN Office 365 in SharePoint Online

Per configurare la rete CDN Office 365 per l'organizzazione, seguire questa procedura di base:

Al termine dell'installazione, è possibile gestire la rete CDN Office 365 nel tempo:

  • Aggiunta, aggiornamento e rimozione di asset
  • Aggiunta e rimozione di origini
  • Configurazione dei criteri della rete CDN
  • Se necessario, disabilitare la rete CDN

Infine, vedere Uso degli asset della rete CDN per informazioni sull'accesso agli asset della rete CDN da origini pubbliche e private.

Per indicazioni sulla risoluzione dei problemi comuni, vedere Risoluzione dei problemi della rete CDN Office 365.

Pianificare la distribuzione della rete CDN Office 365

Prima di distribuire la rete CDN Office 365 per il tenant Office 365, è necessario considerare i fattori seguenti come parte del processo di pianificazione.

Determinare quali asset statici si desidera ospitare nella rete CDN

In generale, le reti CDN sono più efficaci per l'hosting di asset statici o asset che non cambiano spesso. Una buona regola generale consiste nell'identificare i file che soddisfano alcune o tutte queste condizioni:

  • File statici incorporati in una pagina ,ad esempio script e immagini, che potrebbero avere un effetto significativo sui tempi di caricamento della pagina.
  • File di grandi dimensioni come eseguibili e file di installazione.
  • Librerie di risorse che supportano il codice lato client.

Ad esempio, l'aggiunta di file di piccole dimensioni ripetutamente richiesti (immagini e script del sito) a un'origine della rete CDN può migliorare significativamente le prestazioni di rendering del sito e ridurre in modo incrementale il carico sui siti di SharePoint Online. I file di dimensioni maggiori (eseguibili di installazione) possono essere scaricati dalla rete CDN, offrendo un effetto positivo sulle prestazioni e la successiva riduzione del carico nel sito di SharePoint Online, anche se non sono accessibili con la stessa frequenza.

Il miglioramento delle prestazioni per file dipende da molti fattori, tra cui la prossimità del client all'endpoint della rete CDN più vicina, le condizioni temporanee nella rete locale e così via. Molti file statici sono di piccole dimensioni e possono essere scaricati da Office 365 in meno di un secondo. Tuttavia, una pagina Web potrebbe contenere molti file incorporati con un tempo di download cumulativo di diversi secondi. La gestione di questi file dalla rete CDN può ridurre significativamente il tempo di caricamento complessivo della pagina. Vedere Quali miglioramenti delle prestazioni offre una rete CDN? per un esempio.

Determinare dove archiviare gli asset

La rete CDN recupera gli asset da una località denominata origine. Un'origine può essere un sito di SharePoint, una raccolta documenti o una cartella accessibile da un URL. Si ha una grande flessibilità quando si specificano le origini per l'organizzazione. Ad esempio, è possibile specificare più origini o una singola origine in cui inserire tutti gli asset della rete CDN.

È possibile creare un nuovo contenitore per le origini, ad esempio cartelle o raccolte documenti, e aggiungere i file da rendere disponibili dalla rete CDN. Si tratta di un approccio valido per un set specifico di asset che si vuole rendere disponibili dalla rete CDN e si vuole limitare il set di asset della rete CDN solo a tali file nel contenitore.

È anche possibile configurare una raccolta siti, un sito, una raccolta o una cartella esistenti come origine, rendendo disponibili tutti gli asset idonei nel contenitore dalla rete CDN. Prima di aggiungere un contenitore esistente come origine, è importante assicurarsi di conoscerne il contenuto e le autorizzazioni in modo da non esporre inavvertitamente gli asset all'accesso anonimo o agli utenti non autorizzati.

È possibile definire criteri della rete CDN per escludere il contenuto nelle origini dalla rete CDN. I criteri della rete CDN escludono gli asset nelle origini pubbliche da attributi come il tipo di file e la classificazione del sito e vengono applicati a tutte le origini del tipo CdnType (privato o pubblico) specificato nei criteri. Ad esempio, se si aggiunge un'origine costituita da un sito che contiene più siti secondari, è possibile definire un criterio per escludere i siti contrassegnati come riservati in modo che il contenuto dei siti con tale classificazione applicata non venga servito dalla rete CDN. I criteri si applicano al contenuto di tutte le origini aggiunte alla rete CDN.

Tenere presente che maggiore è il numero di origini, maggiore sarà l'effetto sul tempo impiegato dal servizio della rete CDN per elaborare le richieste. È consigliabile limitare il più possibile il numero di origini.

Attributi e vantaggi dell'hosting di asset in origini pubbliche

  • Gli asset esposti in un'origine pubblica sono accessibili da tutti in modo anonimo.

    Importante

    Non inserire mai le risorse che contengono informazioni utente o che sono considerate sensibili all'organizzazione in un'origine pubblica.

  • Se si rimuove un asset da un'origine pubblica, l'asset potrebbe continuare a essere disponibile fino a 30 giorni dalla cache; tuttavia, i collegamenti all'asset nella rete CDN vengono invalidi entro 15 minuti.

  • Quando si ospitano fogli di stile (file CSS) in un'origine pubblica, è possibile usare percorsi e URI relativi all'interno del codice. Questo risultato significa che è possibile fare riferimento alla posizione delle immagini di sfondo e di altri oggetti rispetto alla posizione dell'asset che lo chiama.

  • Anche se è possibile costruire l'URL di un'origine pubblica, è consigliabile procedere con cautela, usare la proprietà di contesto della pagina e seguire le indicazioni per eseguire questa operazione. Se l'accesso alla rete CDN non è più disponibile, l'URL non viene risolto automaticamente nell'organizzazione in SharePoint Online e potrebbe causare collegamenti interrotti e altri errori. Anche l'URL è soggetto a modifiche, quindi non è consigliabile codificarlo con il valore corrente.

  • I tipi di file predefiniti inclusi per le origini pubbliche sono: .css, .eot, , .ico.gif, .jpeg, , .jpg, .js, .map, , .png, .svg, , .ttfe .woff.woff2. È possibile specificare altri tipi di file.

  • È possibile configurare un criterio per escludere gli asset in base alle classificazioni del sito specificate. Ad esempio, è possibile escludere tutti gli asset contrassegnati come "riservati" o "limitati", anche se sono un tipo di file consentito e si trovano in un'origine pubblica.

Origini della rete CDN predefinita

A meno che non si specifichi diversamente, Office 365 configura automaticamente alcune origini predefinite quando si abilita la rete CDN Office 365. Se inizialmente si sceglie di non eseguirne il provisioning, è possibile aggiungere queste origini dopo aver completato l'installazione. A meno che non si comprendano le conseguenze della mancata configurazione delle origini predefinite e non si abbia un motivo specifico per farlo, è consigliabile consentirne la creazione quando si abilita la rete CDN.

Origini della rete CDN pubblica predefinita:

  • */masterpage
  • Libreria */style
  • */clientsideassets

Nota

clientsideassets è un'origine pubblica predefinita aggiunta al servizio rete CDN Office 365 nel dicembre 2017. Questa origine deve essere presente affinché SharePoint Framework soluzioni nella rete CDN funzionino. Se la rete CDN Office 365 è stata abilitata prima di dicembre 2017 o se è stata ignorata la configurazione delle origini predefinite quando è stata abilitata la rete CDN, è possibile aggiungere manualmente questa origine. Per altre informazioni, vedere Web part sul lato client o SharePoint Framework soluzione non funziona.

Configurare e configurare la rete CDN Office 365 usando il SharePoint Online Management Shell

Per le procedure descritte in questa sezione è necessario usare il SharePoint Online Management Shell per connettersi a SharePoint Online. Per istruzioni, vedere Connettersi a PowerShell di SharePoint Online.

Completare questi passaggi per configurare e configurare la rete CDN per ospitare gli asset in SharePoint Online usando il SharePoint Online Management Shell.

(Seleziona per espandere)

Abilitare l'organizzazione per l'uso della rete CDN Office 365

Prima di apportare modifiche alle impostazioni della rete CDN del tenant, è necessario recuperare lo stato corrente della configurazione della rete CDN nel tenant Office 365. Connettersi al tenant usando il SharePoint Online Management Shell:

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

Usare ora il cmdlet Get-SPOTenantCdnEnabled per recuperare le impostazioni di stato della rete CDN dal tenant:

Get-SPOTenantCdnEnabled -CdnType Public

Lo stato della rete CDN per l'oggetto CdnType specificato viene visualizzato sullo schermo.

Usare il cmdlet Set-SPOTenantCdnEnabled per consentire all'organizzazione di usare la rete CDN Office 365. È possibile abilitare l'organizzazione per l'uso di origini pubbliche. È anche possibile configurare la rete CDN per ignorare la configurazione delle origini predefinite quando viene abilitata. È sempre possibile aggiungere queste origini in un secondo momento, come descritto in questo articolo.

In Windows PowerShell per SharePoint Online:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Per consentire all'organizzazione di usare origini pubbliche ma ignorare la configurazione delle origini predefinite, digitare il comando seguente:

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

Vedere Origini cdn predefinite per informazioni sulle origini di cui viene eseguito il provisioning per impostazione predefinita quando si abilita la rete CDN Office 365 e sul potenziale effetto di ignorare la configurazione delle origini predefinite.

Per consentire all'organizzazione di usare origini pubbliche, digitare il comando seguente:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Per altre informazioni su questo cmdlet, vedere Set-SPOTenantCdnEnabled.

Modificare l'elenco dei tipi di file da includere nella rete CDN Office 365 (facoltativo)

Consiglio

Quando si definiscono i tipi di file usando il cmdlet Set-SPOTenantCdnPolicy , si sovrascrive l'elenco attualmente definito. Se si desidera aggiungere altri tipi di file all'elenco, usare prima il cmdlet per scoprire quali tipi di file sono già consentiti e includerli nell'elenco insieme ai nuovi tipi.

Usare il cmdlet Set-SPOTenantCdnPolicy per definire tipi di file statici che possono essere ospitati dalle origini pubbliche nella rete CDN. Per impostazione predefinita, sono consentiti tipi di asset comuni, ad esempio .css, .gif, .jpg e .js.

In Windows PowerShell per SharePoint Online:

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

Ad esempio, per abilitare la rete CDN per ospitare .css e .png file, immettere il comando :

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

Per visualizzare i tipi di file attualmente consentiti dalla rete CDN, usare il cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public>

Per altre informazioni su questi cmdlet, vedere Set-SPOTenantCdnPolicy e Get-SPOTenantCdnPolicies.

Modificare l'elenco delle classificazioni del sito da escludere dalla rete CDN Office 365 (facoltativo)

Consiglio

Quando si escludono le classificazioni dei siti usando il cmdlet Set-SPOTenantCdnPolicy , si sovrascrive l'elenco attualmente definito. Se si vogliono escludere più classificazioni del sito, usare prima il cmdlet per scoprire quali classificazioni sono già escluse e quindi aggiungerle insieme a quelle nuove.

Usare il cmdlet Set-SPOTenantCdnPolicy per escludere le classificazioni del sito che non si desidera rendere disponibili tramite la rete CDN. Per impostazione predefinita, non vengono escluse classificazioni del sito.

In Windows PowerShell per SharePoint Online:

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

Per vedere quali classificazioni dei siti sono attualmente limitate, usare il cmdlet Get-SPOTenantCdnPolicies :

Get-SPOTenantCdnPolicies -CdnType <Public>

Le proprietà restituite sono IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

La proprietà IncludeFileExtensions contiene l'elenco di estensioni di file servite dalla rete CDN.

Nota

Le estensioni di file predefinite sono diverse tra pubblico e privato.

La proprietà ExcludeRestrictedSiteClassifications contiene le classificazioni del sito da escludere dalla rete CDN. Ad esempio, è possibile escludere i siti contrassegnati come riservati in modo che il contenuto dei siti con tale classificazione applicata non venga servito dalla rete CDN.

La proprietà ExcludeIfNoScriptDisabled esclude il contenuto dalla rete CDN in base alle impostazioni dell'attributo NoScript a livello di sito. Per impostazione predefinita, l'attributo NoScript è impostato su Abilitato per i siti moderni e Disabilitato per i siti classici . Dipende dalle impostazioni del tenant.

Per altre informazioni su questi cmdlet, vedere Set-SPOTenantCdnPolicy e Get-SPOTenantCdnPolicies.

Aggiungere un'origine per gli asset

Usare il cmdlet Add-SPOTenantCdnOrigin per definire un'origine. È possibile definire più origini. L'origine è un URL che punta a una raccolta o a una cartella di SharePoint che contiene gli asset che si desidera ospitare dalla rete CDN.

Importante

Non inserire mai le risorse che contengono informazioni utente o che sono considerate sensibili all'organizzazione in un'origine pubblica.

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

Il valore di path è il percorso relativo della libreria o della cartella che contiene gli asset. È possibile usare caratteri jolly oltre ai percorsi relativi. Le origini supportano caratteri jolly anteposti all'URL. In questo modo è possibile creare origini che si estendono su più siti. Ad esempio, per includere tutti gli asset nella master pages cartella per tutti i siti come origine pubblica all'interno della rete CDN, digitare il comando seguente:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Il modificatore di caratteri jolly */ può essere usato solo all'inizio del percorso e corrisponde a tutti i segmenti URL nell'URL specificato.
  • Il percorso può puntare a una raccolta documenti, a una cartella o a un sito. Ad esempio, il percorso */site1 corrisponde a tutte le raccolte documenti nel sito.

È possibile aggiungere un'origine con un percorso relativo specifico. Non è possibile aggiungere un'origine usando il percorso completo.

In questo esempio viene aggiunta un'origine pubblica della raccolta siteassets in un sito specifico:

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

In questo esempio viene aggiunta un'origine pubblica della cartella folder1 nella raccolta risorse del sito della raccolta siti:

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

Se nel percorso è presente uno spazio, è possibile racchiudere il percorso tra virgolette doppie o sostituire lo spazio con la codifica URL %20. Gli esempi seguenti aggiungono un'origine privata della cartella 1 nella raccolta risorse del sito della raccolta siti:

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

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

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-SPOTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. Questo risultato può richiedere fino a 15 minuti.

Esempio: Configurare un'origine pubblica per le pagine master e per la raccolta di stili per SharePoint Online

In genere, queste origini vengono configurate automaticamente quando si abilita la rete CDN Office 365. Tuttavia, se si desidera abilitarli manualmente, seguire questa procedura.

  • Usare il cmdlet Add-SPOTenantCdnOrigin per definire la libreria di stile come origine pubblica.

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

  • Usare il cmdlet Add-SPOTenantCdnOrigin per definire le pagine master come origine pubblica.

    Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-SPOTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. Questo risultato può richiedere fino a 15 minuti.

Gestire la rete CDN Office 365

Dopo aver configurato la rete CDN, è possibile apportare modifiche alla configurazione durante l'aggiornamento del contenuto o in base alle esigenze, come descritto in questa sezione.

Aggiungere, aggiornare o rimuovere asset dalla rete CDN Office 365

Dopo aver completato la procedura di installazione, è possibile aggiungere nuovi asset e aggiornare o rimuovere gli asset esistenti ogni volta che si desidera. È sufficiente apportare le modifiche agli asset nella cartella o nella raccolta di SharePoint identificata come origine. Se si aggiunge un nuovo asset, sarà immediatamente disponibile tramite la rete CDN. Tuttavia, se si aggiorna l'asset, la propagazione della nuova copia e la sua disponibilità nella rete CDN richiedono fino a 15 minuti.

Se è necessario recuperare il percorso dell'origine, è possibile usare il cmdlet Get-SPOTenantCdnOrigins . Per informazioni su come usare questo cmdlet, vedere Get-SPOTenantCdnOrigins.

Rimuovere un'origine dalla rete CDN Office 365

È possibile rimuovere l'accesso a una cartella o a una raccolta di SharePoint identificata come origine usando il cmdlet Remove-SPOTenantCdnOrigin .

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

Per informazioni su come usare questo cmdlet, vedere Remove-SPOTenantCdnOrigin.

Modificare un'origine nella rete CDN Office 365

Non è possibile modificare un'origine dopo la creazione. Rimuovere invece l'origine e quindi aggiungerne una nuova. Per altre informazioni, vedere Per rimuovere un'origine dalla rete CDN Office 365 e Per aggiungere un'origine per gli asset.

Disabilitare la rete CDN Office 365

Usare il cmdlet Set-SPOTenantCdnEnabled per disabilitare la rete CDN per l'organizzazione. Se per la rete CDN sono abilitate origini pubbliche, è necessario eseguire il cmdlet come illustrato negli esempi seguenti.

Per disabilitare l'uso delle origini pubbliche nella rete CDN, immettere il comando seguente:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Per altre informazioni su questo cmdlet, vedere Set-SPOTenantCdnEnabled.

Configurare e configurare la rete CDN Office 365 tramite PowerShell PnP

Per le procedure descritte in questa sezione è necessario usare PowerShell PnP per connettersi a SharePoint Online. Per istruzioni, vedere Introduzione a PowerShell PnP.

Completare questi passaggi per configurare e configurare la rete CDN per ospitare gli asset in SharePoint Online tramite PnP PowerShell.

(Seleziona per espandere)

Abilitare l'organizzazione per l'uso della rete CDN Office 365

Prima di apportare modifiche alle impostazioni della rete CDN del tenant, è necessario recuperare lo stato corrente della configurazione della rete CDN nel tenant Office 365. Connettersi al tenant usando PowerShell PnP:

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

Usare ora il cmdlet Get-PnPTenantCdnEnabled per recuperare le impostazioni di stato della rete CDN dal tenant:

Get-PnPTenantCdnEnabled -CdnType Public

Lo stato della rete CDN per l'oggetto CdnType specificato viene visualizzato sullo schermo.

Usare il cmdlet Set-PnPTenantCdnEnabled per consentire all'organizzazione di usare la rete CDN Office 365. È possibile abilitare l'organizzazione per l'uso di origini pubbliche. È anche possibile configurare la rete CDN per ignorare la configurazione delle origini predefinite quando viene abilitata. È sempre possibile aggiungere queste origini in un secondo momento, come descritto in questo articolo.

In PowerShell PnP:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Per consentire all'organizzazione di usare origini pubbliche ma ignorare la configurazione delle origini predefinite, digitare il comando seguente:

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

Vedere Origini cdn predefinite per informazioni sulle origini di cui viene eseguito il provisioning per impostazione predefinita quando si abilita la rete CDN Office 365 e sul potenziale effetto di ignorare la configurazione delle origini predefinite.

Per consentire all'organizzazione di usare origini pubbliche, digitare il comando seguente:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Per altre informazioni su questo cmdlet, vedere Set-PnPTenantCdnEnabled.

Modificare l'elenco dei tipi di file da includere nella rete CDN Office 365 (facoltativo)

Consiglio

Quando si definiscono i tipi di file usando il cmdlet Set-PnPTenantCdnPolicy , si sovrascrive l'elenco attualmente definito. Se si desidera aggiungere altri tipi di file all'elenco, usare prima il cmdlet per scoprire quali tipi di file sono già consentiti e includerli nell'elenco insieme ai nuovi tipi.

Usare il cmdlet Set-PnPTenantCdnPolicy per definire tipi di file statici che possono essere ospitati dalle origini pubbliche nella rete CDN. Per impostazione predefinita, sono consentiti tipi di asset comuni, ad esempio .css e .js.

In PowerShell PnP:

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

Ad esempio, per abilitare la rete CDN per ospitare .css e .png file, immettere il comando :

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

Per visualizzare i tipi di file attualmente consentiti dalla rete CDN, usare il cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType Public

Per altre informazioni su questi cmdlet, vedere Set-PnPTenantCdnPolicy e Get-PnPTenantCdnPolicies.

Modificare l'elenco delle classificazioni del sito da escludere dalla rete CDN Office 365 (facoltativo)

Consiglio

Quando si escludono le classificazioni dei siti usando il cmdlet Set-PnPTenantCdnPolicy , si sovrascrive l'elenco attualmente definito. Se si vogliono escludere più classificazioni del sito, usare prima il cmdlet per scoprire quali classificazioni sono già escluse e quindi aggiungerle insieme a quelle nuove.

Usare il cmdlet Set-PnPTenantCdnPolicy per escludere le classificazioni dei siti che non si desidera rendere disponibili sulla rete CDN. Per impostazione predefinita, non vengono escluse classificazioni del sito.

In PowerShell PnP:

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

Per vedere quali classificazioni dei siti sono attualmente limitate, usare il cmdlet Get-PnPTenantCdnPolicies :

Get-PnPTenantCdnPolicies -CdnType <Public>

Le proprietà restituite sono IncludeFileExtensions, ExcludeRestrictedSiteClassifications e ExcludeIfNoScriptDisabled.

La proprietà IncludeFileExtensions contiene l'elenco di estensioni di file servite dalla rete CDN.

Nota

Le estensioni di file predefinite sono diverse tra pubblico e privato.

La proprietà ExcludeRestrictedSiteClassifications contiene le classificazioni del sito da escludere dalla rete CDN. Ad esempio, è possibile escludere i siti contrassegnati come riservati in modo che il contenuto dei siti con tale classificazione applicata non venga servito dalla rete CDN.

La proprietà ExcludeIfNoScriptDisabled esclude il contenuto dalla rete CDN in base alle impostazioni dell'attributo NoScript a livello di sito. Per impostazione predefinita, l'attributo NoScript è impostato su Abilitato per i siti moderni e Disabilitato per i siti classici . Dipende dalle impostazioni del tenant.

Per altre informazioni su questi cmdlet, vedere Set-PnPTenantCdnPolicy e Get-PnPTenantCdnPolicies.

Aggiungere un'origine per gli asset

Usare il cmdlet Add-PnPTenantCdnOrigin per definire un'origine. È possibile definire più origini. L'origine è un URL che punta a una raccolta o a una cartella di SharePoint che contiene gli asset che si desidera ospitare dalla rete CDN.

Importante

Non inserire mai le risorse che contengono informazioni utente o che sono considerate sensibili all'organizzazione in un'origine pubblica.

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

Il valore di path è il percorso relativo della libreria o della cartella che contiene gli asset. È possibile usare caratteri jolly oltre ai percorsi relativi. Le origini supportano caratteri jolly anteposti all'URL. In questo modo è possibile creare origini che si estendono su più siti. Ad esempio, per includere tutti gli asset nella master pages cartella per tutti i siti come origine pubblica all'interno della rete CDN, digitare il comando seguente:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Il modificatore di caratteri jolly */ può essere usato solo all'inizio del percorso e corrisponde a tutti i segmenti URL nell'URL specificato.
  • Il percorso può puntare a una raccolta documenti, a una cartella o a un sito. Ad esempio, il percorso */site1 corrisponde a tutte le raccolte documenti nel sito.

È possibile aggiungere un'origine con un percorso relativo specifico. Non è possibile aggiungere un'origine usando il percorso completo.

In questo esempio viene aggiunta l'origine pubblica della raccolta risorse del sito in un sito specifico:

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

In questo esempio viene aggiunta un'origine pubblica della cartella folder1 nella raccolta risorse del sito della raccolta siti:

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

Se nel percorso è presente uno spazio, è possibile racchiudere il percorso tra virgolette doppie o sostituire lo spazio con la codifica URL %20. Gli esempi seguenti aggiungono un'origine pubblica della cartella 1 nella raccolta risorse del sito della raccolta siti:

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

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

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-PnPTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. Questo risultato può richiedere fino a 15 minuti.

Esempio: Configurare un'origine pubblica per le pagine master e per la raccolta di stili per SharePoint Online

In genere, queste origini vengono configurate automaticamente quando si abilita la rete CDN Office 365. Tuttavia, se si desidera abilitarli manualmente, seguire questa procedura.

  • Usare il cmdlet Add-PnPTenantCdnOrigin per definire la libreria di stile come origine pubblica.

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

  • Usare il cmdlet Add-PnPTenantCdnOrigin per definire le pagine master come origine pubblica.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-PnPTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. Questo risultato può richiedere fino a 15 minuti.

Esempio: Configurare un'origine pubblica per gli asset del sito, le pagine del sito e le immagini di pubblicazione per SharePoint Online

  • Usare il cmdlet Add-PnPTenantCdnOrigin per definire la cartella degli asset del sito come origine pubblica.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */siteassets

  • Usare il cmdlet Add-PnPTenantCdnOrigin per definire la cartella pagine del sito come origine pubblica.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */sitepages

  • Usare il cmdlet Add-PnPTenantCdnOrigin per definire la cartella delle immagini di pubblicazione come origine pubblica.

    Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */publishingimages

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-PnPTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. Questo risultato può richiedere fino a 15 minuti.

Esempio: Configurare un'origine pubblica per una raccolta siti per SharePoint Online

Usare il cmdlet Add-PnPTenantCdnOrigin per definire una raccolta siti come origine pubblica. Ad esempio:

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

Per altre informazioni su questo comando e sulla relativa sintassi, vedere Add-PnPTenantCdnOrigin.

Dopo aver eseguito il comando, il sistema sincronizza la configurazione nel data center. È possibile che venga visualizzato un messaggio Di configurazione in sospeso . Questo risultato è previsto quando il tenant di SharePoint Online si connette al servizio rete CDN. Questo risultato può richiedere fino a 15 minuti.

Gestire la rete CDN Office 365

Dopo aver configurato la rete CDN, è possibile apportare modifiche alla configurazione durante l'aggiornamento del contenuto o in base alle esigenze, come descritto in questa sezione.

Aggiungere, aggiornare o rimuovere asset dalla rete CDN Office 365

Dopo aver completato la procedura di installazione, è possibile aggiungere nuovi asset e aggiornare o rimuovere gli asset esistenti ogni volta che si desidera. È sufficiente apportare le modifiche agli asset nella cartella o nella raccolta di SharePoint identificata come origine. Se si aggiunge un nuovo asset, sarà immediatamente disponibile tramite la rete CDN. Tuttavia, se si aggiorna l'asset, la propagazione della nuova copia e la sua disponibilità nella rete CDN richiedono fino a 15 minuti.

Se è necessario recuperare il percorso dell'origine, è possibile usare il cmdlet Get-PnPTenantCdnOrigin . Per informazioni su come usare questo cmdlet, vedere Get-PnPTenantCdnOrigin.

Rimuovere un'origine dalla rete CDN Office 365

È possibile rimuovere l'accesso a una cartella o a una raccolta di SharePoint identificata come origine. Per eseguire questa azione, usare il cmdlet Remove-PnPTenantCdnOrigin .

Remove-PnPTenantCdnOrigin -OriginUrl <path> -CdnType <Public>

Per informazioni su come usare questo cmdlet, vedere Remove-PnPTenantCdnOrigin.

Modificare un'origine nella rete CDN Office 365

Non è possibile modificare un'origine dopo la creazione. Rimuovere invece l'origine e quindi aggiungerne una nuova. Per altre informazioni, vedere Per rimuovere un'origine dalla rete CDN Office 365 e Per aggiungere un'origine per gli asset.

Disabilitare la rete CDN Office 365

Usare il cmdlet Set-PnPTenantCdnEnabled per disabilitare la rete CDN per l'organizzazione. Se per la rete CDN sono abilitate sia le origini pubbliche che private, è necessario eseguire il cmdlet due volte, come illustrato negli esempi seguenti.

Per disabilitare l'uso delle origini pubbliche nella rete CDN, immettere il comando seguente:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Per disabilitare l'uso delle origini private nella rete CDN, immettere il comando seguente:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Per altre informazioni su questo cmdlet, vedere Set-PnPTenantCdnEnabled.

Configurare e configurare la rete CDN Office 365 usando l'interfaccia della riga di comando per Microsoft 365

Le procedure in questa sezione richiedono l'interfaccia della riga di comando per Microsoft 365. Connettersi quindi al tenant Office 365 usando il comando di accesso.

Completare questi passaggi per configurare e configurare la rete CDN per ospitare gli asset in SharePoint Online usando l'interfaccia della riga di comando per Microsoft 365.

(Seleziona per espandere)

Abilitare la rete CDN Office 365

È possibile gestire lo stato della rete CDN Office 365 nel tenant usando il comando spo cdn set.

Per abilitare la rete CDN pubblica Office 365 nel tenant, eseguire il comando seguente:

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

Visualizzare lo stato corrente della rete CDN Office 365

Per verificare se il tipo specifico di rete CDN Office 365 è abilitato o disabilitato, usare il comando spo cdn get.

Per verificare se la rete CDN pubblica Office 365 è abilitata, eseguire il comando seguente:

m365 spo cdn get --type Public

Visualizzare le origini della rete CDN Office 365

Per visualizzare le origini della rete CDN pubblica Office 365 attualmente configurate, eseguire il comando seguente:

m365 spo cdn origin list --type Public

Per informazioni sulle origini di cui viene eseguito il provisioning per impostazione predefinita quando si abilita la rete CDN Office 365, vedere Origini cdn predefinite.

Aggiungere un'origine della rete CDN Office 365

Importante

Non inserire mai le risorse considerate sensibili all'organizzazione in una raccolta documenti di SharePoint configurata come origine pubblica.

Usare il comando spo cdn origin add per definire un'origine della rete CDN. È possibile definire più origini. L'origine è un URL che punta a una raccolta o a una cartella di SharePoint contenente gli asset che la rete CDN ospiterà.

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

Dove path è il percorso relativo della cartella che contiene gli asset. È possibile usare caratteri jolly oltre ai percorsi relativi.

Per includere tutti gli asset nella raccolta pagine master di tutti i siti come origine pubblica, eseguire il comando seguente:

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

Nota

Dopo aver aggiunto un'origine della rete CDN, potrebbero essere necessari fino a 15 minuti per poter recuperare i file tramite il servizio rete CDN. È possibile verificare se l'origine specifica è già stata abilitata usando il comando spo cdn origin list .

Rimuovere un'origine della rete CDN Office 365

Usare il comando spo cdn origin remove per rimuovere un'origine della rete CDN per il tipo di rete CDN specificato.

Per rimuovere un'origine pubblica dalla configurazione della rete CDN, eseguire il comando seguente:

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

Nota

La rimozione di un'origine della rete CDN non influisce sui file archiviati in una raccolta documenti corrispondente all'origine. Se si fa riferimento a questi asset usando l'URL di SharePoint, SharePoint torna automaticamente all'URL originale che punta alla raccolta documenti. Se si fa riferimento agli asset usando un URL della rete CDN pubblica, la rimozione dell'origine interrompe il collegamento ed è necessario modificarli manualmente.

Modificare un'origine della rete CDN Office 365

Non è possibile modificare un'origine della rete CDN esistente. È invece consigliabile rimuovere l'origine della rete CDN definita in precedenza usando il spo cdn origin remove comando e aggiungerne una nuova usando il spo cdn origin add comando .

Modificare i tipi di file da includere nella rete CDN Office 365

Per impostazione predefinita, nella rete CDN sono inclusi i tipi di file seguenti: .css, , .eot.gif, .ico, .jpeg, .jpg, .js, , .map, , .png, , .svg, .ttf, .woffe .woff2. Se è necessario includere altri tipi di file nella rete CDN, è possibile modificare la configurazione della rete CDN usando il comando spo cdn policy set .

Nota

Quando si modifica l'elenco dei tipi di file, si sovrascrive l'elenco attualmente definito. Se si desidera includere più tipi di file, usare innanzitutto il comando spo cdn policy list per scoprire quali tipi di file sono attualmente configurati.

Per aggiungere il tipo di file JSON all'elenco predefinito dei tipi di file inclusi nella rete CDN pubblica, eseguire il comando seguente:

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

Modificare l'elenco delle classificazioni del sito da escludere dalla rete CDN Office 365

Usare il comando spo cdn policy set per escludere le classificazioni del sito che non si desidera rendere disponibili tramite la rete CDN. Per impostazione predefinita, non vengono escluse classificazioni del sito.

Nota

Quando si modifica l'elenco delle classificazioni dei siti escluse, si sovrascrive l'elenco attualmente definito. Se si vogliono escludere altre classificazioni, usare innanzitutto il comando spo cdn policy list per scoprire quali classificazioni sono attualmente configurate.

Per escludere i siti classificati come HBI dalla rete CDN pubblica, eseguire il comando seguente:

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

Disabilitare la rete CDN Office 365

Per disabilitare la rete CDN Office 365, usare il spo cdn set comando , ad esempio:

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

Uso degli asset della rete CDN

Ora che è stata abilitata la rete CDN e sono stati configurati origini e criteri, è possibile iniziare a usare gli asset della rete CDN.

Questa sezione illustra come usare gli URL della rete CDN nelle pagine e nei contenuti di SharePoint in modo che SharePoint reindirizza alla rete CDN le richieste di asset di origine pubblica e privata.

Per informazioni su come usare la rete CDN per l'hosting di web part sul lato client, vedere l'articolo Ospitare la web part sul lato client da Office 365 rete CDN (Hello World parte 4).

Per usare gli asset aggiunti a un'origine, è sufficiente aggiornare i collegamenti al file originale con il percorso del file nell'origine.

  • Modificare la pagina o il contenuto che contiene i collegamenti agli asset aggiunti a un'origine. È anche possibile usare uno dei diversi metodi per cercare e sostituire a livello globale i collegamenti in un sito di immissione o in una raccolta siti se si vuole aggiornare il collegamento a un determinato asset ovunque venga visualizzato.
  • Per ogni collegamento a un asset in un'origine, sostituire il percorso con il percorso del file nell'origine della rete CDN. È possibile usare percorsi relativi.
  • Salvare la pagina o il contenuto.

Si consideri ad esempio l'immagine /site/SiteAssets/images/image.png, copiata nella cartella della raccolta documenti /site/CDN_origins/public/. Per usare l'asset della rete CDN, sostituire il percorso originale del file di immagine con il percorso dell'origine per rendere il nuovo URL /site/CDN_origins/public/image.png.

Se si vuole usare l'URL completo dell'asset anziché un percorso relativo, creare il collegamento in questo modo:

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

Nota

In generale, non è consigliabile hardcodedare gli URL direttamente agli asset nella rete CDN. Tuttavia, se necessario, è possibile creare manualmente GLI URL per gli asset nelle origini pubbliche. Per altre informazioni, vedere URL della rete CDN hardcodifica per gli asset pubblici.

Per informazioni su come verificare che gli asset vengano serviti dalla rete CDN, vedere Ricerca per categorie verificare che gli asset siano gestiti dalla rete CDN? in Risoluzione dei problemi della rete CDN Office 365.

Uso di asset in origini pubbliche

La funzionalità Di pubblicazione in SharePoint Online riscrive automaticamente gli URL degli asset archiviati in origini pubbliche nei rispettivi equivalenti della rete CDN in modo che gli asset vengano serviti dal servizio della rete CDN anziché da SharePoint.

Se l'origine si trova in un sito con la funzionalità Di pubblicazione abilitata e gli asset da scaricare nella rete CDN si trovano in una delle categorie seguenti, SharePoint riscrive automaticamente gli URL per gli asset nell'origine, se l'asset non è stato escluso da un criterio della rete CDN.

L'esempio seguente è una panoramica in cui i collegamenti vengono riscritti automaticamente dalla funzionalità Pubblicazione sharePoint:

  • URL IMG/LINK/CSS nelle risposte HTML della pagina di pubblicazione classica.
    • Sono incluse le immagini aggiunte dagli autori all'interno del contenuto HTML di una pagina.
  • URL dell'immagine della web part Presentazione raccolta immagini.
  • Campi immagine nei risultati dell'API REST SPList (RenderListDataAsStream).
    • Usare la nuova proprietà ImageFieldsToTryRewriteToCdnUrls per fornire un elenco delimitato da virgole di campi.
    • Supporta i campi collegamento ipertestuale e PublishingImage.
  • Rendering delle immagini di SharePoint.

Il diagramma seguente illustra il flusso di lavoro quando SharePoint riceve una richiesta per una pagina contenente asset da un'origine pubblica.

Diagramma del flusso di lavoro: recupero di Office 365 asset della rete CDN da un'origine pubblica.

Consiglio

Se si vuole disabilitare la riscrittura automatica per URL specifici in una pagina, è possibile estrarre la pagina e aggiungere il parametro della stringa di query ? NoAutoReWrites=true alla fine di ogni collegamento da disabilitare.

Costruzione di URL della rete CDN per gli asset pubblici

Se la funzionalità di pubblicazione non è abilitata per un'origine pubblica o l'asset non è uno dei tipi di collegamento supportati dalla funzionalità di riscrittura automatica del servizio rete CDN, è possibile costruire manualmente gli URL nella posizione della rete CDN degli asset e usare questi URL nel contenuto.

Nota

È possibile costruire l'URL per la rete CDN pubblica e l'URL non deve essere hardcoded perché è soggetto a modifiche.

Per gli asset della rete CDN pubblica, il formato URL è simile all'esempio seguente:

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

Sostituire TenantHostName con il nome del tenant. Ad esempio:

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

Nota

Utilizzare la proprietà del contesto della pagina per costruire il prefisso anziché hardcodeing https://publiccdn.sharepointonline.com, perché l'URL è soggetto a modifiche. Se si usano modelli di visualizzazione con SharePoint Online classico, è possibile utilizzare la proprietà window._spPageContextInfo.publicCdnBaseUrl nel modello di visualizzazione per il prefisso dell'URL. Se si usano web part SPFx per SharePoint moderno e classico, è possibile utilizzare la proprietà this.context.pageContext.legacyPageContext.publicCdnBaseUrl, che fornisce anche il prefisso . Se il prefisso cambia, l'implementazione viene aggiornata con esso.

Come esempio per SPFx, è possibile costruire l'URL usando la proprietà this.context.pageContext.legacyPageContext.publicCdnBaseUrlrelativeURL for the item - - - / - /host. Per altre informazioni, vedere il video Uso della rete CDN nel codice lato client, che fa parte della serie di prestazioni della stagione 1.

Risoluzione dei problemi della rete CDN Office 365

Ricerca per categorie verificare che gli asset siano serviti dalla rete CDN?

Dopo aver aggiunto collegamenti agli asset della rete CDN a una pagina, è possibile verificare che l'asset venga servito dalla rete CDN passando alla pagina, facendo clic con il pulsante destro del mouse sull'immagine dopo che è stato eseguito il rendering e rivedendo l'URL dell'immagine.

È anche possibile usare gli strumenti di sviluppo del browser per visualizzare l'URL di ogni asset in una pagina o usare uno strumento di traccia di rete di terze parti.

Nota

Se si usa uno strumento di rete come Fiddler per testare gli asset al di fuori del rendering dell'asset da una pagina di SharePoint, è necessario aggiungere manualmente l'intestazione del referer "Referer: https://yourdomain.sharepoint.com" alla richiesta GET in cui l'URL è l'URL radice del tenant di SharePoint Online.

Non è possibile testare gli URL della rete CDN direttamente in un Web browser perché è necessario disporre di un referrer proveniente da SharePoint Online. Tuttavia, se si aggiunge l'URL dell'asset della rete CDN a una pagina di SharePoint e quindi si apre la pagina in un browser, viene eseguito il rendering dell'asset della rete CDN nella pagina.

Per altre informazioni sull'uso degli strumenti di sviluppo nel browser Microsoft Edge, vedere Microsoft Edge Developer Tools.

Per watch un breve video ospitato nel canale YouTube SharePoint Developer Patterns and Practices che mostra come verificare il funzionamento della rete CDN, vedere Verificare l'utilizzo della rete CDN e garantire una connettività di rete ottimale.

Perché gli asset di una nuova origine non sono disponibili?

Gli asset di nuove origini non saranno immediatamente disponibili per l'uso, perché la registrazione deve propagarsi attraverso la rete CDN e caricare gli asset dall'origine all'archiviazione della rete CDN. Il tempo necessario per la disponibilità degli asset nella rete CDN dipende dal numero di asset e dalle dimensioni dei file.

La web part sul lato client o la soluzione SharePoint Framework non funziona

Quando si abilita la rete CDN Office 365 per le origini pubbliche, il servizio rete CDN crea automaticamente queste origini predefinite:

  • */MASTERPAGE
  • LIBRERIA */STYLE
  • */CLIENTSIDEASSETS

Se l'origine */clientsideassets è mancante, SharePoint Framework soluzioni hanno esito negativo e non vengono generati messaggi di avviso o di errore. Questa origine potrebbe non essere presente perché la rete CDN è stata abilitata con il parametro -NoDefaultOrigins impostato su $true o perché l'origine è stata eliminata manualmente.

È possibile verificare quali origini sono presenti con il comando di PowerShell seguente:

Get-SPOTenantCdnOrigins -CdnType Public

In alternativa, è possibile verificare con l'interfaccia della riga di comando per Microsoft 365:

m365 spo cdn origin list

Per aggiungere l'origine in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

Per aggiungere l'origine usando l'interfaccia della riga di comando per Microsoft 365:

m365 spo cdn origin add --origin */CLIENTSIDEASSETS

Quali moduli di PowerShell e shell dell'interfaccia della riga di comando devono essere usati con la rete CDN Office 365?

È possibile scegliere di usare la rete CDN Office 365 usando il modulo SharePoint Online Management Shell PowerShell o l'interfaccia della riga di comando per Microsoft 365.

Vedere anche

Reti per la distribuzione di contenuti

Pianificazione della rete e ottimizzazione delle prestazioni per Office 365

Serie di prestazioni di SharePoint - Office 365 serie di video della rete CDN