Freigeben über


Framework für die PnP-Bereitstellung

Das Framework für die PnP-Bereitstellung bietet eine auf Code zentrierte und vorlagenbasierte Plattform zur Bereitstellung Ihrer Websitesammlungen. Bei dem neuen Bereitstellungsmodul können Sie Bereitstellungsmodelle in Office 365 und SharePoint Online sowie in lokalen Websitesammlungen beibehalten und wiederverwenden.

Hinweis

Das PnP-Bereitstellungsframework & PnP-Bereitstellungsmodul sind Open-Source-Lösungen mit aktiver Community, die unterstützung dafür bereitstellt. Es gibt keine SLA den Support für das Open-Source-Tool vom Microsoft.

Warum der neue Ansatz?

Microsoft hat sich mit der Einführung von SharePoint-Add-Ins und des Add-In-Modells (vormals als „App-Model“ bezeichnet) von Sandkasten- und voll vertrauenswürdigen Lösungen weg bewegt und setzt nun auf vom Anbieter gehostete Add-Ins und lokale Lösungen. Diese Innovationen haben zu einer Umrüstung des Bereitstellungsmodells und zur Einführung eines neuen Bereitstellungsmoduls geführt.

Vorteile des neuen Bereitstellungsmodells

Die Verwendung dieses Ansatzes hat im Vergleich zu Sandkasten- und voll vertrauenswürdigen Lösungen zahlreiche Vorteile. Mit dem neuen Bereitstellungsmodells können Sie:

  • Vorlagen anpassen. Da Websitesammlungen immer mit einer einsatzbereiten Vorlage beginnen, enthalten die Anpassungen, die Sie mithilfe des neuen Remotebereitstellungsmodells einführen, automatische Updates, ohne dass hierfür weitere Wartungsarbeiten von Ihnen ausgeführt werden müssen. Darüber hinaus vermeidet dieser Ansatz Probleme, die entstehen, wenn verschiedene Vorlagen in unterschiedlichen Websitesammlungen verwendet werden.

  • Ein vorlagenbasiertes Modell verwenden. Bietet ein einfaches, vorlagenbasiertes Bereitstellungsmodell, mit dem Sie ein vorhandenes Websitedesign als Bereitstellungsvorlage speichern können.

  • Vorlagen mit unterschiedlichen Ansätze definieren. Alternativ können Sie Ihre Vorlage manuell in XML definieren, das anhand des PnP-Bereitstellungsschemas überprüft wird, oder Sie können Ihre Vorlage mithilfe von verwaltetem Code definieren, um eine Objekthierarchie zu erstellen. Sie können die Ansätze auch kombinieren.

  • Vorlagen serialisieren und wiederverwenden. Sie können Ihre Bereitstellungsvorlagen serialisieren und wiederverwenden.

  • Vorlagen im serialisierten Format speichern. Sie können Bereitstellungsvorlagen in einem beliebigen Serialisierungsformat speichern, das am besten für Sie geeignet ist, z. B. XML oder JSON.

  • Neue Websitesammlungen hinzufügen. Sie können neue Websitesammlungen ganz einfach durch Anwenden der Bereitstellungsvorlage auf eine Zielwebsite in einem beliebigen serialisierten Format bereitstellen, das Sie auswählen.

  • In das clientseitige Objektmodell integrieren. Die Integration des clientseitigen Objektmodells (CSOM) bietet Ihnen eine enorme Flexibilität, da eine automatisierte, codebasierte Bereitstellung ermöglicht wird. Sie können eine neue Websitesammlung mit Ihrer Bereitstellungsvorlage bereitstellen, indem Sie entweder CSOM-/REST-Code oder Windows-PowerShell-Skripts verwenden.

  • Die Delta-Bereitstellung verwenden. Sie können Bereitstellungsvorlagen zusätzlich zu vorhandenen Websites anwenden. Das Bereitstellungsmodul unterstützt die Delta-Bereitstellung und fügt daher Websites basierend auf einem beliebigen Umfang, der in der Vorlagendefinition bereitgestellt wird, hinzu bzw. aktualisiert diese.

  • Das PnP-Bereitstellungsmodul erweitern. Sie können das Bereitstellungsmodul ganz einfach durch Verwendung von benutzerdefinierten Erweiterbarkeitsanbietern erweitern, mit denen Sie benutzerdefinierte Logik ausführen können, die Sie mithilfe von verwaltetem CSOM-/REST-Code geschrieben haben.

  • Über lokale und Office 365-Bereitstellungen hinweg arbeiten. Das Bereitstellungsmodul ermöglicht jetzt das nahtlose Arbeiten sowohl in lokalen als auch in Office 365-Bereitstellungen. Dies ist eine Verbesserung gegenüber früherer Bereitstellungstechniken, bei denen benutzerdefinierte Websitedefinitionen in Office 365 nicht unterstützt wurden, da sie auf Farmen begrenzte Bereitstellungen erforderten.

Remotebereitstellung kurz zusammengefasst

In diesem Abschnitt behandeln wir die einzelnen Teile der Remotebereitstellung tiefgründiger. Es kann aber hilfreich sein, sich erst das große Ganze anzuschauen und die Remotebereitstellung in ihrer einfachsten Form zu begreifen. Aus dieser Perspektive umfasst die Remotebereitstellung nur drei Elemente:

  1. Entwerfen und Erstellen Ihrer Websiteanpassung.

  2. Erstellen und optionales Speichern der Bereitstellungsvorlage in einem von Ihnen ausgewählten serialisierten Format.

  3. Anwenden der Bereitstellungsvorlage auf eine neue oder vorhandene Websitesammlung, die mithilfe einer einsatzbereiten Websitevorlage erstellt wurde.

1. Entwerfen und Erstellen Ihrer Websiteanpassung

Der erste Schritte besteht darin, die Websiteanpassungen zu erstellen, die Sie speichern möchten, und diese dann auf eine Websitesammlung anzuwenden. Sie können auf verschiedene Weisen vorgehen.

Die einfachste Möglichkeit besteht darin, die gewünschten Änderungen an einer vorhandenen Websiteseite vorzunehmen und diese Seite dann als Bereitstellungsvorlage zu speichern. Weitere Informationen finden Sie unter PnP-Bereitstellungsvorlagen.

Sie können Ihre Bereitstellungsvorlage auch manuell als XML-Datei oder mithilfe von verwaltetem Code (CSOM/REST) erstellen, um eine Hierarchie von Objekten zu erstellen, um Websiteartefakte und Strukturen darzustellen. Wenn Sie eine Schemadatei erstellen, müssen Sie die Datei anhand des XSD-Bereitstellungsschemas überprüfen (siehe PnP-Bereitstellungsschema).

Weitere Informationen zum Modellieren Ihrer Website finden Sie im Artikel PnP-Bereitstellungsmodul und die Kernbibliothek.

2. Erstellen und Speichern der Bereitstellungsvorlage in einem serialisierten Format

Exportieren Sie Ihr angepasstes Websitemodell in Ihr bevorzugtes serialisiertes Format; das Bereitstellungsmodul ist in Bezug auf das Speicherformat agnostisch. Diese gespeicherte Instanz der Anpassung ist die Bereitstellungsvorlage, die Sie dann mit minimalem Aufwand auf neue Websitesammlungen anwenden können.

Beachten Sie, dass das Serialisieren und Speichern Ihrer Vorlage ein optionaler Schritt ist, der nur erforderlich ist, wenn Sie die Vorlage speichern möchten. Es ist nicht erforderlich, die Vorlage zu serialisieren, um die Vorlage auf eine neue Websitesammlung anzuwenden.

3. Anwenden der Bereitstellungsvorlage auf eine Websitesammlung

Sie können entweder ein Windows-PowerShell-Skript oder CSOM-/REST-Code verwenden, um die Bereitstellungsvorlage auf neue oder vorhandene Websitesammlungen anzuwenden. Sie können auch eine ganze Websitesammlung oder nur einen Teil davon bereitstellen.

Ein Beispiel der Remotebereitstellung in Aktion, einschließlich Serialisierung der Bereitstellungsvorlage in XML, finden Sie unter Beispiel für die Bereitstellung einer Konsolenanwendung.

Siehe auch