Types de conteneurs Incorporés SharePoint

  • Article

Un type de conteneur est une ressource SharePoint Embedded qui définit la relation, les privilèges d’accès et la responsabilité de facturation entre une application SharePoint Embedded et un ensemble de conteneurs. En outre, le type de conteneur définit des comportements sur l’ensemble de conteneurs.

Chaque type de conteneur est fortement couplé à une application SharePoint Embedded, appelée application propriétaire. Le développeur d’applications propriétaires est responsable de la création et de la gestion de ses types de conteneurs. SharePoint Embedded impose une relation 1:1 entre l’application propriétaire et le type de conteneur.

Le type de conteneur est représenté sur chaque instance de conteneur sous la forme d’une propriété immuable (ContainerTypeID) et est utilisé dans l’ensemble de l’écosystème SharePoint Embedded, notamment :

  • Autorisation d’accès. Une application SharePoint Embedded doit être associée à un type de conteneur pour obtenir l’accès aux instances de conteneur de ce type. Une fois associée, l’application a accès à toutes les instances de conteneur de ce type. Le privilège d’accès réel est déterminé par le paramètre d’autorisation application-ContainerTypeID. L’application propriétaire par défaut dispose d’un privilège d’accès complet à toutes les instances de conteneur du type de conteneur avec lequel elle est fortement couplée. En savoir plus sur l’autorisation Incorporée SharePoint.
  • Exploration facile. Le type de conteneur peut être créé à des fins d’évaluation, ce qui permet aux développeurs d’explorer le développement d’applications SharePoint Embedded et d’évaluer ses fonctionnalités gratuitement.
  • Facturation. Les types de conteneurs à des fins autres que les versions d’évaluation sont facturables et doivent être créés avec un abonnement Azure. L’utilisation des conteneurs est mesurée et facturée. En savoir plus sur le contrôle et l’expérience de facturation SharePoint Embedded.
  • Comportements configurables. Le type de conteneur définit les comportements sélectionnés pour toutes les instances de conteneur de ce type. En savoir plus sur la définition de la configuration du type de conteneur.

Remarque

  1. Vous devez spécifier l’objectif du type de conteneur que vous créez au moment de la création. Selon l’objectif, vous devrez peut-être fournir ou non votre ID d’abonnement Azure. Un type de conteneur défini à des fins d’évaluation ne peut pas être converti pour la production ; ou vice versa.
  2. Vous devez utiliser la dernière version de SharePoint PowerShell pour les configurations de type de conteneur.

Utilisation de la version d’évaluation

Un type de conteneur peut être créé à des fins d’évaluation/développement et n’est lié à aucun profil de facturation Azure. Cela permet aux développeurs d’explorer le développement d’applications SharePoint Embedded et d’évaluer ses fonctionnalités gratuitement. Dans ce scénario, le locataire développeur est le même que le locataire consommateur. Chaque développeur ne peut avoir qu’un seul type de conteneur dans l’état d’évaluation de son locataire à la fois. Le type de conteneur est valide jusqu’à 30 jours, mais peut être supprimé à tout moment pendant cette période. Pour créer un type de conteneur à des fins d’évaluation, vous pouvez :

  • Utilisez l’extension SharePoint Embedded Visual Studio Code pour créer le type de conteneur en quelques étapes. L’extension Visual Studio Code inscrit également votre type de conteneur et crée des conteneurs pour vous.
  • Utilisez SharePoint PowerShell. Vous devez être administrateur SharePoint Embedded ou administrateur général pour exécuter cette applet de commande. Si vous êtes administrateur SharePoint, accordez-vous également le rôle Administrateur SharePoint Embedded pour exécuter ces applets de commande.
New-SPOContainerType
[–TrialContainerType]
[ -ContainerTypeName <ContainerTypeName>]
[ -OwningApplicationId <OwningApplicationId>]

Les restrictions suivantes sont appliquées au type de conteneur dans l’état d’évaluation :

  • Jusqu’à cinq conteneurs actifs du type de conteneur peuvent être créés.
  • Chaque conteneur a jusqu’à 1 Go d’espace de stockage.
  • Le type de conteneur expire au bout de 30 jours et l’accès à tous les conteneurs existants de ce type de conteneur est supprimé.
  • Le développeur doit supprimer définitivement tous les conteneurs d’un type de conteneur existant dans l’état d’évaluation pour créer un nouveau type de conteneur pour la version d’évaluation. Cela inclut les conteneurs de la collection de conteneurs supprimés.
  • Le type de conteneur est limité pour fonctionner dans le locataire développeur. Il ne peut pas être déployé dans d’autres locataires consommateurs.

Utilisation standard/non-version d’évaluation

Le type de conteneur peut également être créé avec un profil de facturation Azure, qui inclut un ID d’abonnement Azure et un groupe de régions. Ce type de conteneur est à l’état standard et est facturable. Vous avez besoin des éléments suivants pour créer un type de conteneur dans l’état standard :

  • Un abonnement Azure et un groupe de ressources doivent être présents dans le portail Azure
  • Une inscription d’application doit être créée dans l’ID Microsoft Entra
  • Chaque locataire développeur peut créer jusqu’à cinq types de conteneurs dans l’état standard. Pour en créer une, utilisez l’applet de commande PowerShell suivante :
New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

Remarque

L’utilisateur ou l’administrateur qui va configurer une relation de facturation pour SharePoint Embedded doit disposer des autorisations de propriétaire ou de contributeur sur l’abonnement Azure.

Configuration des types de conteneurs

L’administrateur de développeur peut définir les paramètres sélectionnés sur les types de conteneurs SharePoint Embedded créés à l’aide de cette applet de commande PowerShell.

Cette applet de commande permet aux administrateurs de définir les paramètres de découverte et de partage de contenu Microsoft 365 sur les types de conteneurs. Le paramètre s’applique à toutes les instances de conteneur du type de conteneur

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

Affichage des types de conteneurs

L’administrateur développeur peut afficher tous les types de conteneurs SharePoint Embedded qu’il a créés sur son locataire à l’aide de cette applet de commande PowerShell. Cette applet de commande récupère et retourne la liste des types de conteneurs créés pour une application SharePoint Embedded dans le locataire.

Get-SPOContainerType

Exemple de sortie de l’applet de Get-SPOContainerType commande

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

Inscription de types de conteneurs

Pour créer et interagir avec des conteneurs, vous devez inscrire le type de conteneur dans le locataire consommateur. L’application propriétaire définit les autorisations pour le type de conteneur en appelant l’API d’inscription.

Suppression de types de conteneurs

Les administrateurs de développeurs peuvent uniquement supprimer les types de conteneurs dans l’état d’évaluation. Pour supprimer un type de conteneur dans l’état d’évaluation, vous devez d’abord supprimer tous les conteneurs du type de conteneur, y compris de la collection de conteneurs supprimée. Pour supprimer des conteneurs, reportez-vous à Consommation d’administrateur de locataire. Une fois tous les conteneurs supprimés, les administrateurs de développeurs peuvent supprimer les types de conteneurs à l’aide de l’applet de commande PowerShell ci-dessous.

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]