Erstellen und Konfigurieren eines Containertyps

Gilt für: Entwickler

Erstellen Sie einen SharePoint Embedded-Containertyp für Ihre Anwendung, um Container zu erstellen oder Dateien zu speichern. Ein Containertyp definiert den Zugriff, die Abrechnung und ausgewählte Verhaltensweisen für Container, die von Ihrer App erstellt wurden.

Wenn Sie gerade erst beginnen, schließen Sie Schnellstart: Erstellen Ihrer ersten App mit VS Code ab. Verwenden Sie diesen Artikel dann für Test-, Standard- und Passthrough-Entscheidungen.

Informationen dazu, wie Sie zuerst zwischen einem und mehrinstanzenfähigen Modellen entscheiden können, finden Sie unter Auswählen eines App-Modells.

Grundlegendes zur Containertypbeziehung

Ein Containertyp ist stark mit einer Microsoft Entra ID Anwendung gekoppelt, die als besitzereigene Anwendung bezeichnet wird.

SharePoint Embedded erfordert eine 1:1-Beziehung zwischen einer eigenen Anwendung und einem Containertyp.

Die Containertyp-ID wird in jedem Container als unveränderliche Eigenschaft gespeichert.

Die ID wird für die Zugriffsautorisierung, Testuntersuchung, Abrechnung und konfigurierbare Verhaltensweisen verwendet.

Hinweis

Der Microsoft Graph-API – Create fileStorageContainerType – ist nur delegiert und kann von jedem Benutzer aufgerufen werden, der nicht gasteigene Mandantenbenutzer ist. Der Aufrufer benötigt keine Administratorrolle und wird automatisch als Besitzer des neuen Containertyps zugewiesen.

Wählen Sie Testversion oder Produktion aus.

Wählen Sie den Zweck des Containertyps aus, wenn Sie ihn erstellen.

Sie können einen Testcontainertyp später nicht in die Produktion konvertieren.

Sie können einen Standardabrechnungstyp später nicht in eine Passthrough-Abrechnung konvertieren.

Anwendungsfall	Containertyp
Lokaler Proof of Concept	Testcontainertyp
App-Besitzer zahlt	Standard Containertyps mit Abrechnungsprofil
Kundenmandant zahlt	Standard Containertyps mit Passthrough-Abrechnung

Wichtig

Wenn Sie den falschen Zweck oder das falsche Abrechnungsmodell auswählen, müssen Sie den Containertyp neu erstellen.

Voraussetzungen

Stellen Sie vor dem Erstellen eines Containertyps folgendes sicher:

• Ein Microsoft 365-Mandant mit SharePoint verfügbar.
• Eine Microsoft Entra ID App-Registrierung für die besitzende App.
• Ein Nicht-Gastmitgliedskonto im besitzenden Mandanten.
• Bei der Standardabrechnung wird ein Azure Abonnement und Ressourcengruppe verwendet.
• Für die Standardabrechnungseinrichtung können Besitzer- oder Mitwirkender-Berechtigungen für das Azure-Abonnement verwendet werden.

Hinweis

• Zum Erstellen eines Containertyps über Microsoft Graph ist nur die FileStorageContainerType.Manage.All delegierte Berechtigung erforderlich. Jeder Nicht-Gastbenutzer im besitzenden Mandanten kann einen erstellen und wird automatisch als Besitzer dieses Containertyps zugewiesen. Informationen zu mandantenweiten Administrativen Vorgängen finden Sie unter Erstellen von Apps mit PowerShell.

• Benutzer, die sich bei Containern authentifizieren, müssen in Microsoft Entra ID als Mitglieder oder Gäste vorhanden sein. Für die Zusammenarbeit an Office-Dokumenten, die in einem Container gespeichert sind, ist keine Office-Lizenz erforderlich, mit Ausnahme dokumentierter außergewöhnlicher Erfahrungen wie Erwähnungen.

Erstellen eines Testcontainertyps

Verwenden Sie einen Testcontainertyp für die Auswertung.

Sie können eine mit der SharePoint Embedded Visual Studio Code-Erweiterung oder Microsoft Graph erstellen.

Der Visual Studio Code-Pfad ist für eine erste App am schnellsten. Weitere Informationen finden Sie unter Schnellstart: Erstellen Ihrer ersten App mit VS Code.

Erstellen Sie für Microsoft Graph den Containertyp mit der trial Abrechnungsklassifizierung.

Die folgenden Einschränkungen gelten für Testcontainertypen:

• Der Mandant kann über bis zu fünf Container des Containertyps verfügen. Dies schließt aktive Container und container im Papierkorb ein.
• Jeder Container verfügt über bis zu 1 GB Speicherplatz.
• Der Containertyp läuft nach 30 Tagen ab, und der Zugriff auf alle vorhandenen Container dieses Containertyps wird dann entfernt.
• Der Entwickler muss alle Container eines vorhandenen Containertyps in der Testversion dauerhaft löschen status, um einen neuen Containertyp für die Testversion zu erstellen. Dies schließt Container in der gelöschten Containersammlung ein.
• Der Containertyp ist auf die Verwendung im Entwicklermandanten beschränkt. Es kann nicht in anderen nutzenden Mandanten bereitgestellt werden.

Erstellen eines Standardcontainertyps mit App-Besitzerabrechnung

Verwenden Sie die Standardabrechnung, wenn der Entwickler- oder App-Besitzermandant für den Verbrauch bezahlt.

Jeder Mandant kann bis zu 25 Standardcontainertypen gleichzeitig aufweisen.

1. Erstellen oder identifizieren Sie die besitzende Microsoft Entra ID Anwendung.
2. Erstellen Sie den Containertyp mit der standard Abrechnungsklassifizierung.
3. Fügen Sie ein Azure Abrechnungsprofil mit der SharePoint Embedded Visual Studio Code-Erweiterung oder einem vom Administrator verwalteten Abrechnungsablauf an.
4. Notieren Sie sich die Containertyp-ID.
5. Fahren Sie mit der Registrierung im nutzenden Mandanten fort.

Hinweis

Wenn die Abrechnungseinrichtung mit SubscriptionNotRegisteredfehlschlägt, warten Sie einige Minuten, und wiederholen Sie den Vorgang. Die Microsoft.Syntex Registrierung des Ressourcenanbieters kann einige Zeit in Anspruch nehmen.

Erstellen eines Passthrough-Abrechnungscontainertyps

Verwenden Sie die Passthrough-Abrechnung, wenn der verbrauchende Mandant für den Verbrauch bezahlt.

1. Erstellen oder identifizieren Sie die besitzende Microsoft Entra ID Anwendung.
2. Erstellen Sie den Containertyp mit der directToCustomer Abrechnungsklassifizierung.
3. Registrieren Sie den Containertyp im verbrauchenden Mandanten.
4. Bitten Sie den Mandantenadministrator, dienste mit nutzungsbasierter Bezahlung zu aktivieren.

Wichtig

Der nutzende Mandant muss die Abrechnungseinrichtung abschließen, bevor eine Passthrough-Anwendung erfolgreich verwendet werden kann.

Der nutzende Mandantenadministrator aktiviert dienste mit nutzungsbasierter Bezahlung im Microsoft 365 Admin Center. Wählen Sie unterAbrechnung und Lizenzeneinrichten> die Option Dienste mit nutzungsbasierter Bezahlung aktivieren aus.

Wählen Sie unter Syntex-Dienste fürdie Option Apps und dann SharePoint Embedded aus, um die Abrechnung für die App zu aktivieren.

Konfigurieren der besitzenden Entra-App

Konfigurieren Sie die App so, dass sie genau einen Containertyp besitzen kann.

Anfordern von Microsoft Graph-Berechtigungen für Den SharePoint Embedded-Zugriff.

Fordern Sie die Microsoft Graph-Anwendungsberechtigung FileStorageContainerTypeReg.Selected für die Containertypregistrierung für die Nutzung von Mandanten an.

Verwenden Sie Umleitungs-URIs, die Ihren Entwicklungs- und Produktionsclients entsprechen.

Verwenden Sie Anmeldeinformationen, die für delegierte oder reine App-Flows geeignet sind.

Details zur Authentifizierung finden Sie unter Konfigurieren der Authentifizierung und Autorisierung.

Festlegen grundlegender Eigenschaften

Eigenschaft	Richtlinien
Containertypname	Verwenden Sie einen dauerhaften Namen, der Ihrer Workload zugeordnet ist.
Besitzende Anwendungs-ID	Verwenden Sie die App-Registrierung, die diesen Typ besitzt.
Anwendungsumleitungs-URL	Verwenden Sie die URL, an die Dateien aus dieser App umgeleitet werden sollen.
Abrechnungsmodell	Wählen Sie Testversion, Standard oder Passthrough zum Zeitpunkt der Erstellung aus.

Achtung

Die Containertyp-ID und die besitzende Anwendungs-ID können später nicht aktualisiert werden.

Konfigurieren des Verhaltens des Containertyps

Entwickler können ausgewählte Verhaltensweisen nach der Erstellung konfigurieren.

Folgende Einstellungen sind verfügbar:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Verwenden Sie die Microsoft Graph-UpdatedateiStorageContainerType-API für unterstützte Containertypupdates. Informationen zu mandantenweiten Administrativen Einstellungen finden Sie unter Erstellen von Apps mit PowerShell.

Wichtig

Das Aktualisieren von Einstellungen für einen Containertyp kann bis zu 24 Stunden dauern, bis die Replikation auf alle verarbeitenden Mandanten erfolgt. Wenn für einen nutzenden Mandanten Einstellungsüberschreibungen angewendet werden, bleiben diese Außerkraftsetzungen bestehen. Einige Einstellungen gelten nur für neue Inhalte, nicht für vorhandene Inhalte.

Anzeigen und Aktualisieren von Containertypen

Verwenden Sie Microsoft Graph zum Auflisten und Aktualisieren von Containertypen.

Ein Containertypbesitzer ohne Administratorrechte kann die Containertypen aktualisieren, die er besitzt.

Sie benötigen Besitzer oder Mitwirkender Zugriff auf Abrechnungsabonnements für Abrechnungsänderungen.

Verwalten von Containertypen mit Microsoft Graph

Sie können Containertypen auch mit den fileStorageContainerType Microsoft Graph-APIs verwalten.

Vorgang	API
Erstellen eines Containertyps	Erstellen von fileStorageContainerType
Auflisten von Containertypen	Datei auflistenStorageContainerType
Aktualisieren eines Containertyps	FileStorageContainerType aktualisieren
Löschen eines Containertyps	FileStorageContainerType löschen

Listenergebnisse werden nach Besitz gefiltert. Benutzern ohne Administratorrechte werden nur die Containertypen angezeigt, für die ihnen die Berechtigung erteilt wurde, während SharePoint Embedded-Administratoren und globale Administratoren jeden Containertyp im Mandanten sehen. Informationen zu den Einstellungen, die Sie konfigurieren können, finden Sie unter fileStorageContainerTypeSettings.

Sie können nur Testcontainertypen löschen. Das Löschen von Standardcontainertypen wird noch nicht unterstützt. Bevor Sie einen Containertyp löschen, entfernen Sie jeden Container dieses Typs, einschließlich der Container in der gelöschten Containersammlung.

Grundlegendes zur Abrechnungsabhängigkeit

Für die Abrechnung von App-Besitzern fügt der Entwicklermandant ein Azure Abonnement und eine Ressourcengruppe an.

Für die Passthrough-Abrechnung aktiviert der nutzende Mandant dienste mit nutzungsbasierter Bezahlung.

Weitere Informationen finden Sie unter SharePoint Embedded-Verbrauchseinheiten und SharePoint Embedded-Abrechnungsverwaltung.

Link zum mehrinstanzenfähigen Onboarding

Eine mehrinstanzenfähige App verfügt in der Regel über einen eigenen Mandanten und mindestens einen nutzenden Mandanten.

Verwenden Sie diese Sequenz für jeden Nutzen-Mandanten:

1. Erstellen Sie den Containertyp im besitzenden Mandanten.
2. Bitten Sie den Benutzermandantenadministrator, die Administratoreinwilligung zu erteilen.
3. Registrieren von Anwendungsberechtigungen für Containertypen.
4. Konfigurieren Sie die Passthrough-Abrechnung, wenn der nutzende Mandant bezahlt.
5. Überprüfen Sie die Containererstellung und den Zugriff.

Nächste Schritte

Registrieren von Berechtigungen unter Registrieren von Anwendungsberechtigungen.