Verwenden des Websitesammlungs-App-KatalogsUse the site collection app catalog

Gilt für: Office 365Applies to: Office 365

Durch Verwendung von Websitesammlungs-App-Katalogs können SharePoint-Mandantenadministratoren die Verwaltung und den Bereich der Bereitstellung von SharePoint-Add-Ins und SharePoint Framework-Lösungen auf bestimmten Websites dezentralisieren.Using site collection app catalogs, SharePoint tenant administrators can decentralize the management and scope the deployment of SharePoint add-ins and SharePoint Framework solutions to specific sites.

Vorteile von Websitesammlungs-App-KatalogenWhy site collection app catalogs

Bisher mussten alle Add-Ins und SharePoint Framework-Lösungen zentral im Mandanten-App-Katalog verwaltet werden.Previously, all add-ins and SharePoint Framework solutions had to be managed centrally in the tenant app catalog. Mandantenadministratoren konnten zwar den Zugriff für andere Personen im Unternehmen delegieren, in allen Websitesammlungen war jedoch ein bereitgestelltes Paket zu sehen.While tenant administrators could delegate the access to other people in the organization, a deployed package was visible on all site collections. SharePoint umfasste keine unterstützte Möglichkeit zum Bereitstellen von Add-Ins und SharePoint Framework-Lösungen nur auf bestimmten Websites.SharePoint offered no supported way of deploying add-ins and SharePoint Framework solutions only to specific sites.

Mit der Einführung von Websitesammlungs-App-Katalogen können Mandantenadministratoren den App-Katalog auf bestimmten Websites aktivieren.With the introduction of site collection app catalogs, tenant administrators can enable app catalog on the specific sites. Nach der Aktivierung können Websitesammlungsadministratoren SharePoint-Add-Ins und SharePoint Framework-Lösungen bereitstellen, die nur in dieser Websitesammlung verfügbar sind.Once enabled, site collection administrators can deploy SharePoint add-ins and SharePoint Framework solutions that will be available only in that particular site collection.

Im folgenden Schema ist die Verwendung von Websitesammlungs-App-Katalogen dargestellt:The following schema illustrates using site collection app catalogs:

Diagramm, in dem das Konzept des Websitesammlungs-App-Katalogs veranschaulicht wird

In Ihrem Office 365-Mandanten haben Sie einen Mandanten-App-Katalog.In your Office 365 tenant you have a tenant app catalog. Lösungen, die in diesem App-Katalog bereitgestellt werden, können in einer beliebigen Websitesammlung im Mandanten installiert werden.Solutions deployed to this app catalog, can be installed in any site collection in the tenant. Mandantenadministratoren können Websitesammlungs-App-Kataloge in bestimmten Websitesammlungen aktivieren.Tenant administrators can choose to enable site collection app catalogs on specific site collections. Lösungen, die in den Websitesammlungs-App-Katalogen bereitgestellt werden, können nur in dieser bestimmten Websitesammlung installiert werden.Solutions deployed to the site collection app catalogs can only be installed in that particular site collection.

Unterstützte FunktionenSupported capabilities

Unterstützung für SharePoint-Add-Ins und SharePoint Framework-PaketeSupport for both SharePoint add-ins and SharePoint Framework packages

In Websitesammlungs-App-Katalogen können Sie, genau wie im Mandanten-App-Katalog, sowohl SharePoint-Add-Ins als auch SharePoint Framework-Lösungen (SSPKG) bereitstellen.In site collection app catalogs, just as in tenant app catalog, you can deploy both SharePoint add-ins and SharePoint Framework solutions (.sppkg).

Einschließen von Ressourcen in LösungspaketeIncluding assets in solution packages

SharePoint Framework-Lösungspakete, die Ressourcen enthalten, können in Websitesammlungs-App-Katalogen bereitgestellt werden.SharePoint Framework solution packages that contain assets, can be deployed to site collection app catalogs. Eingeschlossene Ressourcen werden in einer vorkonfigurierten Dokumentbibliothek in derselben Websitesammlung bereitgestellt, in der sich auch der Websitesammlungs-App-Katalog befindet.Included assets will be deployed to a preconfigured document library in the same site collection as where the site collection app catalog is located. Wenn das öffentliche Office 365 CDN konfiguriert ist, werden Ressourcen vom CDN bedient.If the Office 365 Public CDN is configured, assets will be served from the CDN. Andernfalls werden Ressourcen direkt von der Dokumentbibliothek bedient.Otherwise, assets will be served directly from the document library.

Mandantenweite BereitstellungTenant-scoped deployment

Bei der Bereitstellung von SharePoint Framework-Lösungen, die die mandantenweite Bereitstellung in einem Websitesammlungs-App-Katalog unterstützen, werden Sie gefragt, ob Sie diese Lösung auf allen Websites in der Organisation verfügbar machen möchten.When deploying SharePoint Framework solutions that support tenant-wide deployment to a site collection app catalog, you will be prompted if you want to make this solution available to all sites in the organization. Wenn Sie dieses Kontrollkästchen aktivieren, wird die Lösung trotz dieser Formulierung sofort nur in derselben Websitesammlung verfügbar gemacht, in der sich auch der App-Katalog befindet.Despite the wording, if you check this box, the solution will be available immediately only in the same site collection as where the app catalog is. Andere Websitesammlungen in Ihren Organisationen können die Lösung nicht verwenden.Other site collections in your organizations will not be able to use the solution. Wenn Sie diese Option nicht aktivieren, müssen Sie die Lösung auf Ihrer Website explizit installieren, bevor Sie diese verwenden können.If you don't check this option, you will have to explicitly install the solution in your site, before you will be able to use it.

Aktuelle EinschränkungenCurrent limitations

Konfigurieren und Verwalten von Websitesammlungs-App-KatalogenConfigure and manage site collection app catalogs

Sie können Websitesammlungs-App-Kataloge mithilfe der SharePoint Online-Verwaltungsshell konfigurieren und verwalten.You can configure and manage site collection app catalogs using the SharePoint Online Management Shell.

Hinweis

Bevor Sie Websitesammlungs-App-Kataloge in Ihrem Mandanten verwalten können, müssen Sie sicherstellen, dass Sie die SharePoint Online-Verwaltungsshell vom November 2017 oder eine höhere Version verwenden.Before you can manage site collection app catalogs in your tenant, ensure that you have installed SharePoint Online Management Shell from November 2017 or newer.

Alternativ können Sie die CLI für Microsoft 365 zum Verwalten Ihrer SharePoint-App-Kataloge verwenden.Alternatively, you can use the CLI for Microsoft 365 to manage your SharePoint site collection app catalogs. Die CLI für Microsoft 365 ist eine plattformübergreifende Befehlszeilenschnittstelle, die auf einer beliebigen Plattform verwendet werden kann, darunter Windows, Mac OS und Linux.The CLI for Microsoft 365 is a cross-platform command line interface that can be used on any platform, including Windows, MacOS and Linux. Die Verwendung von PNP PowerShell zum Erstellen des App-Katalogs oder zum Entfernen des App-Katalogs ist auch bei Verwendung von Windows möglich.Using PnP PowerShell to create the app catalog or remove the app catalog is also an option when using Windows.

Hinweis

PnP PowerShell ist eine Open Source-Lösung mit aktiver Community, die Support dafür bietet.PnP PowerShell is an open-source solution with active community providing support for it. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.There is no SLA for the open-source tool support from Microsoft.

Hinweis

Die CLI für Microsoft 365 ist eine Open-Source-Lösung mit aktiver Community, die Support dafür bietet.The CLI for Microsoft 365 is an open-source solution with active community providing support for it. Es gibt keine SLA für den Support des Open-Source-Tools durch Microsoft.There is no SLA for the open-source tool support from Microsoft.

Erstellen eines Websitesammlungs-App-KatalogsCreate a site collection app catalog

Hinweis

Bevor Sie das folgende Skript ausführen, stellen Sie eine Verbindung zu Ihrem SharePoint Online-Mandanten mithilfe des Connect-SPOService-Cmdlets her, wenn Sie SharePoint Online PowerShell verwenden.Before running the following script, connect to your SharePoint Online tenant using the Connect-SPOService cmdlet when using the SharePoint Online PowerShell. Stellen Sie außerdem sicher, dass Sie einen Mandanten-App-Katalog in Ihrem-Mandanten erstellt haben (Multi-Geo-Kunden müssen einen Mandanten-App-Katalog für jeden Geo erstellen, den Sie als Websitesammlungs-App-Katalog verwenden möchten).Also ensure that you have a tenant app catalog created in your tenant (Multi-geo customers will need to create a tenant app catalog for each geo they wish to use a site collection app catalog). Wenn Sie dies nicht tun, schlägt das Cmdlet mit dem folgenden Fehler fehl:If you don't, the cmdlet will fail with the following error:

Cannot invoke method or retrieve property from null object. Object returned by the
following call stack is null. "TenantAppCatalog
RootWeb
GetSiteByUrl
new Microsoft.Online.SharePoint.TenantAdministration.Tenant()
"

Alternativ, wenn Sie die CLI für Microsoft 365 verwenden, müssen Sie die Verbindung mit Ihrem Microsoft 365-Mandanten über den Befehl m365 login zuerst herstellen.Alternatively, if you are using the CLI for Microsoft 365, you must first connect to your Microsoft 365 tenant using the m365 login command. Mit PNP PowerShell richten Sie die Verbindung mit Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin ein.With PnP PowerShell you would use Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin to set up the connection.

Achtung

Das Konto, das zum Erstellen einer App-Katalog-Websitesammlung verwendet wird, muss Websitesammlungs-Administratoren sowohl im App-Katalog der Mandantenebene als auch in der Zielwebsitesammlung sein.Account used to create App Catalog Site Collection, must be Site Collection Administrators on both the tenant-level App Catalog and the target Site Collection

Zum Erstellen eines Websitesammlungs-App-Katalogs verwenden Sie das Add-SPOSiteCollectionAppCatalog-Cmdlet, das die Websitesammlung übergibt, wobei der App-Katalog als der -Site-Parameter erstellt werden sollte.To create a site collection app catalog, use the Add-SPOSiteCollectionAppCatalog cmdlet passing the site collection where the app catalog should be created as the -Site parameter.

Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Alternativ können Sie die PNP PowerShell verwenden, um Ihrer Website die App-Katalogfunktionen hinzuzufügen, nachdem Sie eine Verbindung mit der SharePoint Online-Administratorwebsite hergestellt haben:Alternatively, use PnP PowerShell to add the site app catalog functionality to your site after having connected to the SharePoint Online Admin site:

Add-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Verwenden Sie alternativ den Befehl spo site appcatalog add, wenn Sie die CLI für Microsoft 365 verwenden:Alternatively, use the spo site appcatalog add command if you are using the CLI for Microsoft 365:

spo site appcatalog add --url https://contoso.sharepoint.com/sites/marketing

Nach dem Ausführen dieses Skripts, wird die Apps für SharePoint-Bibliothek zu Ihrer Websitesammlung hinzugefügt, wo Sie SharePoint-Add-Ins und SharePoint Framework-Lösungen bereitstellen können.After executing this script, the Apps for SharePoint library will be added to your site collection where you will be able to deploy SharePoint add-ins and SharePoint Framework solutions.

Deaktivieren des Websitesammlungs-App-KatalogsDisable the site collection app catalog

Hinweis

Bevor Sie das folgende Skript ausführen, stellen Sie eine Verbindung zu Ihrem SharePoint Online-Mandanten mithilfe des Connect-SPOService-Cmdlets her, wenn Sie die SharePoint Online PowerShell verwenden, oder mithilfe des Befehls Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin, wenn Sie die PnP PowerShell verwenden, oder mithilfe des Befehls m365 loginfür CLI für Microsoft 365, um eine Verbindung mit Ihrem 365-Mandanten herzustellen.Before running the following script, connect to your SharePoint Online tenant using the Connect-SPOService cmdlet for the SharePoint Online PowerShell, Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin for PnP PowerShell or m365 login command for the CLI for Microsoft 365 to connect to your Microsoft 365 tenant.

Zum Deaktivieren des Websitesammlungs-App-Katalogs in Ihrer Websitesammlung verwenden Sie das Remove-SPOSiteCollectionAppCatalog-Cmdlet, das die Websitesammlung übergibt, wobei der App-Katalog als der -Site-Parameter deaktiviert werden sollte.To disable the site collection app catalog in your site collection, use the Remove-SPOSiteCollectionAppCatalog cmdlet passing the site collection where the app catalog should be disabled as the -Site parameter. Wenn Sie über die ID Ihrer Websitesammlung verfügen, können Sie alternativ das Remove-SPOSiteCollectionAppCatalogById-Cmdlet verwenden.Alternatively, if you have your site collection's ID, you can use the Remove-SPOSiteCollectionAppCatalogById cmdlet instead.

Hinweis

Trotz des Namens entfernen die Cmdlets Remove-SPOSiteCollectionAppCatalog und Remove-SPOSiteCollectionAppCatalogById den Websitesammlungs-App-Katalog nicht aus der Websitesammlung.Despite the naming, the Remove-SPOSiteCollectionAppCatalog and Remove-SPOSiteCollectionAppCatalogById cmdlets don't remove the site collection app catalog from the site collection. Sie deaktivieren diesen vielmehr, sodass Sie keine Lösungen darin bereitstellen oder darin bereitgestellte Lösungen verwenden können.Instead, they disable it so that it's not possible to deploy or use any solutions deployed in it.

Remove-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Alternativ können Sie die PNP PowerShell verwenden, um die App-Katalogfunktionen von Ihrer Website zu entfernen, nachdem Sie eine Verbindung mit der SharePoint Online-Administratorwebsite hergestellt haben:Alternatively, use PnP PowerShell to remove the site app catalog functionality from your site after having connected to the SharePoint Online Admin site:

Remove-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Verwenden Sie alternativ den Befehl spo site appcatalog remove, wenn Sie die CLI für Microsoft 365 verwenden.Alternatively, use the spo site appcatalog remove command if you are using the CLI for Microsoft 365

spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing

Nach dem Ausführen dieses Skript ist die Apps für SharePoint-Bibliothek immer noch in Ihrer Websitesammlung sichtbar, Sie können jedoch keine Lösungen darin bereitstellen oder darin bereitgestellte Lösungen verwenden.After executing this script, the Apps for SharePoint library will be still visible in your site collection, but you will not be able to deploy or use any solutions deployed in it.

Screenshot, der zeigt, wie das Hinzufügen neuer Apps nach dem Entfernen des App-Katalogs nicht möglich ist

ÜberlegungenConsiderations

GovernanceGovernance

Um alle Websitesammlungen in dem Mandanten aufzuführen, der den Websitesammlungs-App-Katalog aktiviert hat, verwenden Sie die URL https://<tenant-app-catalog-URL>/Lists/SiteCollectionAppCatalogs/AllItems.aspx.To list all site collections in the tenant that have the site collection app catalog enabled, use the URL https://<tenant-app-catalog-URL>/Lists/SiteCollectionAppCatalogs/AllItems.aspx.

SicherheitSecurity

Vor dem Bereitstellen von Lösungen in Websitesammlungs-App-Katalogen sollten Websitesammlungsadministratoren überprüfen, dass diese Lösungen den Organisationsrichtlinien entsprechen.Before deploying solutions to site collection app catalogs, site collection administrators should verify that these solutions meet organizational policies. Lösungen, die in Websitesammlungs-App-Katalogen installiert sind, können zwar nur in diesen bestimmten Websitesammlungen verwendet werden, sie können jedoch möglicherweise auf Ressourcen von anderen Websites in dem Mandanten zugreifen, Administratoren sollten daher sicherstellen, dass die Lösungen, die sie bereitstellen, wie beabsichtigt funktionieren.Although solutions installed in site collection app catalogs can only be used in these particular site collections, they can potentially access resources from other sites in the tenant so administrators should ensure that the solutions they are about to deploy work as intended.

Siehe auchSee also