Freigeben über

SharePoint Embedded-Containertypen

  • Artikel

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 eigenen Anwendung und dem Containertyp vor.

Der Containertyp wird in jeder Containerinstanz als unveränderliche Eigenschaft (ContainerTypeID) dargestellt und im gesamten SharePoint Embedded-Ökosystem verwendet, einschließlich:

  • Zugangsberechtigung. 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.
  • Einfache Erkundung. Der Containertyp kann zu Testzwecken erstellt werden, sodass Entwickler die Entwicklung von SharePoint Embedded-Anwendungen erkunden und die zugehörigen Features kostenlos bewerten können.
  • Abrechnung. Containertypen für Nicht-Testzwecke sind abrechenbar 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.
  • Konfigurierbare Verhaltensweisen. 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 für Testzwecke festgelegt wurde, kann nicht für die Produktion konvertiert werden. oder umgekehrt.
  2. Sie müssen die neueste Version von SharePoint PowerShell für Containertypkonfigurationen verwenden.

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. In diesem Szenario ist der Entwicklermandant identisch mit dem Nutzen des Mandanten. Jeder Entwickler kann jeweils nur einen Containertyp im Teststatus in ihrem Mandanten haben. Der Containertyp 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 auch 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-Administratorrolle, um diese Cmdlets auszuführen.
New-SPOContainerType
[–TrialContainerType]
[ -ContainerTypeName <ContainerTypeName>]
[ -OwningApplicationId <OwningApplicationId>]

Die folgenden Einschränkungen gelten für den Containertyp im Teststatus:

  • 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 im Teststatus dauerhaft löschen, 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-Testverwendung

Der Containertyp kann auch mit einem Azure-Abrechnungsprofil erstellt werden, das eine Azure-Abonnement-ID und eine Regionsgruppe enthält. Dieser Containertyp weist den Standardstatus auf und ist abrechenbar. Sie benötigen Folgendes, um einen Containertyp im Standardstatus zu erstellen:

  • Ein Azure-Abonnement und eine Ressourcengruppe müssen im Azure-Portal vorhanden sein.
  • Eine App-Registrierung muss in Microsoft Entra ID erstellt werden.
  • Jeder Entwicklermandant kann bis zu fünf Containertypen im Standardstatus erstellen. Verwenden Sie das folgende PowerShell-Cmdlet, um eins zu erstellen:
New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

Hinweis

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

Konfigurieren von Containertypen

Entwickleradministratoren können 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

Entwickleradministratoren können alle sharePoint Embedded-Containertypen, die von ihnen auf ihrem Mandanten erstellt wurden, mithilfe dieses PowerShell-Cmdlets anzeigen. 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

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 nur Containertypen im Teststatus löschen. Um einen Containertyp im Teststatus zu löschen, müssen Sie zuerst alle Container des Containertyps entfernen, einschließlich aus der gelöschten Containersammlung. Informationen zum Entfernen von Containern finden Sie unter Verwenden des Mandantenadministrators. Nachdem alle Container gelöscht wurden, können Entwickleradministratoren die Containertypen mithilfe des folgenden PowerShell-Cmdlets löschen.

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]