Partager via

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 un type de conteneur.

Le type de conteneur est représenté sur chaque conteneur instance en tant que 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 configurer un type de conteneur. Pour obtenir les autorisations et les informations les plus actuelles sur Windows PowerShell pour SharePoint Embedded, consultez la documentation de la page Présentation de SharePoint Embedded Management Shell.

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. Pour les types de conteneurs d’essai, le locataire développeur est identique au locataire consommateur. Chaque développeur ne peut avoir qu’un seul type de conteneur dans la version d’évaluation status dans son locataire à la fois. Le type de conteneur d’essai 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 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 SharePoint Embedded Administration pour exécuter ces applets de commande.
New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]

Les restrictions suivantes sont appliquées aux types de conteneurs d’essai :

  • 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 la version d’évaluation status 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

Un type de conteneur standard est lié à un profil de facturation, qui peut être une facturation régulière ou directe au consommateur. Chaque locataire développeur peut créer jusqu’à cinq types de conteneurs standard. Standard types de conteneur sont créés à l’aide de l’applet de commande New-SPOContainerType. Pour les types de conteneurs avec facturation régulière, créez un profil de facturation à l’aide de l’applet de commande Add-SPOContainerTypeBilling . Pour les types de conteneurs avec facturation directe au client, utilisez l’indicateur -IsPassThroughBilling. Pour le type de conteneur facturé directement au client, il n’est pas nécessaire d’attacher un profil de facturation.

Vous avez besoin des éléments suivants pour créer un type de conteneur standard :

  • Un abonnement Azure et un groupe de ressources doivent être présents dans le Portail Azure pour une facturation régulière.
  • Une inscription d’application doit être créée dans Microsoft Entra ID

Pour créer un type de conteneur standard avec un profil de facturation standard, utilisez les applets de commande suivantes :

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

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

Remarque

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

Pour créer un type de conteneur standard facturé directement au client, utilisez l’applet de commande suivante :

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

Configuration des types de conteneurs

L’Administration 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

Le Administration développeur peut afficher tous les types de conteneurs SharePoint Embedded qu’il a créés sur son locataire à l’aide Get-SPOContainerTypede . 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 [<CommonParameters>]

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 supprimer les types de conteneurs d’essai et standard. Pour supprimer un type de conteneur, vous devez d’abord supprimer tous les conteneurs de ce type de conteneur, y compris de la collection de conteneurs supprimée. Pour supprimer des conteneurs, reportez-vous à Consommation de Administration de locataire. Une fois tous les conteneurs supprimés, les administrateurs de développeurs peuvent supprimer le type de conteneur à l’aide Remove-SPOContainerTypede .

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]