Arbeiten mit Websites in einer Multi-Geo-Umgebung
SharePoint-Websites können sich über die standardmäßigen geografischen Standorte und die Satellitenstandorte eines Multi-Geo-Mandanten erstrecken. Wenn Ihre benutzerdefinierte Lösung mit SharePoint-Websites arbeiten muss und wenn Sie Anwendungen bereitstellen, müssen Sie die geografischen Standorte in Ihrem Multi-Geo-Mandanten berücksichtigen.
Bereitstellen von Clientanwendungen für Multi-Geo-Mandanten
Wenn Sie Anwendungen bereitstellen, z. B. SharePoint-Add-Ins oder clientseitige SharePoint-Webparts, die auf dem SharePoint Framework basieren, müssen Sie berücksichtigen, dass Anwendungen auf der Ebene des geografischen Standorts bereitgestellt werden.
Wenn Sie eine Anwendung am standardmäßigen geografischen Standort bereitstellen, ist sie nicht an den Satellitenstandorten verfügbar. Weitere Informationen finden Sie unter Verwalten von Apps und Add-Ins in einem Multi-Geo-Mandanten.
Wir empfehlen, dass Sie Ihre Unternehmensanwendungen an allen Standorten bereitstellen. Dadurch wird sichergestellt, dass die Anwendung für alle Benutzer verfügbar ist.
Aufzählen von Websitesammlungen
Verwenden Sie zum Aufzählen aller Mandantenwebsitesammlungen die CSOM-Methode „GetSitePropertiesFromSharePointByFilters“ in einer Tenant-Objektinstanz. Da jeder geografische Standort über ein Mandanten-Admin Center verfügt, müssen Sie Websitesammlungen pro geografischem Standort aufzählen und die Ergebnisse verketten, um eine einzelne mandantenweite Liste von Websitesammlungen zu erhalten.
So führen Sie eine mandantenweite Aufzählung von Websites aus
- Suchen Sie alle geografischen Standorte und deren zugeordnete Mandantenadministrator-Website-URLs.
- Erstellen Sie eine Schleife, die die geografischen Standorte durchläuft, und ein
Tenant-Objekt mit der Administratorwebsite-URL des geografischen Standorts erstellt.- Verwenden Sie die
GetSitePropertiesFromSharePointByFilters-Methode Anruf imTenant-Objekt, um die Websitesammlungen für diesen geografischen Standort abzurufen. - Fügen Sie die Websitesammlungen an eine Liste an.
- Verwenden Sie die
- Geben Sie die Liste von Websitesammlungen zurück.
Weitere Informationen finden Sie im Beispiel MultiGeo.SiteEnumeration.
Weitere Informationen zu Berechtigungen und zum Konfigurieren Ihrer Anwendung finden Sie unter Einrichten einer Multi-Geo-Beispielanwendung.
Durchführen von Vorgängen auf Mandantenebene
Das Tenant-Objekt wird auch verwendet, um Einstellungen auf Mandantenebene zu konfigurieren, z. B. CDN-Einstellungen und Einstellungen auf Mandantenebene, z. B. die Einschränkung des geografischen Standorts. So führen Sie Vorgänge auf Mandantenebene durch
- Suchen Sie alle geografischen Standorte und deren zugeordnete Mandantenadministrator-Website-URLs.
- Zum Aktualisieren von Einstellungen auf Mandantenebene durchlaufen Sie die geografischen Standorte, und nehmen Sie die Änderung pro geografischem Standort vor.
- So aktualisieren Sie Websiteeinstellungen auf Mandantenebene
- Verwenden Sie die
GeoLocation-Eigenschaft desSite-Objekts, um den geografischen Standort der Website abzurufen. - Verwenden Sie die
GetSitePropertiesByUrl-Mandantenmethode, um die Website abzurufen, Änderungen vorzunehmen undUpdatefür das abgerufeneSiteProperties-Objekt aufzurufen.
- Verwenden Sie die
Weitere Informationen dazu, wie Sie mithilfe der GetSitePropertiesByUrl-Methode eine Website abrufen und dann verhindern, dass die Website verschoben wird, indem Sie die RestrictedToRegion-Eigenschaft festlegen, finden Sie im Beispiel MultiGeo.RestrictSiteToGeoLocation.
Identifizieren von Websites durch Speichern der Website-ID
In einem Multi-Geo-Mandanten können Websites zwischen geografischen Standorten verschoben werden, was bedeutet, dass die URL dieser Website geändert wird. Daher wird das Speicher der Website-URL als eindeutiger Schlüssel zur Identifizierung einer Website nicht empfohlen. Es ist besser, die Website-ID zu speichern, da diese sich nicht ändert, unabhängig vom geografischen Standort, an dem die Website gehostet wird.