Verwenden des Office 365 Content Delivery Network (CDN) mit SharePoint OnlineUse the Office 365 Content Delivery Network (CDN) with SharePoint Online

Sie können statische Objekte im Office 365-Netzwerk für die Inhaltsübermittlung (CDN) hosten, um eine bessere Leistung für Ihre SharePoint Online-Seiten zu ermöglichen.You can use the built-in Office 365 Content Delivery Network (CDN) to host static assets to provide better performance for your SharePoint Online pages. Das Office 365-Netzwerk für die Inhaltsübermittlung verbessert die Leistung, indem statische Objekte näher an den Browsern zwischengespeichert werden, die diese anfordern, wodurch Downloads beschleunigt werden und die Latenz reduziert wird.The Office 365 CDN improves performance by caching static assets closer to the browsers requesting them, which helps to speed up downloads and reduce latency. Außerdem verwendet das Office 365 CDN das http/2-Protokoll für verbesserte Komprimierung und HTTP-Pipelining.Also, the Office 365 CDN uses the HTTP/2 protocol for improved compression and HTTP pipelining. Das Office 365-Netzwerk für die Inhaltsübermittlung ist in Ihrem SharePoint Online-Abonnement enthalten.The Office 365 CDN service is included as part of your SharePoint Online subscription.

Hinweis

Das Office 365 CDN steht nur Mandanten in der Produktionsumgebung (weltweit) zur Verfügung.The Office 365 CDN is only available to tenants in the Production (worldwide) cloud. Die Mandanten in der US-Regierung, in China und in Deutschland unterstützen derzeit nicht die Office 365 CDN.Tenants in the US Government, China and Germany clouds do not currently support the Office 365 CDN.

Das Office 365-Netzwerk für die Inhaltsübermittlung besteht aus mehreren CDNs, über die Sie statische Objekte an mehreren Speicherorten hosten können, oder aus Ursprüngen, die aus globalen Hochgeschwindigkeitsnetzwerken bedient werden.The Office 365 CDN is composed of multiple CDNs that allow you to host static assets in multiple locations, or origins, and serve them from global high-speed networks. In Abhängigkeit von der Art der Inhalte, die Sie im Office 365-Netzwerk für die Inhaltsübermittlung hosten möchten, können Sie öffentliche Ursprünge, private Ursprünge oder beides hinzufügen.Depending on the kind of content you want to host in the Office 365 CDN, you can add public origins, private origins or both. Weitere Informationen zum Unterschied zwischen öffentlichen und privaten Quellen finden Sie unter Choose, ob jeder Ursprung öffentlich oder privat sein soll .See Choose whether each origin should be public or private for more information on the difference between public and private origins.

Office 365 CDN-konzeptionelles DiagrammOffice 365 CDN conceptual diagram

Wenn Sie bereits mit der Funktionsweise von CDNs vertraut sind, müssen Sie nur einige Schritte ausführen, um das Office 365 CDN für Ihren Mandanten zu aktivieren.If you are already familiar with the way that CDNs work, you only need to complete a few steps to enable the Office 365 CDN for your tenant. In diesem Thema wird beschrieben, wie.This topic describes how. Weitere Informationen zum Einstieg in das Hosten Ihrer statischen Objekte finden Sie unter.Read on for information about how to get started hosting your static assets.

Tipp

Es gibt andere von Microsoft gehostete CDNs, die mit Office 365 für spezielle Verwendungsszenarien verwendet werden können, aber in diesem Thema nicht behandelt werden, da Sie nicht in den Bereich des Office 365 CDN fallen.There are other Microsoft-hosted CDNs that can be used with Office 365 for specialized usage scenarios, but are not discussed in this topic because they fall outside the scope of the Office 365 CDN. Weitere Informationen finden Sie unter andere Microsoft-CDNs.For more information, see Other Microsoft CDNs.

Wechseln Sie zurück zu Netzwerkplanung und Leistungsoptimierung für Office 365.Head back to Network planning and performance tuning for Office 365.

Übersicht über das Arbeiten mit dem Office 365 CDN in SharePoint OnlineOverview of working with the Office 365 CDN in SharePoint Online

Um die Office 365 CDN für Ihre Organisation einzurichten, führen Sie die folgenden grundlegenden Schritte aus:To set up the Office 365 CDN for your organization, you follow these basic steps:

Nachdem Sie das Setup abgeschlossen haben, können Sie das Office 365 CDN im Laufe der Zeit verwalten:Once you're done with setup, you can Manage the Office 365 CDN over time by:

  • Hinzufügen, aktualisieren und Entfernen von ObjektenAdding, updating, and removing assets
  • Hinzufügen und Entfernen von UrsprüngenAdding and removing origins
  • Konfigurieren von CDN-RichtlinienConfiguring CDN policies
  • Falls erforderlich, Deaktivieren des CDNIf necessary, disabling the CDN

Weitere Informationen zum Zugreifen auf Ihre CDN-Ressourcen sowohl aus öffentlichen als auch aus privaten Quellen finden Sie unter using your CDN Assets .Finally, see Using your CDN assets to learn about accessing your CDN assets from both public and private origins.

Anleitungen zum Beheben häufig auftretender Probleme finden Sie unter Troubleshooting the Office 365 CDN .See Troubleshooting the Office 365 CDN for guidance on resolving common issues.

Planen der Bereitstellung des Office 365 CDNPlan for deployment of the Office 365 CDN

Bevor Sie das Office 365 CDN für Ihren Office 365-Mandanten bereitstellen, sollten Sie die folgenden Faktoren im Rahmen Ihres Planungsprozesses berücksichtigen.Before you deploy the Office 365 CDN for your Office 365 tenant, you should consider the following factors as part of your planning process.

Bestimmen Sie, welche statischen Objekte im CDN gehostet werden sollen.Determine which static assets you want to host on the CDN

Im Allgemeinen sind CDNs am effektivsten für das Hosten von _statischen Objekten_oder von Objekten, die sich nicht sehr häufig ändern.In general, CDNs are most effective for hosting static assets, or assets that don't change very often. Eine gute Faustregel besteht darin, Dateien zu identifizieren, die einige oder alle dieser Bedingungen erfüllen:A good rule of thumb is to identify files that meet some or all of these conditions:

  • In einer Seite eingebettete statische Dateien (wie Skripts und Bilder), die sich möglicherweise erheblich inkrementell auf die Seitenladezeiten auswirkenStatic files embedded in a page (like scripts and images) that may have a significant incremental impact on page load times
  • Große Dateien wie ausführbare Dateien und InstallationsdateienLarge files like executables and installation files
  • Ressourcen Bibliotheken, die clientseitigen Code unterstützenResource libraries that support client-side code

Beispielsweise können kleine Dateien, die wiederholt wie Website Bilder und Skripts angefordert werden, die Leistung von Website Renderings erheblich verbessern und die Last auf Ihren SharePoint Online Websites inkrementell reduzieren, wenn Sie Sie einem CDN-Ursprung hinzufügen.For example, small files that are repeatedly requested like site images and scripts can significantly improve site rendering performance and incrementally reduce the load on your SharePoint Online sites when you add them to a CDN origin. Größere Dateien wie Installationsdateien können aus dem CDN heruntergeladen werden, was sich positiv auf die Leistung auswirkt und die Last auf Ihrer SharePoint Online Website verringert, auch wenn Sie nicht so häufig auf Sie zugreifen.Larger files such as installation executables can be downloaded from the CDN, delivering a positive performance impact and subsequent reduction of the load on your SharePoint Online site, even if they are not accessed as often.

Die Leistungsverbesserung pro Datei hängt von vielen Faktoren ab, einschließlich der Nähe des Clients zum nächstgelegenen CDN-Endpunkt, der vorübergehenden Bedingungen im lokalen Netzwerk und so weiter.Performance improvement on a per-file basis is dependent on many factors, including the client's proximity to the nearest CDN endpoint, transient conditions on the local network, and so forth. Viele statische Dateien sind relativ klein und können in weniger als einer Sekunde von Office 365 heruntergeladen werden.Many static files are quite small, and can be downloaded from Office 365 in less than a second. Eine Webseite enthält jedoch möglicherweise viele eingebettete Dateien mit einer kumulierten Downloadzeit von mehreren Sekunden.However, a web page may contain many embedded files with a cumulative download time of several seconds. Das servieren dieser Dateien aus dem CDN kann die Ladezeit der gesamten Seite erheblich verkürzen.Serving these files from the CDN can significantly reduce the overall page load time. Sehen Sie, welche Leistungssteigerungen ein CDN bietet? ein Beispiel.See What performance gains does a CDN provide? for an example.

Bestimmen, wo Ihre Objekte gespeichert werden sollenDetermine where you want to store your assets

Das CDN ruft Ihre Objekte von einem Standort ab, der als _Ursprung_bezeichnet wird.The CDN fetches your assets from a location called an origin. Ein Ursprung kann eine SharePoint-Website, eine Dokumentbibliothek oder ein Ordner sein, auf die über eine URL zugegriffen werden kann.An origin can be a SharePoint site, document library or folder that is accessible by a URL. Sie haben eine große Flexibilität, wenn Sie den Ursprung für Ihre Organisation angeben.You have great flexibility when you specify origins for your organization. Sie können beispielsweise mehrere Ursprünge oder einen einzelnen Ursprung angeben, in dem Sie alle CDN-Objekte ablegen möchten.For example, you can specify multiple origins or a single origin where you want to put all your CDN assets. Sie können festlegen, dass sowohl öffentliche als auch private Ursprünge für Ihre Organisation gelten.You can choose to have both public or private origins for your organization. Die meisten Organisationen entscheiden sich für die Implementierung einer Kombination aus beiden.Most organizations will choose to implement a combination of the two.

Sie können neuen Container für ihre Herkunft wie Ordner oder Dokumentbibliotheken erstellen und Dateien hinzufügen, die Sie im CDN zur Verfügung stellen möchten.You can create new container for your origins such as folders or document libraries, and add files you want to make available from the CDN. Dies ist ein guter Ansatz, wenn Sie über einen bestimmten Satz von Objekten verfügen, die im CDN verfügbar sein sollen, und den Satz von CDN-Objekten auf diese Dateien im Container beschränken möchten.This is a good approach if you have a specific set of assets you want to be available from the CDN, and want to restrict the set of CDN assets to only those files in the container.

Sie können auch eine vorhandene Websitesammlung, Website, Bibliothek oder einen Ordner als Ursprung konfigurieren, mit der alle berechtigten Ressourcen im Container im CDN verfügbar gemacht werden.You can also configure an existing site collection, site, library or folder as an origin, which will make all eligible assets in the container available from the CDN. Bevor Sie einen vorhandenen Container als Ursprung hinzufügen, müssen Sie sicherstellen, dass Sie den Inhalt und die Berechtigungen kennen, damit Sie Objekte nicht versehentlich anonymen Zugriffen oder nicht autorisierten Benutzern offen legen.Before you add an existing container as an origin, it's important to make sure you are aware of its contents and permissions so you do not inadvertently expose assets to anonymous access or unauthorized users.

Sie können CDN-Richtlinien definieren, um Inhalte in ihren Ursprüngen aus dem CDN auszuschließen.You can define CDN policies to exclude content in your origins from the CDN. CDN-Richtlinien schließen Objekte in öffentlichem oder privatem Ursprung durch Attribute wie Dateityp und _Website Klassifizierung_aus und werden auf alle Ursprünge der CdnType (privat oder öffentlich) angewendet, die Sie in der Richtlinie angeben.CDN policies exclude assets in public or private origins by attributes such as file type and site classification, and are applied to all origins of the CdnType (private or public) you specify in the policy. Wenn Sie beispielsweise einen privaten Ursprung hinzufügen, der aus einer Website besteht, die mehrere Unterwebsites enthält, können Sie eine Richtlinie definieren, um als vertraulich gekennzeichnete Websites auszuschließen, sodass Inhalte von Websites mit dieser Klassifizierung nicht aus dem CDN bereitgestellt werden.For example, if you add a private origin consisting of a site that contains multiple subsites, you can define a policy to exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN. Die Richtlinie wird auf Inhalte aller privaten Ursprünge angewendet, die Sie dem CDN hinzugefügt haben.The policy will apply to content from all private origins you have added to the CDN.

Beachten Sie, dass je größer die Anzahl der Ursprünge ist, desto größer sind die Auswirkungen auf die Zeit, die der CDN-Dienst zum Verarbeiten von Anforderungen benötigt.Keep in mind that the greater the number of origins, the greater the impact on the time it takes the CDN service to process requests. Es wird empfohlen, die Anzahl der Ursprünge so weit wie möglich zu begrenzen.We recommend that you limit the number of origins as much as possible.

Wählen Sie aus, ob jeder Ursprung öffentlich oder privat sein soll.Choose whether each origin should be public or private

Wenn Sie einen Ursprung identifizieren, geben Sie an, ob er öffentlich oder _Privat_sein soll.When you identify an origin, you specify whether it should be made public or private. Der Zugriff auf CDN-Objekte im öffentlichen Ursprung ist anonym, und CDN-Inhalte in privater Herkunft werden durch dynamisch generierte Token für mehr Sicherheit gesichert.Access to CDN assets in public origins is anonymous, and CDN content in private origins is secured by dynamically generated tokens for greater security. Unabhängig davon, welche Option Sie auswählen, bietet Microsoft für Sie alle Schwerlasten, wenn es um die Verwaltung des CDN selbst geht.Regardless of which option you choose, Microsoft does all the heavy lifting for you when it comes to administration of the CDN itself. Außerdem können Sie Ihre Meinung später ändern, nachdem Sie das CDN eingerichtet und ihre Ursprünge identifiziert haben.Also, you can change your mind later, after you've set up the CDN and identified your origins.

Sowohl öffentliche als auch private Optionen bieten ähnliche Leistungssteigerungen, aber jedes verfügt über eindeutige Attribute und Vorteile.Both public and private options provide similar performance gains, but each has unique attributes and advantages.

Öffentliche Ursprünge im Office 365 CDN sind anonym zugänglich, und auf gehostete Objekte kann jeder zugreifen, der über die URL der Ressource verfügt.Public origins within the Office 365 CDN are accessible anonymously, and hosted assets can be accessed by anyone who has the URL to the asset. Da der Zugriff auf Inhalte in öffentlichen Ursprüngen anonym ist, sollten Sie diese nur zum Zwischenspeichern von nicht vertraulichen generischen Inhalten verwenden, z. B. JavaScript-Dateien, Skripts, Symbole oder Bilder.Because access to content in public origins is anonymous, you should only use them to cache non-sensitive generic content such as javascript files, scripts, icons and images.

Private Ursprünge im Office 365 CDN bieten privaten Zugriff auf Benutzer Inhalte wie SharePoint Online Dokumentbibliotheken, Websites und proprietäre Bilder.Private origins within the Office 365 CDN provide private access to user content such as SharePoint Online document libraries, sites and proprietary images. Der Zugriff auf Inhalte in privater Herkunft wird durch dynamisch generierte Token gesichert, sodass nur Benutzer mit Berechtigungen für die ursprüngliche Dokumentbibliothek oder den Speicherort darauf zugreifen können.Access to content in private origins is secured by dynamically generated tokens so it can only be accessed by users with permissions to the original document library or storage location. Private Ursprünge im Office 365 CDN können nur für SharePoint Online Inhalte verwendet werden, und Sie können nur über die Umleitung von Ihrem SharePoint Online Mandanten auf Objekte im privaten Ursprung zugreifen.Private origins in the Office 365 CDN can only be used for SharePoint Online content, and you can only access assets in private origins through redirection from your SharePoint Online tenant.

Sie können mehr darüber erfahren, wie der CDN-Zugriff auf Objekte in einem privaten Ursprung in der Verwendung von Objekten in privaterHerkunft funktioniert.You can read more about how CDN access to assets in a private origin works in Using assets in private origins.

Attribute und Vorteile des Hostens von Objekten im öffentlichen UrsprungAttributes and advantages of hosting assets in public origins

  • Objekte, die an einem öffentlichen Ursprung verfügbar gemacht werden, sind für jeden Benutzer anonym zugänglich.Assets exposed in a public origin are accessible by everyone anonymously.

    Wichtig

    Sie sollten niemals Ressourcen platzieren, die Benutzerinformationen enthalten oder als vertraulich für Ihre Organisation in einem öffentlichen Ursprung betrachtet werden.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

  • Wenn Sie ein Objekt aus einem öffentlichen Ursprung entfernen, ist es unter Umständen bis zu 30 Tage lang weiterhin über den Cache verfügbar. Links zu dem Objekt im CDN werden jedoch innerhalb von 15 Minuten ungültig.If you remove an asset from a public origin, the asset may continue to be available for up to 30 days from the cache; however, we will invalidate links to the asset in the CDN within 15 minutes.
  • Wenn Sie Stylesheets (CSS-Dateien) an einem öffentlichen Ursprung hosten, können Sie im Code relative Pfade und URIs verwenden.When you host style sheets (CSS files) in a public origin, you can use relative paths and URIs within the code. Dies bedeutet, dass Sie auf den Speicherort von Hintergrundbildern und anderen Objekten relativ zum Speicherort des Objekts, das sie aufruft, verweisen können.This means that you can reference the location of background images and other objects relative to the location of the asset that's calling it.
  • Die URL eines öffentlichen Ursprungs kann zwar hartcodiert werden, dies wird jedoch nicht empfohlen.While you can hard code a public origin's URL, doing so is not recommended. Der Grund hierfür ist folgender: Wenn der Zugriff auf das CDN nicht mehr verfügbar ist, wird die URL nicht automatisch auf Ihre Organisation in SharePoint Online aufgelöst, was zu fehlerhaften Links und anderen Fehlern führen kann.The reason for this is that if access to the CDN becomes unavailable, the URL will not automatically resolve to your organization in SharePoint Online and might result in broken links and other errors.
  • Zu den standardmäßigen Dateitypen, die für öffentliche Ursprünge gehören, Gehören CSS, EOT, GIF, ICO, JPEG, JPG, JS, map, PNG, SVG, ttf, WOFF und woff2.The default file types that are included for public origins are .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff and .woff2. Sie können zusätzliche Dateitypen angeben.You can specify additional file types.
  • Sie können eine Richtlinie so konfigurieren, dass Objekte ausgeschlossen werden, die durch von Ihnen angegebene Website Klassifikationen identifiziert wurden.You can configure a policy to exclude assets that have been identified by site classifications that you specify. Beispielsweise können Sie alle Objekte ausschließen, die als „vertraulich“ oder „eingeschränkt“ gekennzeichnet sind, auch wenn sie einen zulässigen Dateityp haben und sich an einem öffentlichen Ursprung befinden.For example, you can choose to exclude all assets that are marked as "confidential" or "restricted" even if they are an allowed file type and are located in a public origin.

Attribute und Vorteile des Hostens von Objekten in privater HerkunftAttributes and advantages of hosting assets in private origins

  • Private Origins können nur für SharePoint Online Objekte verwendet werden.Private origins can only be used for SharePoint Online assets.
  • Benutzer können nur auf die Objekte von einem privaten Ursprung aus zugreifen, wenn Sie über Berechtigungen für den Zugriff auf den Container verfügen.Users can only access the assets from a private origin if they have permissions to access the container. Der anonyme Zugriff auf diese Objekte wird verhindert.Anonymous access to these assets is prevented.
  • Objekte im privaten Ursprung müssen vom SharePoint Online Mandanten verwiesen werden.Assets in private origins must be referred from the SharePoint Online tenant. Der direkte Zugriff auf private CDN-Objekte funktioniert nicht.Direct access to private CDN assets does not work.
  • Wenn Sie ein Objekt aus dem privaten Ursprung entfernen, ist das Objekt möglicherweise bis zu einer Stunde nach dem Cache verfügbar. Es werden jedoch Links zu dem Objekt im CDN innerhalb von 15 Minuten nach dem Entfernen der Ressource ungültig.If you remove an asset from the private origin, the asset may continue to be available for up to an hour from the cache; however, we will invalidate links to the asset in the CDN within 15 minutes of the asset's removal.
  • Die standardmäßigen Dateitypen, die für private Ursprünge eingeschlossen werden, sind GIF, ICO, JPEG, JPG, JS und PNG.The default file types that are included for private origins are .gif, .ico, .jpeg, .jpg, .js, and .png. Sie können zusätzliche Dateitypen angeben.You can specify additional file types.
  • Wie beim öffentlichen Ursprung können Sie eine Richtlinie so konfigurieren, dass Objekte ausgeschlossen werden, die anhand von Website Klassifikationen identifiziert wurden, die Sie selbst dann angeben, wenn Sie Platzhalter verwenden, um alle Objekte in einen Ordner oder eine Dokumentbibliothek einzuschließen.Just like with public origins, you can configure a policy to exclude assets that have been identified by site classifications that you specify even if you use wildcards to include all assets within a folder or document library.

Weitere Informationen dazu, warum Sie die Office 365 CDN, allgemeine CDN-Konzepte und andere Microsoft-CDNs verwenden können, die Sie mit Ihrem Office 365-Mandanten verwenden können, finden Sie unter Content Delivery Networks.For more information about why to use the Office 365 CDN, general CDN concepts, and other Microsoft CDNs you can use with your Office 365 tenant, see Content Delivery Networks.

Standard-CDN-UrsprüngeDefault CDN origins

Wenn Sie nichts anderes angeben, legt Office 365 eine Standard Herkunft fest, wenn Sie das Office 365 CDN aktivieren.Unless you specify otherwise, Office 365 sets up some default origins for you when you enable the Office 365 CDN. Wenn Sie diese ursprünglich nicht anbieten möchten, können Sie diese Ursprünge nach Abschluss des Setups hinzufügen.If you initially opt not to provision them, you can add these origins after you complete setup. Wenn Sie die Auswirkungen des Überspringens der Einrichtung von Standard Ursprüngen nicht verstehen und einen bestimmten Grund dafür haben, sollten Sie Sie beim Aktivieren des CDN erstellen lassen.Unless you understand the consequences of skipping the setup of default origins and have a specific reason for doing so, you should allow them to be created when you enable the CDN.

Standardmäßige private CDN-Ursprünge:Default private CDN origins:

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

Standardmäßige öffentliche CDN-Ursprünge:Default public CDN origins:

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

Hinweis

clientsideassets ist ein öffentlicher Standardursprung, der dem Office 365 CDN-Dienst im Dezember 2017 hinzugefügt wurde.clientsideassets is a default public origin that was added to the Office 365 CDN service in December 2017. Dieser Ursprung muss vorhanden sein, damit SharePoint-Framework-Lösungen im CDN funktionieren.This origin must be present in order for SharePoint Framework solutions in the CDN to work. Wenn Sie das Office 365 CDN vor Dezember 2017 aktiviert haben oder wenn Sie das Setup der Standard Ursprünge übersprungen haben, als Sie das CDN aktiviert haben, können Sie diesen Ursprung manuell hinzufügen.If you enabled the Office 365 CDN prior to December 2017, or if you skipped setup of default origins when you enabled the CDN, you can manually add this origin. Weitere Informationen finden Sie unter meine clientseitige Webparts oder SharePoint Framework-Lösung funktioniert nicht.For more information, see My client-side web part or SharePoint Framework solution isn't working.

Einrichten und Konfigurieren des Office 365 CDN mithilfe der SharePoint Online Management-ShellSet up and configure the Office 365 CDN by using the SharePoint Online Management Shell

Für die Verfahren in diesem Abschnitt müssen Sie die SharePoint Online-Verwaltungsshell verwenden, um eine Verbindung mit SharePoint Online herzustellen.The procedures in this section require you to use the SharePoint Online Management Shell to connect to SharePoint Online. Weitere Anweisungen finden Sie unter Connect to SharePoint Online PowerShell.For instructions, see Connect to SharePoint Online PowerShell.

Führen Sie die folgenden Schritte aus, um das CDN so einzurichten und zu konfigurieren, dass es Ihre Objekte in SharePoint Online mithilfe der SharePoint Online-Verwaltungsshell hostet.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the SharePoint Online Management Shell.

Zum Erweitern klickenClick to expand

Aktivieren Ihrer Organisation für die Verwendung des Office 365 CDNEnable your organization to use the Office 365 CDN

Bevor Sie Änderungen an den Mandanten-CDN-Einstellungen vornehmen, sollten Sie den aktuellen Status der privaten CDN-Konfiguration in Ihrem Office 365 Mandanten abrufen.Before you make changes to the tenant CDN settings, you should retrieve the current status of the private CDN configuration in your Office 365 tenant. Stellen Sie über die SharePoint Online-Verwaltungsshell eine Verbindung zu Ihrem Mandanten her:Connect to your tenant using the SharePoint Online Management Shell:

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

Verwenden Sie nun das Cmdlet Get-SPOTenantCdnEnabled , um die CDN-Statuseinstellungen aus dem Mandanten abzurufen:Now use the Get-SPOTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-SPOTenantCdnEnabled -CdnType <Public | Private>

Der Status des CDN für das angegebene CdnType-Objekt wird auf dem Bildschirm ausgegeben.The status of the CDN for the specified CdnType will output to the screen.

Verwenden Sie das Cmdlet " SPOTenantCdnEnabled ", um Ihrer Organisation die Verwendung des Office 365 CDN zu ermöglichen.Use the Set-SPOTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Sie können Ihre Organisation in die Lage versetzen, öffentliche Ursprünge, private Ursprünge oder beides gleichzeitig zu verwenden.You can enable your organization to use public origins, private origins, or both at once. Sie können das CDN auch so konfigurieren, dass das Setup von Standard Ursprüngen übersprungen wird, wenn Sie es aktivieren.You can also configure the CDN to skip the setup of default origins when you enable it. Sie können diese Ursprünge immer später wie in diesem Thema beschrieben hinzufügen.You can always add these origins later as described in this topic.

In Windows PowerShell für SharePoint Online:In Windows Powershell for SharePoint Online:

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

Geben Sie beispielsweise den folgenden Befehl ein, damit Ihre Organisation sowohl öffentliche als auch private Ursprünge verwenden kann:For example, to enable your organization to use both public and private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Both -Enable $true

Geben Sie den folgenden Befehl ein, um zu ermöglichen, dass Ihre Organisation sowohl öffentliche als auch private Ursprünge verwendet, aber das Einrichten der Standard Ursprünge überspringt:To enable your organization to use both public and private origins but skip setting up the default origins, type the following command:

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

Unter default CDN Origins finden Sie Informationen zu den Ursprüngen, die standardmäßig bereitgestellt werden, wenn Sie das Office 365 CDN aktivieren, und die potenziellen Auswirkungen des Überspringens der Einrichtung von Standard Ursprüngen.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Geben Sie den folgenden Befehl ein, um Ihre Organisation für die Verwendung von öffentlichen Ursprüngen zu aktivieren:To enable your organization to use public origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $true

Geben Sie den folgenden Befehl ein, um Ihre Organisation für die Verwendung privater Origins zu aktivieren:To enable your organization to use private origins, type the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $true

Weitere Informationen zu diesem Cmdlet finden Sie unter Sets-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Ändern der Liste der Dateitypen, die in das Office 365 CDN eingeschlossen werden sollen (optional)Change the list of file types to include in the Office 365 CDN (Optional)

Tipp

Wenn Sie Dateitypen mithilfe des Cmdlets "Cmdlet festlegen-SPOTenantCdnPolicy " definieren, überschreiben Sie die aktuell definierte Liste.When you define file types by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Wenn Sie der Liste weitere Dateitypen hinzufügen möchten, verwenden Sie zuerst das Cmdlet, um herauszufinden, welche Dateitypen bereits zulässig sind, und fügen Sie sie zusammen mit ihren neuen Dateien in die Liste ein.If you want to add additional file types to the list, use the cmdlet first to find out what file types are already allowed and include them in the list along with your new ones.

Verwenden Sie das Cmdlet " SPOTenantCdnPolicy ", um statische Dateitypen zu definieren, die von öffentlichen und privaten Quellen im CDN gehostet werden können.Use the Set-SPOTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Standardmäßig sind allgemeine Objekttypen zulässig, beispielsweise CSS, GIF, JPG und JS.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

In Windows PowerShell für SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Um beispielsweise das CDN zum Hosten von CSS-und PNG-Dateien zu aktivieren, geben Sie den folgenden Befehl ein:For example, to enable the CDN to host .css and .png files, you would enter the command:

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

Verwenden Sie das Cmdlet Get-SPOTenantCdnPolicies , um zu sehen, welche Dateitypen derzeit im CDN zulässig sind:To see what file types are currently allowed by the CDN, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Weitere Informationen zu diesen Cmdlets finden Sie unter Sets-SPOTenantCdnPolicy und Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Ändern Sie die Liste der Website Klassifizierungen, die Sie aus dem Office 365 CDN ausschließen möchten (optional).Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tipp

Wenn Sie Website Klassifizierungen mithilfe des Cmdlets " SPOTenantCdnPolicy " ausschließen, überschreiben Sie die aktuell definierte Liste.When you exclude site classifications by using the Set-SPOTenantCdnPolicy cmdlet, you overwrite the currently defined list. Wenn Sie zusätzliche Website Klassifizierungen ausschließen möchten, verwenden Sie zuerst das Cmdlet, um herauszufinden, welche Klassifizierungen bereits ausgeschlossen sind, und fügen Sie Sie dann zusammen mit ihren neuen hinzu.If you want to exclude additional site classifications, use the cmdlet first to find out what classifications are already excluded and then add them along with your new ones.

Verwenden Sie das Cmdlet Set-SPOTenantCdnPolicy -Cmdlet zum Ausschließen von Websiteklassifizierungen, die Sie nicht über das CDN zur Verfügung stellen möchten.Use the Set-SPOTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Standardmäßig sind keine Websiteklassifizierungen ausgeschlossen.By default, no site classifications are excluded.

In Windows PowerShell für SharePoint Online:In Windows PowerShell for SharePoint Online:

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

Um anzuzeigen, welche Website Klassifizierungen derzeit eingeschränkt sind, verwenden Sie das Cmdlet Get-SPOTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-SPOTenantCdnPolicies cmdlet:

Get-SPOTenantCdnPolicies -CdnType <Public | Private>

Die Eigenschaften, die zurückgegeben werden, sind IncludeFileExtensions, ExcludeRestrictedSiteClassifications und ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Die IncludeFileExtensions -Eigenschaft enthält die Liste der Dateierweiterungen, die vom CDN bereitgestellt werden.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Hinweis

Die standardmäßigen Dateierweiterungen unterscheiden sich zwischen öffentlichen und privaten.The default file extensions are different between public and private.

Die ExcludeRestrictedSiteClassifications -Eigenschaft enthält die Website Klassifizierungen, die Sie aus dem CDN ausschließen möchten.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Beispielsweise können Sie als vertraulich gekennzeichnete Websites ausschließen, sodass Inhalte von Websites mit dieser Klassifizierung nicht aus dem CDN bereitgestellt werden.For example, you can exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN.

Die ExcludeIfNoScriptDisabled -Eigenschaft schließt Inhalte aus dem CDN basierend auf den NoScript -Attributeinstellungen auf Websiteebene aus.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Standardmäßig ist das NoScript -Attribut auf für moderne Websites aktiviert und für klassische Websites deaktiviert festgelegt.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Dies hängt von ihren Mandanten Einstellungen ab.This depends on your tenant settings.

Weitere Informationen zu diesen Cmdlets finden Sie unter Sets-SPOTenantCdnPolicy und Get-SPOTenantCdnPolicies.For more information about these cmdlets, see Set-SPOTenantCdnPolicy and Get-SPOTenantCdnPolicies.

Hinzufügen eines Ursprungs für Ihre ObjekteAdd an origin for your assets

Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um einen Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define an origin. Sie können mehrere Ursprünge definieren.You can define multiple origins. Der Ursprung ist eine URL, die auf eine SharePoint-Bibliothek oder einen Ordner mit den Objekten verweist, die vom CDN gehostet werden sollen.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

Wichtig

Sie sollten niemals Ressourcen platzieren, die Benutzerinformationen enthalten oder als vertraulich für Ihre Organisation in einem öffentlichen Ursprung betrachtet werden.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

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

Der Wert von path ist der relative Pfad zu der Bibliothek oder dem Ordner, der die Objekte enthält.The value of path is the relative path to the library or folder that contains the assets. Sie können Platzhalter zusätzlich zu relativen Pfaden verwenden.You can use wildcards in addition to relative paths. Origins unterstützen Platzhalter für die URL.Origins support wildcards prepended to the URL. Auf diese Weise können Sie Ursprünge erstellen, die sich über mehrere Standorte erstrecken.This allows you to create origins that span multiple sites. Geben Sie beispielsweise den folgenden Befehl ein, um alle Objekte im MasterPages-Ordner für alle Websites als öffentlichen Ursprung innerhalb des CDN einzuschließen:For example, to include all of the assets in the masterpages folder for all of your sites as a public origin within the CDN, type the following command:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Der Platzhalter-Modifizierer * / kann nur am Anfang des Pfads verwendet werden und wird allen URL-Segmenten unter der angegebenen URL zugeordnet.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Der Pfad kann auf eine Dokumentbibliothek, einen Ordner oder eine Website deuten.The path can point to a document library, folder or site. Beispielsweise wird der Pfad */site1 alle Dokumentbibliotheken unter der Website entsprechen.For example, the path */site1 will match all the document libraries under the site.

Sie können einen Ursprung mit einem bestimmten relativen Pfad hinzufügen.You can add an origin with a specific relative path. Sie können keinen Ursprung mithilfe des vollständigen Pfads hinzufügen.You cannot add an origin using the full path.

In diesem Beispiel wird ein privater Ursprung der SiteAssets-Bibliothek auf einem bestimmten Standort hinzugefügt:This example adds a private origin of the siteassets library on a specific site:

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

In diesem Beispiel wird ein privater Ursprung des Folder1 -Ordners in der Bibliothek Website Objekte der Websitesammlung hinzugefügt:This example adds a private origin of the folder1 folder in the site collection's site assets library:

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

Wenn ein Leerzeichen im Pfad vorhanden ist, können Sie entweder den Pfad in doppelte Anführungszeichen einschließen oder den Platz durch die URL-Codierung %20 ersetzen.If there is a space in the path, you can either surround the path in double quotes or replace the space with the URL encoding %20. In den folgenden Beispielen wird ein privater Ursprung des Ordners Folder 1 in der Bibliothek Website Objekte der Websitesammlung hinzugefügt:The following examples add a private origin of the folder 1 folder in the site collection's site assets library:

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

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Hinweis

In privaten Quellen muss für Objekte, die von einem Ursprung freigegeben werden, eine Hauptversion veröffentlicht werden, bevor auf Sie über das CDN zugegriffen werden kann.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines öffentlichen Ursprungs für Ihre Gestaltungsvorlagen und für Ihre Stilbibliothek für SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normalerweise werden diese Ursprünge standardmäßig für Sie eingerichtet, wenn Sie das Office 365 CDN aktivieren.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Wenn Sie Sie jedoch manuell aktivieren möchten, führen Sie die folgenden Schritte aus.However, if you want to enable them manually, follow these steps.

  • Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um die Formatbibliothek als öffentlichen Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define the style library as a public origin.
  Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
  • Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um die Gestaltungsvorlagen als öffentlichen Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define the master pages as a public origin.
  Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines privaten Ursprungs für Ihre Website Objekte, Website Seiten und Veröffentlichungs Bilder für SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um den Ordner Website Objekte als privaten Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define the site assets folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
  • Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um den Ordner Website Seiten als privaten Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define the site pages folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
  • Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um den Ordner Veröffentlichungs Bilder als privaten Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.
  Add-SPOTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines privaten Ursprungs für eine Websitesammlung für SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Verwenden Sie das Cmdlet Add-SPOTenantCdnOrigin , um eine Websitesammlung als privaten Ursprung zu definieren.Use the Add-SPOTenantCdnOrigin cmdlet to define a site collection as a private origin. Beispiel:For example:

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

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-SPOTenantCdnOrigin.For more information about this command and its syntax, see Add-SPOTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Möglicherweise wird eine ausstehende Konfigurations Meldung angezeigt, die erwartet wird, wenn der SharePoint Online-Mandant eine Verbindung mit dem CDN-Dienst herstellt.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Verwalten des Office 365 CDNManage the Office 365 CDN

Nachdem Sie das CDN eingerichtet haben, können Sie, wie in diesem Abschnitt beschrieben, Änderungen an der Konfiguration vornehmen, wenn Sie Inhalte aktualisieren oder Ihre Anforderungen ändern.Once you've set up the CDN, you can make changes to your configuration as you update content or as your needs change, as described in this section.

Hinzufügen, aktualisieren oder Entfernen von Objekten aus dem Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Nachdem Sie die Setupschritte abgeschlossen haben, können Sie neue Objekte hinzufügen und vorhandene Objekte aktualisieren oder entfernen, wann immer Sie möchten.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Nehmen Sie einfach Ihre Änderungen an den Objekten im Ordner oder in der SharePoint-Bibliothek vor, die Sie als Ursprung identifiziert haben.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Wenn Sie ein neues Objekt hinzufügen, steht es sofort über das CDN zur Verfügung.If you add a new asset, it is available through the CDN immediately. Wenn Sie das Objekt aktualisieren, dauert es jedoch bis zu 15 Minuten, bis die neue Kopie weitergegeben wird und im CDN verfügbar ist.However, if you update the asset, it will take up to 15 minutes for the new copy to propagate and become available in the CDN.

Wenn Sie den Speicherort des Ursprungs abrufen möchten, können Sie das Cmdlet Get-spotenantcdnorigins ausführen verwenden.If you need to retrieve the location of the origin, you can use the Get-SPOTenantCdnOrigins cmdlet. Informationen zur Verwendung dieses Cmdlets finden Sie unter Get-spotenantcdnorigins ausführen.For information on how to use this cmdlet, see Get-SPOTenantCdnOrigins.

Entfernen eines Ursprungs aus dem Office 365 CDNRemove an origin from the Office 365 CDN

Sie können den Zugriff auf einen Ordner oder eine SharePoint-Bibliothek, den Sie als Ursprung identifiziert haben, entfernen.You can remove access to a folder or SharePoint library that you identified as an origin. Verwenden Sie dazu das Cmdlet Remove-SPOTenantCdnOrigin .To do this, use the Remove-SPOTenantCdnOrigin cmdlet.

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

Informationen zur Verwendung dieses Cmdlets finden Sie unter Remove-SPOTenantCdnOrigin.For information on how to use this cmdlet, see Remove-SPOTenantCdnOrigin.

Ändern eines Ursprungs im Office 365 CDNModify an origin in the Office 365 CDN

Sie können einen erstellten Ursprung nicht ändern.You cannot modify an origin you've created. Entfernen Sie stattdessen den Ursprung, und fügen Sie dann einen neuen ein.Instead, remove the origin and then add a new one. Weitere Informationen finden Sie unter So entfernen Sie einen Ursprung aus dem Office 365 CDN und fügen einen Ursprung für Ihre Objekte hinzu.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Deaktivieren des Office 365 CDNDisable the Office 365 CDN

Verwenden Sie das Cmdlet " SPOTenantCdnEnabled ", um das CDN für Ihre Organisation zu deaktivieren.Use the Set-SPOTenantCdnEnabled cmdlet to disable the CDN for your organization. Wenn Sie sowohl den öffentlichen als auch den privaten Ursprung für das CDN aktiviert haben, müssen Sie das Cmdlet zweimal ausführen, wie in den folgenden Beispielen dargestellt.If you have both the public and private origins enabled for the CDN, you need to run the cmdlet twice as shown in the following examples.

Geben Sie den folgenden Befehl ein, um die Verwendung der öffentlichen Herkunft im CDN zu deaktivieren:To disable use of public origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Public -Enable $false

Geben Sie den folgenden Befehl ein, um die Verwendung der privaten Ursprünge im CDN zu deaktivieren:To disable use of the private origins in the CDN, enter the following command:

Set-SPOTenantCdnEnabled -CdnType Private -Enable $false

Weitere Informationen zu diesem Cmdlet finden Sie unter Sets-SPOTenantCdnEnabled.For more information about this cmdlet, see Set-SPOTenantCdnEnabled.

Einrichten und Konfigurieren des Office 365 CDN mithilfe von PNP PowerShellSet up and configure the Office 365 CDN by using PnP PowerShell

Für die Verfahren in diesem Abschnitt müssen Sie PNP PowerShell verwenden, um eine Verbindung mit SharePoint Online herzustellen.The procedures in this section require you to use PnP PowerShell to connect to SharePoint Online. Anweisungen finden Sie unter Erste Schritte mit PNP PowerShell.For instructions, see Getting started with PnP PowerShell.

Führen Sie die folgenden Schritte aus, um das CDN so einzurichten und zu konfigurieren, dass es Ihre Objekte in SharePoint Online mithilfe von PNP PowerShell hostet.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using PnP PowerShell.

Zum Erweitern klickenClick to expand

Aktivieren Ihrer Organisation für die Verwendung des Office 365 CDNEnable your organization to use the Office 365 CDN

Bevor Sie Änderungen an den Mandanten-CDN-Einstellungen vornehmen, sollten Sie den aktuellen Status der privaten CDN-Konfiguration in Ihrem Office 365 Mandanten abrufen.Before you make changes to the tenant CDN settings, you should retrieve the current status of the private CDN configuration in your Office 365 tenant. Stellen Sie über PNP PowerShell eine Verbindung zu Ihrem Mandanten her:Connect to your tenant using PnP PowerShell:

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

Verwenden Sie nun das Cmdlet Get-PnPTenantCdnEnabled , um die CDN-Statuseinstellungen aus dem Mandanten abzurufen:Now use the Get-PnPTenantCdnEnabled cmdlet to retrieve the CDN status settings from the tenant:

Get-PnPTenantCdnEnabled -CdnType <Public | Private>

Der Status des CDN für das angegebene CdnType-Objekt wird auf dem Bildschirm ausgegeben.The status of the CDN for the specified CdnType will output to the screen.

Verwenden Sie das Cmdlet " PnPTenantCdnEnabled ", um Ihrer Organisation die Verwendung des Office 365 CDN zu ermöglichen.Use the Set-PnPTenantCdnEnabled cmdlet to enable your organization to use the Office 365 CDN. Sie können Ihre Organisation zur gleichzeitigen Verwendung von öffentlichem Ursprung, privatem Ursprung oder beides aktivieren.You can enable your organization to use public origins, private origins, or both at at the same time. Sie können das CDN auch so konfigurieren, dass das Setup von Standard Ursprüngen übersprungen wird, wenn Sie es aktivieren.You can also configure the CDN to skip the setup of default origins when you enable it. Sie können diese Ursprünge immer später wie in diesem Thema beschrieben hinzufügen.You can always add these origins later as described in this topic.

In PNP PowerShell:In PnP PowerShell:

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

Geben Sie beispielsweise den folgenden Befehl ein, damit Ihre Organisation sowohl öffentliche als auch private Ursprünge verwenden kann:For example, to enable your organization to use both public and private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Both -Enable $true

Geben Sie den folgenden Befehl ein, um zu ermöglichen, dass Ihre Organisation sowohl öffentliche als auch private Ursprünge verwendet, aber das Einrichten der Standard Ursprünge überspringt:To enable your organization to use both public and private origins but skip setting up the default origins, type the following command:

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

Unter default CDN Origins finden Sie Informationen zu den Ursprüngen, die standardmäßig bereitgestellt werden, wenn Sie das Office 365 CDN aktivieren, und die potenziellen Auswirkungen des Überspringens der Einrichtung von Standard Ursprüngen.See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN, and the potential impact of skipping the setup of default origins.

Geben Sie den folgenden Befehl ein, um Ihre Organisation für die Verwendung von öffentlichen Ursprüngen zu aktivieren:To enable your organization to use public origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $true

Geben Sie den folgenden Befehl ein, um Ihre Organisation für die Verwendung privater Origins zu aktivieren:To enable your organization to use private origins, type the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $true

Weitere Informationen zu diesem Cmdlet finden Sie unter Sets-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Ändern der Liste der Dateitypen, die in das Office 365 CDN eingeschlossen werden sollen (optional)Change the list of file types to include in the Office 365 CDN (Optional)

Tipp

Wenn Sie Dateitypen mithilfe des Cmdlets "Cmdlet festlegen-PnPTenantCdnPolicy " definieren, überschreiben Sie die aktuell definierte Liste.When you define file types by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Wenn Sie der Liste weitere Dateitypen hinzufügen möchten, verwenden Sie zuerst das Cmdlet, um herauszufinden, welche Dateitypen bereits zulässig sind, und fügen Sie sie zusammen mit ihren neuen Dateien in die Liste ein.If you want to add additional file types to the list, use the cmdlet first to find out what file types are already allowed and include them in the list along with your new ones.

Verwenden Sie das Cmdlet " PnPTenantCdnPolicy ", um statische Dateitypen zu definieren, die von öffentlichen und privaten Quellen im CDN gehostet werden können.Use the Set-PnPTenantCdnPolicy cmdlet to define static file types that can be hosted by public and private origins in the CDN. Standardmäßig sind allgemeine Objekttypen zulässig, beispielsweise CSS, GIF, JPG und JS.By default, common asset types are allowed, for example .css, .gif, .jpg, and .js.

In PNP PowerShell:In PnP PowerShell:

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

Um beispielsweise das CDN zum Hosten von CSS-und PNG-Dateien zu aktivieren, geben Sie den folgenden Befehl ein:For example, to enable the CDN to host .css and .png files, you would enter the command:

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

Verwenden Sie das Cmdlet Get-PnPTenantCdnPolicies , um zu sehen, welche Dateitypen derzeit im CDN zulässig sind:To see what file types are currently allowed by the CDN, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Weitere Informationen zu diesen Cmdlets finden Sie unter Sets-PnPTenantCdnPolicy und Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Ändern Sie die Liste der Website Klassifizierungen, die Sie aus dem Office 365 CDN ausschließen möchten (optional).Change the list of site classifications you want to exclude from the Office 365 CDN (Optional)

Tipp

Wenn Sie Website Klassifizierungen mithilfe des Cmdlets " PnPTenantCdnPolicy " ausschließen, überschreiben Sie die aktuell definierte Liste.When you exclude site classifications by using the Set-PnPTenantCdnPolicy cmdlet, you overwrite the currently defined list. Wenn Sie zusätzliche Website Klassifizierungen ausschließen möchten, verwenden Sie zuerst das Cmdlet, um herauszufinden, welche Klassifizierungen bereits ausgeschlossen sind, und fügen Sie Sie dann zusammen mit ihren neuen hinzu.If you want to exclude additional site classifications, use the cmdlet first to find out what classifications are already excluded and then add them along with your new ones.

Verwenden Sie das Cmdlet " PnPTenantCdnPolicy ", um Website Klassifizierungen auszuschließen, die nicht über das CDN verfügbar gemacht werden sollen.Use the Set-PnPTenantCdnPolicy cmdlet to exclude site classifications that you do not want to make available over the CDN. Standardmäßig sind keine Websiteklassifizierungen ausgeschlossen.By default, no site classifications are excluded.

In PNP PowerShell:In PnP PowerShell:

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

Um anzuzeigen, welche Website Klassifizierungen derzeit eingeschränkt sind, verwenden Sie das Cmdlet Get-PnPTenantCdnPolicies :To see what site classifications are currently restricted, use the Get-PnPTenantCdnPolicies cmdlet:

Get-PnPTenantCdnPolicies -CdnType <Public | Private>

Die Eigenschaften, die zurückgegeben werden, sind IncludeFileExtensions, ExcludeRestrictedSiteClassifications und ExcludeIfNoScriptDisabled.The properties that will be returned are IncludeFileExtensions, ExcludeRestrictedSiteClassifications and ExcludeIfNoScriptDisabled.

Die IncludeFileExtensions -Eigenschaft enthält die Liste der Dateierweiterungen, die vom CDN bereitgestellt werden.The IncludeFileExtensions property contains the list of file extensions that will be served from the CDN.

Hinweis

Die standardmäßigen Dateierweiterungen unterscheiden sich zwischen öffentlichen und privaten.The default file extensions are different between public and private.

Die ExcludeRestrictedSiteClassifications -Eigenschaft enthält die Website Klassifizierungen, die Sie aus dem CDN ausschließen möchten.The ExcludeRestrictedSiteClassifications property contains the site classifications that you want to exclude from the CDN. Beispielsweise können Sie als vertraulich gekennzeichnete Websites ausschließen, sodass Inhalte von Websites mit dieser Klassifizierung nicht aus dem CDN bereitgestellt werden.For example, you can exclude sites marked as Confidential so content from sites with that classification applied will not be served from the CDN.

Die ExcludeIfNoScriptDisabled -Eigenschaft schließt Inhalte aus dem CDN basierend auf den NoScript -Attributeinstellungen auf Websiteebene aus.The ExcludeIfNoScriptDisabled property excludes content from the CDN based on the site-level NoScript attribute settings. Standardmäßig ist das NoScript -Attribut auf für moderne Websites aktiviert und für klassische Websites deaktiviert festgelegt.By default, the NoScript attribute is set to Enabled for Modern sites and Disabled for Classic sites. Dies hängt von ihren Mandanten Einstellungen ab.This depends on your tenant settings.

Weitere Informationen zu diesen Cmdlets finden Sie unter Sets-PnPTenantCdnPolicy und Get-PnPTenantCdnPolicies.For more information about these cmdlets, see Set-PnPTenantCdnPolicy and Get-PnPTenantCdnPolicies.

Hinzufügen eines Ursprungs für Ihre ObjekteAdd an origin for your assets

Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um einen Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define an origin. Sie können mehrere Ursprünge definieren.You can define multiple origins. Der Ursprung ist eine URL, die auf eine SharePoint-Bibliothek oder einen Ordner mit den Objekten verweist, die vom CDN gehostet werden sollen.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

Wichtig

Sie sollten niemals Ressourcen platzieren, die Benutzerinformationen enthalten oder als vertraulich für Ihre Organisation in einem öffentlichen Ursprung betrachtet werden.You should never place resources that contain user information or are considered sensitive to your organization in a public origin.

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

Der Wert von path ist der relative Pfad zu der Bibliothek oder dem Ordner, der die Objekte enthält.The value of path is the relative path to the library or folder that contains the assets. Sie können Platzhalter zusätzlich zu relativen Pfaden verwenden.You can use wildcards in addition to relative paths. Origins unterstützen Platzhalter für die URL.Origins support wildcards prepended to the URL. Auf diese Weise können Sie Ursprünge erstellen, die sich über mehrere Standorte erstrecken.This allows you to create origins that span multiple sites. Geben Sie beispielsweise den folgenden Befehl ein, um alle Objekte im MasterPages-Ordner für alle Websites als öffentlichen Ursprung innerhalb des CDN einzuschließen:For example, to include all of the assets in the masterpages folder for all of your sites as a public origin within the CDN, type the following command:

Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage
  • Der Platzhalter-Modifizierer * / kann nur am Anfang des Pfads verwendet werden und wird allen URL-Segmenten unter der angegebenen URL zugeordnet.The wildcard modifier */ can only be used at the beginning of the path, and will match all URL segments under the specified URL.
  • Der Pfad kann auf eine Dokumentbibliothek, einen Ordner oder eine Website deuten.The path can point to a document library, folder or site. Beispielsweise wird der Pfad */site1 alle Dokumentbibliotheken unter der Website entsprechen.For example, the path */site1 will match all the document libraries under the site.

Sie können einen Ursprung mit einem bestimmten relativen Pfad hinzufügen.You can add an origin with a specific relative path. Sie können keinen Ursprung mithilfe des vollständigen Pfads hinzufügen.You cannot add an origin using the full path.

In diesem Beispiel wird ein privater Ursprung der Bibliothek Website Objekte auf einem bestimmten Standort hinzugefügt:This example adds a private origin of the site assets library on a specific site:

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

In diesem Beispiel wird ein privater Ursprung des Folder1 -Ordners in der Bibliothek Website Objekte der Websitesammlung hinzugefügt:This example adds a private origin of the folder1 folder in the site collection's site assets library:

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

Wenn ein Leerzeichen im Pfad vorhanden ist, können Sie entweder den Pfad in doppelte Anführungszeichen einschließen oder den Platz durch die URL-Codierung %20 ersetzen.If there is a space in the path, you can either surround the path in double quotes or replace the space with the URL encoding %20. In den folgenden Beispielen wird ein privater Ursprung des Ordners Folder 1 in der Bibliothek Website Objekte der Websitesammlung hinzugefügt:The following examples add a private origin of the folder 1 folder in the site collection's site assets library:

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

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Hinweis

In privaten Quellen muss für Objekte, die von einem Ursprung freigegeben werden, eine Hauptversion veröffentlicht werden, bevor auf Sie über das CDN zugegriffen werden kann.In private origins, assets being shared from an origin must have a major version published before they can be accessed from the CDN.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines öffentlichen Ursprungs für Ihre Gestaltungsvorlagen und für Ihre Stilbibliothek für SharePoint OnlineExample: Configure a public origin for your master pages and for your style library for SharePoint Online

Normalerweise werden diese Ursprünge standardmäßig für Sie eingerichtet, wenn Sie das Office 365 CDN aktivieren.Normally, these origins are set up for you by default when you enable the Office 365 CDN. Wenn Sie Sie jedoch manuell aktivieren möchten, führen Sie die folgenden Schritte aus.However, if you want to enable them manually, follow these steps.

  • Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um die Formatbibliothek als öffentlichen Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define the style library as a public origin.
  Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */style%20library
  • Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um die Gestaltungsvorlagen als öffentlichen Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define the master pages as a public origin.
  Add-PnPTenantCdnOrigin -CdnType Public -OriginUrl */masterpage

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines privaten Ursprungs für Ihre Website Objekte, Website Seiten und Veröffentlichungs Bilder für SharePoint OnlineExample: Configure a private origin for your site assets, site pages, and publishing images for SharePoint Online

  • Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um den Ordner Website Objekte als privaten Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define the site assets folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */siteassets
  • Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um den Ordner Website Seiten als privaten Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define the site pages folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */sitepages
  • Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um den Ordner Veröffentlichungs Bilder als privaten Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define the publishing images folder as a private origin.
  Add-PnPTenantCdnOrigin -CdnType Private -OriginUrl */publishingimages

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Beispiel: Konfigurieren eines privaten Ursprungs für eine Websitesammlung für SharePoint OnlineExample: Configure a private origin for a site collection for SharePoint Online

Verwenden Sie das Cmdlet Add-PnPTenantCdnOrigin , um eine Websitesammlung als privaten Ursprung zu definieren.Use the Add-PnPTenantCdnOrigin cmdlet to define a site collection as a private origin. Beispiel:For example:

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

Weitere Informationen zu diesem Befehl und seiner Syntax finden Sie unter Add-PnPTenantCdnOrigin.For more information about this command and its syntax, see Add-PnPTenantCdnOrigin.

Nachdem Sie den Befehl ausgeführt haben, synchronisiert das System die Konfiguration über das Datencenter hinweg.Once you've run the command, the system synchronizes the configuration across the datacenter. Möglicherweise wird eine ausstehende Konfigurations Meldung angezeigt, die erwartet wird, wenn der SharePoint Online-Mandant eine Verbindung mit dem CDN-Dienst herstellt.You may see a Configuration pending message which is expected as the SharePoint Online tenant connects to the CDN service. Dies kann bis zu 15 Minuten dauern.This can take up to 15 minutes.

Verwalten des Office 365 CDNManage the Office 365 CDN

Nachdem Sie das CDN eingerichtet haben, können Sie, wie in diesem Abschnitt beschrieben, Änderungen an der Konfiguration vornehmen, wenn Sie Inhalte aktualisieren oder Ihre Anforderungen ändern.Once you've set up the CDN, you can make changes to your configuration as you update content or as your needs change, as described in this section.

Hinzufügen, aktualisieren oder Entfernen von Objekten aus dem Office 365 CDNAdd, update, or remove assets from the Office 365 CDN

Nachdem Sie die Setupschritte abgeschlossen haben, können Sie neue Objekte hinzufügen und vorhandene Objekte aktualisieren oder entfernen, wann immer Sie möchten.Once you've completed the setup steps, you can add new assets, and update or remove existing assets whenever you want. Nehmen Sie einfach Ihre Änderungen an den Objekten im Ordner oder in der SharePoint-Bibliothek vor, die Sie als Ursprung identifiziert haben.Just make your changes to the assets in the folder or SharePoint library that you identified as an origin. Wenn Sie ein neues Objekt hinzufügen, steht es sofort über das CDN zur Verfügung.If you add a new asset, it is available through the CDN immediately. Wenn Sie das Objekt aktualisieren, dauert es jedoch bis zu 15 Minuten, bis die neue Kopie weitergegeben wird und im CDN verfügbar ist.However, if you update the asset, it will take up to 15 minutes for the new copy to propagate and become available in the CDN.

Wenn Sie den Speicherort des Ursprungs abrufen möchten, können Sie das Cmdlet Get-PnPTenantCdnOrigin verwenden.If you need to retrieve the location of the origin, you can use the Get-PnPTenantCdnOrigin cmdlet. Informationen zur Verwendung dieses Cmdlets finden Sie unter Get-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Get-PnPTenantCdnOrigin.

Entfernen eines Ursprungs aus dem Office 365 CDNRemove an origin from the Office 365 CDN

Sie können den Zugriff auf einen Ordner oder eine SharePoint-Bibliothek, den Sie als Ursprung identifiziert haben, entfernen.You can remove access to a folder or SharePoint library that you identified as an origin. Verwenden Sie dazu das Cmdlet Remove-PnPTenantCdnOrigin .To do this, use the Remove-PnPTenantCdnOrigin cmdlet.

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

Informationen zur Verwendung dieses Cmdlets finden Sie unter Remove-PnPTenantCdnOrigin.For information on how to use this cmdlet, see Remove-PnPTenantCdnOrigin.

Ändern eines Ursprungs im Office 365 CDNModify an origin in the Office 365 CDN

Sie können einen erstellten Ursprung nicht ändern.You cannot modify an origin you've created. Entfernen Sie stattdessen den Ursprung, und fügen Sie dann einen neuen ein.Instead, remove the origin and then add a new one. Weitere Informationen finden Sie unter So entfernen Sie einen Ursprung aus dem Office 365 CDN und fügen einen Ursprung für Ihre Objekte hinzu.For more information, see To remove an origin from the Office 365 CDN and To add an origin for your assets.

Deaktivieren des Office 365 CDNDisable the Office 365 CDN

Verwenden Sie das Cmdlet " PnPTenantCdnEnabled ", um das CDN für Ihre Organisation zu deaktivieren.Use the Set-PnPTenantCdnEnabled cmdlet to disable the CDN for your organization. Wenn Sie sowohl den öffentlichen als auch den privaten Ursprung für das CDN aktiviert haben, müssen Sie das Cmdlet zweimal ausführen, wie in den folgenden Beispielen dargestellt.If you have both the public and private origins enabled for the CDN, you need to run the cmdlet twice as shown in the following examples.

Geben Sie den folgenden Befehl ein, um die Verwendung der öffentlichen Herkunft im CDN zu deaktivieren:To disable use of public origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Public -Enable $false

Geben Sie den folgenden Befehl ein, um die Verwendung der privaten Ursprünge im CDN zu deaktivieren:To disable use of the private origins in the CDN, enter the following command:

Set-PnPTenantCdnEnabled -CdnType Private -Enable $false

Weitere Informationen zu diesem Cmdlet finden Sie unter Sets-PnPTenantCdnEnabled.For more information about this cmdlet, see Set-PnPTenantCdnEnabled.

Einrichten und Konfigurieren des Office 365 CDN mithilfe von Office 365 CLISet up and configure the Office 365 CDN using the Office 365 CLI

Für die Verfahren in diesem Abschnitt müssen Sie die Office 365 CLIinstalliert haben.The procedures in this section require that you have installed the Office 365 CLI. Stellen Sie als nächstes eine Verbindung mit dem Office 365-Mandanten mithilfe des Login -Befehls her.Next, connect to your Office 365 tenant using the login command.

Führen Sie die folgenden Schritte aus, um das CDN so einzurichten und zu konfigurieren, dass es Ihre Objekte in SharePoint Online mithilfe der Office 365 CLI hostet.Complete these steps to set up and configure the CDN to host your assets in SharePoint Online using the Office 365 CLI.

Zum Erweitern klickenClick to expand

Aktivieren Sie das Office 365 CDNEnable the Office 365 CDN

Sie können den Status des Office 365 CDN in Ihrem Mandanten mithilfe des Cmdlets spo cdn set verwalten.You can manage the state of the Office 365 CDN in your tenant using the spo cdn set command.

Um das öffentliche Office 365 CDN in Ihrem Mandanten zu aktivieren, führen Sie Folgendes aus:To enable the Office 365 Public CDN in your tenant execute:

spo cdn set --type Public --enabled true

Um die Office 365 SharePoint CDN zu aktivieren, führen Sie Folgendes aus:To enable the Office 365 SharePoint CDN, execute:

spo cdn set --type Private --enabled true

Anzeigen des aktuellen Status des Office 365 CDNView the current status of the Office 365 CDN

Um zu überprüfen, ob der bestimmte Typ von Office 365 CDN aktiviert oder deaktiviert ist, verwenden Sie den Befehl SPO CDN Get .To check if the particular type of Office 365 CDN is enabled or disabled, use the spo cdn get command.

Um zu überprüfen, ob das öffentliche Office 365 CDN aktiviert ist, führen Sie Folgendes aus:To check if the Office 365 Public CDN is enabled, execute:

spo cdn get --type Public

Anzeigen der Office 365 CDN-UrsprüngeView the Office 365 CDN origins

Um die derzeit konfigurierten öffentlichen Office 365 CDN-Ursprünge anzuzeigen, führen Sie Folgendes aus:To view the currently configured Office 365 Public CDN origins execute:

spo cdn origin list --type Public

Informationen zu den Ursprüngen, die standardmäßig bereitgestellt werden, wenn Sie das Office 365 CDN aktivieren, finden Sie unter default CDN Origins .See Default CDN origins for information about the origins that are provisioned by default when you enable the Office 365 CDN.

Hinzufügen eines Office 365 CDN-UrsprungsAdd an Office 365 CDN origin

Wichtig

Sie sollten niemals Ressourcen, die als vertraulich für Ihre Organisation betrachtet werden, in einer SharePoint-Dokumentbibliothek platzieren, die als öffentlicher Ursprung konfiguriert ist.You should never place resources that are considered sensitive to your organization in a SharePoint document library configured as a public origin.

Verwenden Sie den Befehl spo cdn origin add zum Definieren eines CDN-Ursprungs.Use the spo cdn origin add command to define a CDN origin. Sie können mehrere Ursprünge definieren.You can define multiple origins. Der Ursprung ist eine URL, die auf eine SharePoint-Bibliothek oder einen Ordner mit den Objekten verweist, die vom CDN gehostet werden sollen.The origin is a URL that points to a SharePoint library or folder that contains the assets that you want to be hosted by the CDN.

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

Dabei path ist der relative Pfad zu dem Ordner, der die Objekte enthält.Where path is the relative path to the folder that contains the assets. Sie können Platzhalter zusätzlich zu relativen Pfaden verwenden.You can use wildcards in addition to relative paths.

Wenn Sie alle Objekte im gestaltungsvorlagenkatalog aller Websites als öffentlichen Ursprung einbeziehen möchten, führen Sie Folgendes aus:To include all assets in the Master Page Gallery of all sites as a public origin, execute:

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

Um einen privaten Ursprung für eine bestimmte Websitesammlung zu konfigurieren, führen Sie Folgendes aus:To configure a private origin for a specific site collection, execute:

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

Hinweis

Nach dem Hinzufügen eines CDN-Ursprungs dauert es bis zu 15 Minuten, bis Sie Dateien mithilfe des CDN-Diensts abrufen können.After adding a CDN origin, it might take up to 15 minutes for you to be able to retrieve files via the CDN service. Sie können überprüfen, ob der betreffende Ursprung bereits aktiviert wurde, indem Sie den Befehl spo cdn origin list verwenden.You can verify if the particular origin has already been enabled using the spo cdn origin list command.

Entfernen eines Office 365 CDN-UrsprungsRemove an Office 365 CDN origin

Verwenden Sie den Befehl spo cdn origin remove, um einen CDN-Ursprung für den angegebenen CDN-Typ zu entfernen.Use the spo cdn origin remove command to remove a CDN origin for the specified CDN type.

Wenn Sie einen öffentlichen Ursprung aus der CDN-Konfiguration entfernen möchten, führen Sie Folgendes aus:To remove a public origin from the CDN configuration, execute:

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

Hinweis

Das Entfernen eines CDN-Ursprungs wirkt sich nicht auf die Dateien aus, die in einer Dokumentbibliothek gespeichert sind, die diesem Ursprung entspricht.Removing a CDN origin doesn't affect the files stored in any document library matching that origin. Wenn auf diese Objekte über Ihre SharePoint-URL verwiesen wurde, wechselt SharePoint automatisch wieder zu der ursprünglichen URL, die auf die Dokumentbibliothek zeigt.If these assets have been referenced using their SharePoint URL, SharePoint will automatically switch back to the original URL pointing to the document library. Wenn jedoch auf Objekte mithilfe einer öffentlichen CDN-URL verwiesen wurde, wird durch das Entfernen des Ursprungs die Verknüpfung aufgehoben, und Sie müssen Sie manuell ändern.If, however, assets have been referenced using a public CDN URL, then removing the origin will break the link and you will need to manually change them.

Ändern eines Office 365 CDN-UrsprungsModify an Office 365 CDN origin

Es ist nicht möglich, einen vorhandenen CDN-Ursprung zu ändern.It's not possible to modify an existing CDN origin. Stattdessen sollten Sie den zuvor definierten CDN-Ursprung mit dem Befehl spo cdn origin remove entfernen und mit dem Befehl spo cdn origin add einen neuen hinzufügen.Instead, you should remove the previously defined CDN origin using the spo cdn origin remove command and add a new one using the spo cdn origin add command.

Ändern der Dateitypen, die in das Office 365 CDN eingeschlossen werden sollenChange the types of files to include in the Office 365 CDN

Standardmäßig sind die folgenden Dateitypen in den CDN-Dateien enthalten: CSS, EOT, GIF, ICO, JPEG, JPG, JS, map, PNG, SVG, ttf, WOFF und woff2.By default, the following file types are included in the CDN: .css, .eot, .gif, .ico, .jpeg, .jpg, .js, .map, .png, .svg, .ttf, .woff and .woff2. Wenn Sie weitere Dateitypen in das CDN einbeziehen müssen, können Sie die CDN-Konfiguration mit dem Befehl spo cdn policy set ändern.If you need to include additional file types in the CDN, you can change the CDN configuration using the spo cdn policy set command.

Hinweis

Durch das Ändern der Liste von Dateitypen überschreiben Sie die aktuell definierte Liste.When changing the list of file types, you overwrite the currently defined list. Wenn Sie weitere Dateitypen einbeziehen möchten, verwenden Sie zunächst den Befehl spo cdn policy list, um herauszufinden, welche Dateitypen derzeit konfiguriert sind.If you want to include additional file types, first use the spo cdn policy list command to find out which file types are currently configured.

Um den JSON -Dateityp der Standardliste der im öffentlichen CDN enthaltenen Dateitypen hinzuzufügen, führen Sie Folgendes aus:To add the JSON file type to the default list of file types included in the public CDN, execute:

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

Ändern der Liste von Websiteklassifizierungen, die Sie aus dem Office 365 CDN ausschließen möchtenChange the list of site classifications you want to exclude from the Office 365 CDN

Verwenden Sie den Befehl spo cdn policy set zum Ausschließen von Websiteklassifizierungen, die Sie nicht über das CDN zur Verfügung stellen möchten.Use the spo cdn policy set command to exclude site classifications that you do not want to make available over the CDN. Standardmäßig sind keine Websiteklassifizierungen ausgeschlossen.By default, no site classifications are excluded.

Hinweis

Durch das Ändern der Liste der ausgeschlossenen Websiteklassifizierungen überschreiben Sie die aktuell definierte Liste.When changing the list of excluded site classifications, you overwrite the currently defined list. Wenn Sie zusätzliche Klassifizierungen ausschließen möchten, verwenden Sie zunächst den Befehl spo cdn policy list, um herauszufinden, welche Klassifizierungen derzeit konfiguriert sind.If you want to exclude additional classifications, first use the spo cdn policy list command to find out which classifications are currently configured.

Zum Ausschließen von als HBI klassifizierten Websites aus dem öffentlichen CDN führen SieTo exclude sites classified as HBI from the public CDN, execute

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

Deaktivieren des Office 365 CDNDisable the Office 365 CDN

Um das Office 365 CDN zu deaktivieren, verwenden Sie den Befehl spo cdn set. Beispiel:To disable the Office 365 CDN use the spo cdn set command, for example:

spo cdn set --type Public --enabled false

Verwenden Ihrer CDN-RessourcenUsing your CDN assets

Nachdem Sie nun das CDN und die konfigurierten Ursprünge und Richtlinien aktiviert haben, können Sie mit der Verwendung ihrer CDN-Objekte beginnen.Now that you have enabled the CDN and configured origins and policies, you can begin using your CDN assets.

In diesem Abschnitt erfahren Sie, wie Sie CDN-URLs in SharePoint-Seiten und-Inhalten verwenden, damit SharePoint-Anforderungen für Objekte sowohl in öffentlichen als auch privaten Quellen an das CDN umleiten.This section will help you understand how to use CDN URLs in your SharePoint pages and content so that SharePoint redirects requests for assets in both public and private origins to the CDN.

Informationen zum Verwenden des CDN zum Hosten clientseitiger Webparts finden Sie im Thema Hosten des clientseitigen Webparts aus Office 365 CDN (Hello World Teil 4).For information on how to use the CDN for hosting client-side web parts, see the topic Host your client-side web part from Office 365 CDN (Hello World part 4).

Hinweis

Wenn Sie den Ordner ClientSideAssets der Liste private CDN Origins hinzufügen, wird das Rendern von in CDN gehosteten benutzerdefinierten Webparts nicht möglich.If you add the ClientSideAssets folder to the private CDN origins list, CDN-hosted custom web parts will fail to render. Dateien, die von SPFX-Webparts verwendet werden, können nur das öffentliche CDN verwenden, und der ClientSideAssets-Ordner ist ein Standardursprung für das öffentliche CDN.Files used by SPFX web parts can only utilize the public CDN and the ClientSideAssets folder is a default origin for public CDN.

Um Objekte zu verwenden, die Sie einem Ursprung hinzugefügt haben, aktualisieren Sie einfach Links zur ursprünglichen Datei mit dem Pfad zur Datei im Ursprung.To use assets that you have added to an origin, you simply update links to the original file with the path to the file in the origin.

  • Bearbeiten Sie die Seite oder den Inhalt, die Links zu Objekten enthält, die Sie zu einem Ursprung hinzugefügt haben.Edit the page or content that contains links to assets you have added to an origin. Sie können auch eine von mehreren Methoden verwenden, um Links in einer Website oder Websitesammlung Global zu suchen und zu ersetzen, wenn Sie den Link zu einem bestimmten Objekt überall dort aktualisieren möchten, wo es angezeigt wird.You can also use one of several methods to globally search and replace links across an enter site or site collection if you want to update the link to a given asset everywhere it appears.
  • Ersetzen Sie für jeden Link zu einem Objekt in einem Ursprung den Pfad durch den Pfad zu der Datei im CDN-Ursprung.For each link to an asset in an origin, replace the path with the path to the file in the CDN origin. Sie können relative Pfade verwenden.You can use relative paths.
  • Speichern Sie die Seite oder den Inhalt.Save the page or content.

Sehen Sie sich beispielsweise das Bild _/Site/SiteAssets/Images/image.png_an, das Sie in den Dokumentbibliotheksordner /Site/CDN_origins/Public/ kopiert haben.For example, consider the image /site/SiteAssets/images/image.png, which you have copied to the document library folder /site/CDN_origins/public/. Um das CDN-Objekt zu verwenden, ersetzen Sie den ursprünglichen Pfad zum Speicherort der Bild Datei durch den Pfad zum Ursprung, um die neue URL _/Site/CDN_origins/Public/image.png_zu machen.To use the CDN asset, replace the original path to the image file location with the path to the origin to make the new URL /site/CDN_origins/public/image.png.

Wenn Sie die vollständige URL für das Objekt anstelle eines relativen Pfads verwenden möchten, erstellen Sie den Link wie folgt:If you want to use the full URL to the asset instead of a relative path, construct the link like so:

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

Hinweis

Im Allgemeinen sollten Sie URLs nicht direkt in Objekten im CDN hartcodieren.In general, you should not hardcode URLs directly to assets in the CDN. Sie können jedoch URLs für Objekte im öffentlichen Ursprung bei Bedarf manuell erstellen.However, you can manually construct URLs for assets in public origins if needed. Weitere Informationen finden Sie unter hartcodieren von CDN-URLs für öffentliche Objekte.For more information, see Hardcoding CDN URLs for public assets.

Informationen dazu, wie Sie überprüfen können, ob Objekte aus dem CDN bedient werden, finden Sie unter wie kann ich bestätigen, dass Objekte vom CDN bedient werden? in der Problembehandlung im Abschnitt Office 365 CDN .To learn about how to verify that assets are being served from the CDN, see How do I confirm that assets are being served by the CDN? in the Troubleshooting the Office 365 CDN section.

Verwenden von Objekten im öffentlichen UrsprungUsing assets in public origins

Das Veröffentlichungsfeature in SharePoint Online schreibt automatisch URLs von Objekten, die im öffentlichen Ursprung gespeichert sind, in Ihre CDN-äquivalente um, sodass Objekte vom CDN-Dienst anstelle von SharePoint bereitgestellt werden.The Publishing feature in SharePoint Online automatically rewrites URLs of assets stored in public origins to their CDN equivalents so that assets are served from the CDN service instead of SharePoint.

Wenn sich Ihr Ursprung in einer Website befindet, in der das Veröffentlichungsfeature aktiviert ist, und die Objekte, die Sie an das CDN Abladen möchten, sich in einer der folgenden Kategorien befinden, werden von SharePoint automatisch URLs für Objekte im Ursprung umgeschrieben, vorausgesetzt, das Objekt wurde nicht durch eine CDN-Richtlinie ausgeschlossen.If your origin is in a site with the Publishing feature enabled, and the assets you want to offload to the CDN are in one of the following categories, SharePoint will automatically rewrite URLs for assets in the origin, provided that the asset has not been excluded by a CDN policy.

Es folgt eine Übersicht über die Links, die automatisch vom SharePoint-Veröffentlichungsfeature umgeschrieben werden:The following is an overview of which links are automatically rewritten by the SharePoint Publishing feature:

  • IMG/LINK/CSS-URLs in den HTML-Antworten klassischer VeröffentlichungsseitenIMG/LINK/CSS URLs in classic publishing page HTML responses
    • Dies schließt von Autoren im HTML-Inhalt einer Seite hinzugefügte Bilder ein.This includes images added by authors within the HTML content of a page
  • Bild-URLs des Webparts „Bildbibliothek-Bildschirmpräsentation“Picture Library SlideShow webpart image URLs
  • Bildfelder in Ergebnissen der SPList-REST-API (RenderListDataAsStream)Image fields in SPList REST API (RenderListDataAsStream) results
    • Verwenden Sie die neue Eigenschaft ImageFieldsToTryRewriteToCdnUrls , um eine durch Kommas getrennte Liste von Feldern bereitzustellen.Use the new property ImageFieldsToTryRewriteToCdnUrls to provide a comma separated list of fields
    • Unterstützt Hyperlink-Felder und Publishing Image-FelderSupports hyperlink fields and PublishingImage fields
  • SharePoint-BildwiedergabenSharePoint image renditions

Das folgende Diagramm veranschaulicht den Workflow, wenn SharePoint eine Anforderung für eine Seite erhält, die Objekte aus einem öffentlichen Ursprung enthält.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a public origin.

Workflow Diagramm: Abrufen Office 365 CDN-Ressourcen von einem öffentlichen UrsprungWorkflow diagram: Retrieving Office 365 CDN assets from a public origin

Tipp

Wenn Sie die automatische Umschreibung für bestimmte URLs auf einer Seite deaktivieren möchten, können Sie die Seite Auschecken und den Abfragezeichenfolgenparameter hinzufügen ? NoAutoReWrites = true an das Ende jeder Verknüpfung, die Sie deaktivieren möchten.If you want to disable auto-rewriting for specific URLs on a page, you can check out the page and add the query string parameter ?NoAutoReWrites=true to the end of each link you want to disable.

Codieren von CDN-URLs für öffentliche ObjekteHardcoding CDN URLs for public assets

Wenn das Veröffentlichungs Feature nicht für einen öffentlichen Ursprung aktiviert ist oder wenn es sich nicht um einen der Linktypen handelt, die von der Funktion zum automatischen Umschreiben des CDN-Diensts unterstützt werden, können Sie URLs manuell für den CDN-Speicherort der Objekte erstellen und diese URLs in ihren Inhalten verwenden.If the Publishing feature is not enabled for a public origin, or the asset is not one of the link types supported by the auto-rewrite feature of the CDN service, you can manually construct URLs to the CDN location of the assets and use these URLs in your content.

Hinweis

Sie können CDN-URLs nicht für Objekte in einem privaten Ursprung hartcodieren, da das erforderliche Zugriffstoken, das den letzten Abschnitt der URL bildet, zu dem Zeitpunkt generiert wird, zu dem die Ressource angefordert wird.You cannot hardcode CDN URLs to assets in a private origin because the required access token that forms the last section of the URL is generated at the time the resource is requested.

Für öffentliche CDN-Objekte wird das URL-Format wie folgt aussehen:For public CDN assets, the URL format will look like the following:

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

Ersetzen Sie TenantHostName durch ihren Mandantennamen.Replace TenantHostName with your tenant name. Beispiel:Example:

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

Verwenden von Objekten im privaten UrsprungUsing assets in private origins

Für die Verwendung von Objekten in privater Herkunft ist keine zusätzliche Konfiguration erforderlich.No additional configuration is required to use assets in private origins. SharePoint Online automatisch URLs für Objekte in privater Herkunft umschreibt, sodass Anforderungen für diese Objekte immer vom CDN bedient werden.SharePoint Online automatically rewrites URLs for assets in private origins so requests for those assets will always be served from the CDN. Sie können keine URLs manuell für CDN-Objekte in privater Herkunft erstellen, da diese URLs Token enthalten, die von SharePoint Online automatisch generiert werden müssen, wenn das Objekt angefordert wird.You cannot manually build URLs to CDN assets in private origins because these URLs contain tokens that must be auto-generated by SharePoint Online at the time the asset is requested.

Der Zugriff auf Objekte im privaten Ursprung wird durch dynamisch generierte Token geschützt, die auf Benutzerberechtigungen für den Ursprung basieren, wobei die in den folgenden Abschnitten beschriebenen Einschränkungen beachtet werden.Access to assets in private origins is protected by dynamically generated tokens based on user permissions to the origin, with the caveats described in the following sections. Benutzer benötigen mindestens Lese Zugriff auf die Ursprünge des CDN zum Rendern von Inhalten.Users must have at least read access to the origins for the CDN to render content.

Das folgende Diagramm veranschaulicht den Workflow, wenn SharePoint eine Anforderung für eine Seite erhält, die Objekte aus einem privaten Ursprung enthält.The following diagram illustrates the workflow when SharePoint receives a request for a page containing assets from a private origin.

Workflow Diagramm: Abrufen von Office 365 CDN-Ressourcen aus einem privaten UrsprungWorkflow diagram: Retrieving Office 365 CDN assets from a private origin

Token-basierte Autorisierung in privater HerkunftToken-based authorization in private origins

Der Zugriff auf Objekte im privaten Ursprung im Office 365 CDN wird durch von SharePoint Online generierte Token gewährt.Access to assets in private origins in the Office 365 CDN is granted by tokens generated by SharePoint Online. Benutzer, die bereits über Berechtigungen für den Zugriff auf den vom Ursprung benannten Ordner oder die Bibliothek verfügen, erhalten automatisch Token, die dem Benutzer den Zugriff auf die Datei basierend auf Ihrer Berechtigungsstufe ermöglichen.Users who already have permission to access to the folder or library designated by the origin are automatically granted tokens that permit the user to access the file based on their permission level. Diese Zugriffstoken sind gültig für 30 bis 90 Minuten, nachdem Sie generiert wurden, um die Wiedergabe von Token zu schützen.These access tokens are valid for 30 to 90 minutes after they are generated to help prevent token replay attacks.

Nachdem das Zugriffstoken generiert wurde, gibt SharePoint Online einen benutzerdefinierten URI an den Client zurück, der zwei Autorisierungsparameter " Eat " (Edge Authorization Token) und OAT (Origin Authorization Token) enthält.Once the access token is generated, SharePoint Online returns a custom URI to the client containing two authorization parameters eat (edge authorization token) and oat (origin authorization token). Die Struktur der einzelnen Token ist < "Ablaufzeit im Epoch Time-Format" >__< "Secure Signature" >.The structure of each token is <'expiration time in Epoch time format'>__<'secure signature'>. Beispiel:For example:

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

Hinweis

Jeder, der das Token besitzt, kann auf die Ressource im CDN zugreifen.Anyone in possession of the token can access the resource in the CDN. URLs, die diese Zugriffstoken enthalten, werden jedoch nur über HTTPS freigegeben, sodass nicht autorisierte Benutzer auf das Objekt nicht zugreifen können, wenn die URL nicht explizit von einem Endbenutzer freigegeben wird, bevor das Token abläuft.However, URLs containing these access tokens are only shared over HTTPS, so unless the URL is explicitly shared by an end user before the token expires, the asset won't be accessible to unauthorized users.

Berechtigungen auf Elementebene werden für Objekte im privaten Ursprung nicht unterstützt.Item-level permissions are not supported for assets in private origins

Es ist wichtig zu beachten, dass SharePoint Online keine Berechtigungen auf Elementebene für Objekte in privater Herkunft unterstützt.It is important to note that SharePoint Online does not support item-level permissions for assets in private origins. Beispielsweise haben Benutzer bei einer Datei https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg , die sich unter den folgenden Bedingungen befindet, effektiven Zugriff auf die Datei:For example, for a file located at https://contoso.sharepoint.com/sites/site1/library1/folder1/image1.jpg, users have effective access to the file given the following conditions:

BenutzerUser BerechtigungenPermissions Effektiver ZugriffEffective access
Benutzer 1User 1 Zugriff auf Folder1Has access to folder1 Zugriff auf image1.jpg aus dem CDN möglichCan access image1.jpg from the CDN
Benutzer 2User 2 Kein Zugriff auf Folder1Does not have access to folder1 Zugriff auf image1.jpg aus dem CDN nicht möglichCannot access image1.jpg from the CDN
Benutzer 3User 3 Verfügt nicht über Zugriff auf Folder1, erhält jedoch explizite Berechtigungen für den Zugriff auf image1.jpg in SharePoint OnlineDoes not have access to folder1, but is granted explicit permission to access image1.jpg in SharePoint Online Kann direkt von SharePoint Online auf das Objekt image1.jpg zugreifen, jedoch nicht aus dem CDNCan access the asset image1.jpg directly from SharePoint Online, but not from the CDN
Benutzer 4User 4 Hat Zugriff auf Folder1, wurde jedoch explizit den Zugriff auf image1.jpg in SharePoint Online verweigert.Has access to folder1, but has been explicitly denied access to image1.jpg in SharePoint Online Der Zugriff auf das Objekt ist nicht von SharePoint Online möglich, kann jedoch aus dem CDN auf das Objekt zugreifen, obwohl der Zugriff auf die Datei in SharePoint Online verweigert wurde.Cannot access the asset from SharePoint Online, but can access the asset from the CDN despite being denied access to the file in SharePoint Online

Problembehandlung beim Office 365 CDNTroubleshooting the Office 365 CDN

Wie bestätige ich, dass Objekte vom CDN bereitgestellt werden?How do I confirm that assets are being served by the CDN?

Nachdem Sie einer Seite Links zu CDN-Objekten hinzugefügt haben, können Sie überprüfen, ob das Objekt vom CDN bedient wird, indem Sie zur Seite navigieren, mit der rechten Maustaste auf das Bild klicken, nachdem es gerendert und die Bild-URL überprüft hat.Once you have added links to CDN assets to a page, you can confirm that the asset is being served from the CDN by browsing to the page, right clicking on the image once it has rendered and reviewing the image URL.

Sie können auch die Entwicklertools Ihres Browsers verwenden, um die URL für jedes Objekt auf einer Seite anzuzeigen, oder verwenden Sie ein Netzwerk Ablaufverfolgungstool eines Drittanbieters.You can also use your browser's developer tools to view the URL for each asset on a page, or use a third party network trace tool.

Hinweis

Wenn Sie ein Netzwerktool wie Fiddler verwenden, um Ihre Objekte außerhalb des Renderings des Objekts von einer SharePoint-Seite zu testen, müssen Sie den Referer-Header "Referer: https://yourdomain.sharepoint.com " manuell zur Get-Anforderung hinzufügen, wobei die URL die Stamm-URL des SharePoint Online Mandanten ist.If you use a network tool such as Fiddler to test your assets outside of rendering the asset from a SharePoint page, you must manually add the referer header "Referer: https://yourdomain.sharepoint.com" to the GET request where the URL is the root URL of your SharePoint Online tenant.

Sie können CDN-URLs nicht direkt in einem Webbrowser testen, da ein Referer aus SharePoint Online stammen muss.You cannot test CDN URLs directly in a web browser because you must have a referer coming from SharePoint Online. Wenn Sie jedoch die CDN-Ressourcen-URL zu einer SharePoint-Seite hinzufügen und dann die Seite in einem Browser öffnen, wird das auf der Seite gerenderte CDN-Objekt angezeigt.However, if you add the CDN asset URL to a SharePoint page and then open the page in a browser, you will see the CDN asset rendered on the page.

Weitere Informationen zur Verwendung der Entwicklertools im Microsoft Edge-Browser finden Sie unter Microsoft Edge Developer Tools.For more information on using the developer tools in the Microsoft Edge browser, see Microsoft Edge Developer Tools.

Wenn Sie ein kurzes Video im YouTube-Kanal für SharePoint-Entwickler Muster und-Methoden sehen möchten, in dem gezeigt wird, wie Sie überprüfen können, ob Ihr CDN funktioniert, lesen Sie bitte Überprüfen der CDN-Nutzung und sicherstellen einer optimalen Netzwerkkonnektivität.To watch a short video hosted in the SharePoint Developer Patterns and Practices YouTube channel demonstrating how to verify that your CDN is working, please see Verifying your CDN usage and ensuring optimal network connectivity.

Warum sind Objekte aus einem neuen Ursprung nicht verfügbar?Why are assets from a new origin unavailable?

Objekte in neuem Ursprung stehen nicht sofort zur Verwendung zur Verfügung, da es Zeit dauert, bis sich die Registrierung über das CDN verbreitet und die Ressourcen vom Ursprung bis zum CDN-Speicher hochgeladen werden.Assets in new origins will not immediately be available for use, as it takes time for the registration to propagate through the CDN and for the assets to be uploaded from the origin to CDN storage. Die erforderliche Zeit für die Verfügbarkeit von Objekten im CDN hängt davon ab, wie viele Objekte und Dateigrößen verfügbar sind.The time required for assets to be available in the CDN depends on how many assets and the files sizes.

Mein clientseitiges Webpart oder SharePoint Framework-Lösung funktioniert nichtMy client-side web part or SharePoint Framework solution isn't working

Wenn Sie das Office 365 CDN für öffentliche Ursprünge aktivieren, erstellt der CDN-Dienst automatisch diese Standard Ursprünge:When you enable the Office 365 CDN for public origins, the CDN service automatically creates these default origins:

  • */MASTERPAGE*/MASTERPAGE
  • */Style-Bibliothek*/STYLE LIBRARY
  • */CLIENTSIDEASSETS*/CLIENTSIDEASSETS

Wenn der */clientsideassets-Ursprung fehlt, treten bei SharePoint-Framework-Lösungen Fehler auf, und es werden keine Warnungen oder Fehlermeldungen generiert.If the */clientsideassets origin is missing, SharePoint Framework solutions will fail, and no warning or error messages are generated. Dieser Ursprung fehlt möglicherweise, weil das CDN aktiviert wurde, wenn der Parameter -NoDefaultOrigins auf $truefestgelegt wurde oder der Ursprung manuell gelöscht wurde.This origin may be missing either because the CDN was enabled with the -NoDefaultOrigins parameter set to $true, or because the origin was manually deleted.

Sie können überprüfen, welche Ursprünge mit dem folgenden PowerShell-Befehl vorhanden sind:You can check to see which origins are present with the following PowerShell command:

Get-SPOTenantCdnOrigins -CdnType Public

Oder Sie können mit der Office 365 CLI überprüfen:Or you can check with the Office 365 CLI:

spo cdn origin list

So fügen Sie den Ursprung in PowerShell hinzu:To add the origin in PowerShell:

Add-SPOTenantCdnOrigin -CdnType Public -OriginUrl */CLIENTSIDEASSETS

So fügen Sie den Ursprung in der Office 365 CLI hinzu:To add the origin in the Office 365 CLI:

spo cdn origin add --origin */CLIENTSIDEASSETS

Welche PowerShell-Module und CLI-Shells muss ich mit dem Office 365 CDN verwenden?What PowerShell modules and CLI shells do I need to work with the Office 365 CDN?

Sie können mit dem Office 365 CDN entweder mithilfe des PowerShell-Moduls von SharePoint Online Verwaltungsshell oder der Office 365 CLIarbeiten.You can choose to work with the Office 365 CDN using either the SharePoint Online Management Shell PowerShell module or the Office 365 CLI.

Siehe auchSee also

Netzwerke für die InhaltsübermittlungContent Delivery Networks

Netzwerkplanung und Leistungsoptimierung für Office 365Network planning and performance tuning for Office 365

SharePoint-Leistungsreihe-Office 365 CDN-VideoreiheSharePoint Performance Series - Office 365 CDN video series