SharePoint Embedded-Containertypen

Ein Containertyp ist eine SharePoint Embedded-Ressource, die die Beziehung, Zugriffsberechtigungen und Abrechnungskonten zwischen einer SharePoint Embedded-Anwendung und einer Gruppe von Containern definiert. Außerdem definiert der Containertyp Verhaltensweisen für die Gruppe von Containern.

Jeder Containertyp ist stark mit einer SharePoint Embedded-Anwendung gekoppelt, die als besitzende Anwendung bezeichnet wird. Der entwickler der eigenen Anwendung ist für das Erstellen und Verwalten seiner Containertypen verantwortlich. SharePoint Embedded schreibt eine 1:1-Beziehung zwischen der besitzenden Anwendung und einem Containertyp vor.

Der Containertyp wird für jeden Container instance als unveränderliche Eigenschaft (ContainerTypeID) dargestellt und im gesamten SharePoint Embedded-Ökosystem verwendet, einschließlich:

• Zugriffsautorisierung: Eine SharePoint Embedded-Anwendung muss einem Containertyp zugeordnet sein, um Zugriff auf Containerinstanzen dieses Typs zu erhalten. Nach der Zuordnung hat die Anwendung Zugriff auf alle Containerinstanzen dieses Typs. Die tatsächliche Zugriffsberechtigung wird durch die Berechtigungseinstellung application-ContainerTypeID bestimmt. Die besitzende Anwendung verfügt standardmäßig über Vollzugriffsberechtigungen für alle Containerinstanzen des Containertyps, mit dem sie stark gekoppelt ist. Erfahren Sie mehr über die SharePoint Embedded-Autorisierung.
• Einfaches Durchsuchen: Der Containertyp kann zu Testzwecken erstellt werden, sodass Entwickler die Entwicklung von SharePoint Embedded-Anwendungen erkunden und seine Features kostenlos bewerten können.
• Abrechnung: Containertypen für Nicht-Testzwecke können abgerechnet werden und müssen mit einem Azure-Abonnement erstellt werden. Die Nutzung von Containern wird gemessen und berechnet. Erfahren Sie mehr über die Messung und die SharePoint Embedded-Abrechnungsumgebung.
• Konfigurierbares Verhalten: Der Containertyp definiert ausgewählte Verhaltensweisen für alle Containerinstanzen dieses Typs. Erfahren Sie mehr über das Festlegen der Containertypkonfiguration.

Hinweis

1. Sie müssen den Zweck des Containertyps angeben, den Sie zum Zeitpunkt der Erstellung erstellen. Je nach Zweck müssen Sie möglicherweise Ihre Azure-Abonnement-ID angeben. Ein Containertyp, der zu Testzwecken festgelegt wurde, kann nicht für die Produktion konvertiert werden. oder umgekehrt.
2. Standard und Übergeben von Containertypen können nach der Erstellung nicht konvertiert werden. Wenn Sie einen Standardcontainertyp für die Übergabe der Abrechnung oder umgekehrt konvertieren möchten, müssen Sie den Containertyp löschen und neu erstellen.
3. Sie müssen die neueste Version von SharePoint PowerShell verwenden, um einen Containertyp zu konfigurieren. Berechtigungen und die aktuellsten Informationen zu Windows PowerShell für SharePoint Embedded finden Sie in der Dokumentation unter Einführung in die SharePoint Embedded-Verwaltungsshell.

Erstellen von Containertypen

SharePoint Embedded verfügt über zwei verschiedene Containertypen, die Sie erstellen können.

1. Testcontainertyp
2. Standard Containertyp

Voraussetzungen zum Erstellen eines SharePoint Embedded-Containertyps

Ein neuer Containertyp wird mit SharePoint Online-Verwaltungsshell erstellt:

1. Laden Sie die neueste Version von SharePoint Online-Verwaltungsshell herunter, und installieren Sie sie.
2. Öffnen Sie SharePoint Online-Verwaltungsshell auf dem Startbildschirm, geben Sie sharepoint ein, und wählen Sie dann SharePoint Online-Verwaltungsshell aus.
3. Stellen Sie mithilfe des Cmdlets eine Verbindung mit Connect-SPOService dem SPO-Dienst her, indem Sie Administratoranmeldeinformationen angeben, die dem Mandanten zugeordnet sind. Informationen zur Verwendung von Connect-SPOService finden Sie in der verknüpften Dokumentation.

Anforderungen für den Mandanten

• In Ihrem Microsoft 365-Mandanten ist eine aktive instance von SharePoint erforderlich.

• Benutzer, die sich bei SharePoint Embedded-Containertypen und -Containern authentifizieren, müssen sich in Entra ID befinden (Mitglieder und Gäste)

  Hinweis

  Für die Zusammenarbeit an Microsoft Office-Dokumenten, die in einem Container gespeichert sind, ist keine Office-Lizenz erforderlich.

Rollen und Berechtigungen

• Der Administrator, der die Abrechnungsbeziehung für SharePoint Embedded einrichte, muss über Besitzer- oder Mitwirkender-Berechtigungen für das Azure-Abonnement verfügen.
• Admin benötigen eine SharePoint Embedded-Administrator- oder globale Admin-Rolle, um Abrechnungs-Cmdlets zu betreiben.

Azure-Abonnement

Für den Standard-Abrechnungscontainertyp muss der globale Administrator oder SharePoint Embedded-Administrator Folgendes einrichten:

• Ein vorhandener SharePoint-Mandanten
• Ein Azure-Abonnement im Mandanten
• Eine Ressourcengruppe, die an das Azure-Abonnement angefügt ist

Testcontainertyp

Ein Containertyp kann zu Test-/Entwicklungszwecken erstellt werden und ist nicht mit einem Azure-Abrechnungsprofil verknüpft. Auf diese Weise können Entwickler die Entwicklung von SharePoint Embedded-Anwendungen erkunden und deren Features kostenlos bewerten. Bei Testcontainertypen ist der Entwicklermandant mit dem Nutzen des Mandanten identisch. Jeder Entwickler kann jeweils nur einen Containertyp in der Testversion status in ihrem Mandanten haben. Der Testcontainertyp ist bis zu 30 Tage gültig, kann aber innerhalb dieses Zeitraums jederzeit entfernt werden.

Um einen Containertyp für Testzwecke zu erstellen, haben Sie folgende Möglichkeiten:

• Verwenden Sie die SharePoint Embedded Visual Studio Code-Erweiterung, um den Containertyp in nur wenigen Schritten zu erstellen. Die Visual Studio Code-Erweiterung registriert Ihren Containertyp und erstellt Container für Sie.

• Verwenden Sie SharePoint PowerShell. Sie müssen ein SharePoint Embedded-Administrator oder globaler Administrator sein, um das folgende Cmdlet ausführen zu können. Wenn Sie ein SharePoint-Administrator sind, gewähren Sie sich auch die SharePoint Embedded Admin Rolle, um diese Cmdlets auszuführen.

  New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
  

Die folgenden Einschränkungen gelten für Testcontainertypen:

• Es können bis zu fünf Container des Containertyps erstellt werden. 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 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.

Standard Containertypen (ohne Testversion)

Ein Standardcontainertyp in SharePoint Embedded definiert die Beziehung, Zugriffsberechtigungen und das Abrechnungsprofil zwischen einer Anwendung und ihren Containern. Es legt fest, wie die Anwendung mit den Containern interagiert, einschließlich Zugriffsberechtigungen, und ist einem Abrechnungsprofil für Nicht-Testzwecke zugeordnet. Jeder Mandant kann über 25 Containertypen gleichzeitig verfügen.

Abrechnungsprofil

SharePoint Embedded ist ein nutzungsbasiertes Nutzungsbasiertes Nutzungsangebot (Pay-as-you-go, PAYG), d. h., Sie zahlen nur für das, was Sie verwenden. SharePoint Embedded bietet zwei Abrechnungsmodelle, die der Mandant, der die SharePoint Embedded-Anwendung entwickelt, für die jeweiligen Containertypen auswählen kann, um sie an ihre individuellen Geschäftsanforderungen anzupassen. Die beiden Abrechnungsmodelle sind Standard und Passthrough-Abrechnung.

Standard Containertyp mit Abrechnungsprofil

Mit dem Standardabrechnungsprofil werden alle verbrauchsbasierten Gebühren direkt dem Mandanten in Rechnung gestellt, der die Anwendung besitzt oder entwickelt. Der Administrator im Entwicklermandanten muss beim Erstellen eines Standardcontainertyps ein gültiges Abrechnungsprofil einrichten.

Jeder Entwicklermandant kann bis zu fünf Containertypen erstellen, die aus einem Testcontainertyp und vier Standardcontainertypen oder fünf Standardcontainertypen bestehen. Standard Containertypen werden mithilfe des Cmdlets New-SPOContainerType erstellt.

Zum Erstellen eines Standardcontainertyps benötigen Sie Folgendes:

• Verwenden Sie SharePoint PowerShell. Sie müssen ein SharePoint Embedded-Administrator oder globaler Administrator sein, um dieses Cmdlet ausführen zu können. Wenn Sie ein SharePoint-Administrator sind, gewähren Sie sich auch die SharePoint Embedded Admin Rolle, um diese Cmdlets auszuführen.
• Ein Azure-Abonnement und eine Ressourcengruppe müssen im Azure-Portal für die reguläre Abrechnung vorhanden sein.
• Eine App-Registrierung muss in Microsoft Entra ID erstellt werden.

Verwenden Sie die folgenden Cmdlets, um einen Standardcontainertyp mithilfe eines Azure-Abrechnungsprofils zu erstellen:

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]

Nachdem der Containertyp erstellt wurde, fügen Sie das Azure-Abrechnungsprofil hinzu.

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Hinweis

Der Benutzer oder Administrator, der eine Abrechnungsbeziehung für SharePoint Embedded einrichte, muss über Besitzer- oder Mitwirkender-Berechtigungen für das Azure-Abonnement verfügen.

Jeder Containertyp muss über eine eigene Anwendung verfügen.

Eine app mit einzeleigenem Besitzer kann jeweils nur einen Containertyp besitzen.

Ein Azure-Abonnement kann an eine beliebige Anzahl von Containertypen angefügt werden.

Wenn das obige Cmdlet mit einem SubscriptionNotRegistered-Fehler fehlschlägt, liegt dies daran, dass Microsoft.Syntex nicht als Ressourcenanbieter im Abonnement registriert ist. Das Cmdlet sendet eine Registrierungsanforderung des Ressourcenanbieters in Ihrem Namen, es dauert jedoch einige Minuten, bis die Registrierung abgeschlossen ist. Warten Sie 5 bis 10 Minuten, und versuchen Sie es erneut, bis das Cmdlet erfolgreich ist.

Standard Containertyp – Passthrough-Abrechnung

Bei der Passthrough-Abrechnung werden verbrauchsbasierte Gebühren direkt dem Mandanten in Rechnung gestellt, der für die Verwendung der SharePoint Embedded-Anwendung registriert ist (der Mandant nutzt). Administratoren im Entwicklermandanten müssen beim Erstellen eines Passthrough-SharePoint Embedded-Containertyps kein Azure-Abrechnungsprofil einrichten.

Verwenden Sie für Containertypen, die einem Kunden direkt in Rechnung gestellt werden sollen, das Flag -IsPassThroughBilling. Für den Containertyp direkt an kundenseitig abgerechnet ist es nicht erforderlich, ein Abrechnungsprofil anzufügen.

Verwenden Sie das folgende Cmdlet, um eine Pass-Through-Abrechnung (Standardcontainertyp) zu erstellen:

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [<CommonParameters>]

Sobald der Containertyp im nutzenden Mandanten registriert ist, muss der nutzende Mandantenadministrator (SharePoint Admin oder Global Admin) das Abrechnungsprofil im nutzenden Mandanten einrichten, um die SharePoint Embedded-Anwendung zu verwenden.

Einrichten des Abrechnungsprofils in der Nutzung des Mandanten

1. Wählen Sie Microsoft 365 Admin CenterSetup aus, und zeigen Sie den Abschnitt Abrechnung und Lizenzen an. Wählen Sie Dienste mit nutzungsbasierter Bezahlung aktivieren aus.

   

2. Wählen Sie Go to Pay as you go services (Dienste mit nutzungsbasierter Bezahlung) aus.

3. Wählen Sie unter Syntex-Dienste fürdie Option Apps und SharePoint Embedded aus.

   

   [HINWEIS] Das in den Syntex-Diensten konfigurierte Abonnement spiegelt die Verbrauchsgebühren im Azure-Abrechnungsportal wider.

4. Registrieren Sie den Containertyp mithilfe des nur app-Authentifizierungstokens.

Konfigurieren von Containertypen

Der Entwickler Admin kann ausgewählte Einstellungen für die SharePoint Embedded-Containertypen festlegen, die mit diesem PowerShell-Cmdlet erstellt wurden.

Mit diesem Cmdlet können Administratoren Einstellungen für die Auffindbarkeit und Freigabe von Microsoft 365-Inhalten für Containertypen festlegen. Die Einstellung gilt für alle Containerinstanzen des Containertyps:

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $False

Anzeigen von Containertypen

Die Entwickler-Admin kann alle SharePoint Embedded-Containertypen anzeigen, die sie auf ihrem Mandanten mit Get-SPOContainerTypeerstellt haben. Dieses Cmdlet ruft die Liste der Containertypen ab, die für eine SharePoint Embedded-Anwendung im Mandanten erstellt wurden, und gibt sie zurück.

Get-SPOContainerType [<CommonParameters>]

Beispielausgabe des Cmdlets Get-SPOContainerType

ContainerTypeId     : 4f0af585-8dcc-0000-223d-661eb2c604e4
ContainerTypeName   : ContosoLegal
OwningApplicationId : a735e4af-b86e-0000-93ba-1faded6c39e1
Classification      : Standard
AzureSubscriptionId : 564e9025-f7f5-xxx9-9ddd-4cdxxxx1755
ResourceGroup       : prod-resources
Region              : EastUS

Registrieren von Containertypen

Um Container zu erstellen und mit ihnen zu interagieren, müssen Sie den Containertyp im Nutzungsmandanten registrieren . Die besitzende Anwendung definiert die Berechtigungen für den Containertyp, indem die Registrierungs-API aufgerufen wird.

Löschen von Containertypen

Entwickleradministratoren können sowohl Test- als auch Standardcontainertypen löschen. Um einen Containertyp zu löschen, müssen Sie zunächst alle Container dieses Containertyps entfernen, einschließlich aus der gelöschten Containersammlung. Informationen zum Entfernen von Containern finden Sie unter Verwenden von Mandanten Admin. Nachdem alle Container gelöscht wurden, können Entwickleradministratoren den Containertyp mithilfe von Remove-SPOContainerTypelöschen.

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]

SharePoint Embedded-Verbrauchseinheiten

Weitere Informationen zu den unterstützten Verbrauchseinheiten für nutzungsbasierte Bezahlung finden Sie im Artikel SharePoint Embedded-Verbrauchseinheiten .