Mandantschaften und Bereitstellungsbereiche von Add-Ins für SharePoint
Eine SharePoint-Mandanteneinheit ist ein Satz von Websitesammlungen entweder in einer SharePoint-Farm oder in SharePoint Online. In SharePoint Online gehören die Websitesammlungen zu einem einzelnen Kundenkonto. In einer SharePoint-Farm kann es sich bei den Websitesammlungen um alle Websitesammlungen in einer SharePoint-Webanwendung oder um eine Teilmenge davon handeln, oder es kann sich um einen Satz von Websitesammlungen über mehrere Webanwendungen in der Farm hinweg handeln. Eine Mandantschaft kann genau wie eine SharePoint-Webanwendung einen SharePoint-Add-In-Katalog aufweisen.
Mandantschaften und Add-In-Bereich
Ein SharePoint-Add-In weist einen Add-In-Bereich auf. Die zwei möglichen Add-In-Bereiche sind Webbereich und Mandantenbereich. Der Unterschied ist keine systeminterne Eigenschaft des Add-Ins, und Sie als Entwickler können den Bereich Ihres Add-Ins nicht festlegen. Die Entscheidung wird von Mandantenadministratoren als Nebeneffekt der Installationsart des Add-Ins getroffen.
Nachdem ein Add-In in den Add-In-Katalog einer Mandantschaft hochgeladen wurde, kann es sofort auf einzelnen Websites innerhalb der Mandantschaft installiert werden. Add-Ins, die auf diese Weise installiert werden, weisen einen Webbereich auf.
Mandantenadministratoren haben jedoch eine weitere Option. Sie können das Add-In im Batch in eine Untermenge von Websites innerhalb der Mandantschaft installieren. Add-Ins, die auf diese Weise installiert werden, weisen einen Mandantenbereich auf. Der Mandantenadministrator kann über eine Liste verwalteter Pfade, eine Liste von Websitevorlagen oder eine Liste von Websitesammlungen angeben, auf welchen Websites das Add-In installiert wird. Ein per Batch installiertes Add-In kann nur von einem Mandantenadministrator deinstalliert werden. Wenn der Mandantenadministrator das Add-In deinstalliert, wird es von allen Websites des Mandanten deinstalliert. Benutzer können ein per Batch installiertes Add-In nicht auf einzelnen Websites deinstallieren. Die gleichen Grundsätze gelten für das Aktualisieren eines im Batch installierten Add-Ins: Nur ein Mandantenadministrator kann das Add-In aktualisieren, und dieses wird auf jeder Website in der Mandantschaft, auf der es installiert ist, im Batch aktualisiert.
Bei der Batchinstallation eines Add-Ins, das ein Add-In-Web enthält, wird nur ein einzelnes Add-In-Web erstellt und von allen Hostwebsites verwendet, auf denen das Add-In installiert wird. Das Add-In-Web befindet sich in der Websitesammlung des Add-In-Katalogs des Unternehmens.
Wenn im Mandanten neue Websitesammlungen erstellt werden, werden Add-Ins, die zuvor per Batch installiert wurden, automatisch in der neuen Websitesammlung installiert.
Hinweis
Der Add-In-Bereich sollte nicht mit dem Featurebereich verwechselt werden. Der Featurebereich bestimmt, wo die Elemente in einem Feature bereitgestellt werden. Die Optionen beinhalten Farm, WebApplication, Site (d.h. Websitesammlung) und Web. Für Features in SharePoint-Add-Ins (sowohl Hostwebfeatures als auch Features innerhalb einer WSP-Datei in einem Add-In-Paket) ist nur Web zulässig.
Der Add-In-Bereich sollte außerdem nicht mit Add-In-Berechtigungsstufen verwechselt werden. SharePoint-Add-Ins können Berechtigungen für alle oder ausgewählte Teile von SharePoint-Inhalten auf der Listen-, Web-, Websitesammlungs- und Mandantenebene anfordern. Durch Installieren eines Add-Ins mit Mandantenbereich erhält das Add-In keine Berechtigungen, die es ansonsten nicht hätte, und es werden auch keine wichtigen Bereitstellungen des SharePoint-Sicherheitsmodells abgebrochen. Weitere Informationen über Add-In-Berechtigungen finden Sie unter Add-In-Berechtigungen in SharePoint.
Einschränkungen für Add-Ins mit Mandantenbereich
Die folgenden Typen von Add-Ins funktionieren bei Batchinstallation nicht ordnungsgemäß:
- Add-Ins, die eine benutzerdefinierte Aktion für das Menüband enthalten. (Als Menüelemente bereitgestellte benutzerdefinierte Aktionen sind zulässig.)
- Add-Ins, die ein Add-In-Webpart enthalten.
Denken Sie außerdem daran, dass die Installation mit Mandantenbereich in der Office 365 Small Business Premium-Version von SharePoint Online nicht möglich ist.
Installieren, Deinstallieren und Aktualisieren eines Add-Ins auf mehreren Websites eines Mandanten
Add-Ins aus dem Office Store oder aus einem Add-In-Katalog können von Mandantenadministratoren mit dem folgenden Verfahren auf mehreren Websites eines Mandanten installiert, deinstalliert und aktualisiert werden.
So installieren Sie ein SharePoint-Add-In auf mehreren Websites
Gehen Sie zur Seite Websiteinhalte der Website für den Unternehmenskatalog.
Wählen Sie Add-In hinzufügen aus, und installieren Sie das Add-In so, wie Sie bei jeder anderen SharePoint-Website vorgehen würden.
Nachdem das Add-In installiert wurde, zeigen Sie auf der Seite Websiteinhalte auf den Link zu dem Add-In. Ein „...“-Link wird angezeigt.
Wählen Sie den Link aus. Ein Popup wird angezeigt.
Wählen Sie im Menü den Befehl Bereitstellung aus.
Verwenden Sie die daraufhin geöffnete Bereitstellungsbenutzeroberfläche, um die Websitesammlungen anzugeben, in denen das Add-In installiert werden soll. Sie können nach verwalteten Pfaden, Websitevorlagen oder URLs filtern. Die Filter verfügen über eine logische "OR"-Beziehung: Das Add-In wird in der Vereinigung aller Websitesammlungen installiert, die einen oder mehrere der Filter übergeben.
Wählen Sie OK aus.
So deinstallieren Sie ein per Batch installiertes SharePoint-Add-In
Gehen Sie zur Seite Websiteinhalte der Website für den Unternehmenskatalog.
Zeigen Sie auf der Seite Websiteinhalte auf den Link zu dem Add-In. Ein „...“-Link wird angezeigt.
Wählen Sie den Link aus. Ein Popup wird angezeigt.
Wählen Sie im Popup Entfernen aus.
So aktualisieren Sie ein per Batch installiertes SharePoint-Add-In
Gehen Sie zur Seite Websiteinhalte der Website für den Unternehmenskatalog. Wenn ein Update für ein Add-In verfügbar ist, wird neben dem Add-In eine Meldung angezeigt. Es gibt einen Link zum Aktualisieren des Add-Ins.
Klicken Sie auf den Link, um das Add-In zu aktualisieren.
Wenn Sie zur Genehmigung der Berechtigungsanforderungen des Add-Ins aufgefordert werden, wählen Sie Vertrauen aus.