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. 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.

Testnutzung

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 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.

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 aktive Container des Containertyps erstellt werden.
• 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/Nicht-Testnutzung

Ein Standardcontainertyp ist mit einem Abrechnungsprofil verknüpft, bei dem es sich um eine reguläre oder direkte Abrechnung handeln kann. Jeder Entwicklermandant kann bis zu fünf Standardcontainertypen erstellen. Standard Containertypen werden mithilfe des Cmdlets New-SPOContainerType erstellt. Erstellen Sie für Containertypen mit regulärer Abrechnung mithilfe des Cmdlets Add-SPOContainerTypeBilling ein Abrechnungsprofil . Verwenden Sie für Containertypen mit direkter Kundenabrechnung das Flag -IsPassThroughBilling. Für den Containertyp direkt an kundenseitig abgerechnet ist es nicht erforderlich, ein Abrechnungsprofil anzufügen.

Zum Erstellen eines Standardcontainertyps benötigen Sie Folgendes:

• 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

Verwenden Sie die folgenden Cmdlets, um einen Standardcontainertyp mit einem regulären Abrechnungsprofil zu erstellen:

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

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.

Verwenden Sie das folgende Cmdlet, um einen Vom Kunden abgerechneten Standardcontainertyp zu erstellen:

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

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>]