Types de conteneurs Incorporés SharePoint

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 : un 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 inversement.
2. Les types de conteneur Standard et pass-through ne peuvent pas être convertis une fois créés. Si vous souhaitez convertir un type de conteneur standard pour transmettre la facturation ou vice versa, vous devez supprimer et recréer le type de conteneur.
3. 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.

Création de types de conteneurs

SharePoint Embedded a 2 types de conteneurs différents que vous pouvez créer.

1. Type de conteneur d’essai
2. type de conteneur Standard

Conditions préalables à la création d’un type de conteneur SharePoint Embedded

Un nouveau type de conteneur est créé à l’aide de SharePoint Online Management Shell :

1. Téléchargez et installez la dernière version de SharePoint Online Management Shell
2. Ouvrez SharePoint Online Management Shell à partir de l’écran d’accueil, tapez sharepoint, puis sélectionnez SharePoint Online Management Shell.
3. Connectez-vous au service SPO à l’aide Connect-SPOService de l’applet de commande en fournissant les informations d’identification d’administrateur associées à la location. Pour plus d’informations sur l’utilisation de Connect-SPOService, reportez-vous à la documentation liée.

Configuration requise pour les clients

• Un instance actif de SharePoint est requis dans votre client Microsoft 365.

• Les utilisateurs qui s’authentifient dans les conteneurs et types de conteneurs incorporés SharePoint doivent se trouver dans Entra ID (membres et invités)

  Remarque

  Une licence Office n’est pas nécessaire pour collaborer sur des documents Microsoft Office stockés dans un conteneur.

Rôles et autorisations

• L’administrateur qui configure la relation de facturation pour SharePoint Embedded doit disposer des autorisations de propriétaire ou de contributeur sur l’abonnement Azure.
• Administration devez disposer d’un rôle Administrateur SharePoint Incorporé ou Administration général pour utiliser les applets de commande de facturation.

Abonnement Azure

Pour le type de conteneur de facturation standard, l’administrateur général ou l’administrateur SharePoint Embedded doit configurer :

• Une location SharePoint existante
• Un abonnement Azure dans la location
• Un groupe de ressources attaché à l’abonnement Azure

Type de conteneur d’essai

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 l’applet de commande suivante. 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 du type de conteneur peuvent être créés. Cela inclut les conteneurs actifs et ceux de la corbeille.
• 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.

types de conteneurs Standard (hors version d’évaluation)

Un type de conteneur standard dans SharePoint Embedded définit la relation, les privilèges d’accès et le profil de facturation entre une application et ses conteneurs. Il établit la façon dont l’application interagit avec les conteneurs, y compris les autorisations d’accès, et est associé à un profil de facturation à des fins autres que les versions d’évaluation. Chaque locataire peut avoir 25 types de conteneurs à la fois.

Profil de facturation

SharePoint Embedded est une offre de paiement à l’utilisation (PAYG) basée sur la consommation, ce qui signifie que vous payez uniquement pour ce que vous utilisez. SharePoint Embedded fournit deux modèles de facturation que le locataire qui développe l’application SharePoint Embedded peut sélectionner pour les types de conteneurs respectifs, en les adaptant à leurs besoins métier uniques. Les deux modèles de facturation sont Standard et la facturation directe.

type de conteneur Standard - avec profil de facturation

Avec le profil de facturation standard, tous les frais basés sur la consommation sont directement facturés au locataire qui possède ou développe l’application. L’administrateur du locataire développeur doit établir un profil de facturation valide lors de la création d’un type de conteneur standard.

Chaque locataire développeur peut créer jusqu’à cinq types de conteneurs, comprenant 1 type de conteneur d’essai et 4 types de conteneurs standard ou 5 types de conteneurs standard. Standard types de conteneur sont créés à l’aide de l’applet de commande New-SPOContainerType.

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

• 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.
• 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 à l’aide d’un profil de facturation Azure, utilisez les applets de commande suivantes :

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

Une fois le type de conteneur créé, ajoutez le profil de facturation Azure.

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.

Chaque type de conteneur doit avoir une application propriétaire.

Une application mono-propriétaire ne peut posséder qu’un seul type de conteneur à la fois.

Un abonnement Azure peut être attaché à n’importe quel nombre de types de conteneurs.

Si l’applet de commande ci-dessus échoue avec une erreur SubscriptionNotRegistered, c’est parce que Microsoft.Syntex n’est pas inscrit en tant que fournisseur de ressources dans l’abonnement. L’applet de commande envoie une demande d’inscription de fournisseur de ressources en votre nom, mais elle prend quelques minutes. Patientez 5 à 10 minutes, puis réessayez jusqu’à ce que l’applet de commande réussisse.

type de conteneur Standard - facturation directe

Avec la facturation directe, les frais basés sur la consommation sont facturés directement au locataire inscrit pour utiliser l’application SharePoint Embedded (client consommateur). Les administrateurs du locataire développeur n’ont pas besoin de configurer un profil de facturation Azure lors de la création d’un type de conteneur SharePoint Embedded direct.

Pour les types de conteneurs destinés à être directement facturés à un 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.

Pour créer une facturation directe, type de conteneur standard, utilisez l’applet de commande suivante :

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

Une fois que le type de conteneur est inscrit dans le locataire consommateur, l’administrateur client consommateur (SharePoint Administration ou Global Administration) doit configurer le profil de facturation dans le locataire consommateur pour utiliser l’application SharePoint Embedded.

Configurer le profil de facturation dans le client consommateur

1. Dans Centre d’administration Microsoft 365, sélectionnez Configuration, puis affichez la section Facturation et licences. Sélectionnez Activer les services de paiement à l’utilisation.

   

2. Sélectionnez Accéder aux services Payer à l’utilisation.

3. Sélectionnez Applications sous Services Syntex pour, sélectionnez Applications et SharePoint Embedded

   

   [REMARQUE] L’abonnement configuré dans les services Syntex reflète les frais de consommation dans le portail de facturation Azure.

4. Inscrivez le type de conteneur à l’aide du jeton d’authentification Application uniquement.

Configuration des types de conteneurs

Les administrateurs de développeurs peuvent configurer les paramètres sélectionnés pour les types de conteneurs SharePoint Embedded qui ont été créés. Le tableau suivant répertorie les paramètres disponibles.

Paramètres	Description
ApplicationRedirectUrl	Spécifie l’URL vers laquelle les fichiers de l’application sont redirigés.
CopilotEmbeddedChatHosts	Ajoute les URL d’hôte autorisées à utiliser l’expérience d’agent déclaratif de l’application SharePoint Embedded.
DétectabilitéDisabled	Détermine si le contenu d’une application SharePoint Embedded est visible dans les expériences Microsoft 365.
SharingRestricted	Configure les autorisations de partage pour les conteneurs SharePoint Embedded à l’aide de l’accès en fonction du rôle. Prend en charge les modèles de partage ouverts et restrictifs. Lorsque le partage restrictif est défini sur true, seuls les gestionnaires et les propriétaires peuvent partager des fichiers dans le conteneur.

L’applet de commande Set-SPOContainerType permet aux administrateurs de mettre à jour l’URL de redirection de l’application. L’applet de commande Set-SPOContainerTypeConfiguration permet aux administrateurs d’ajouter des URL d’hôte, de définir les paramètres de découverte de contenu microsoft 365 et de partage sur les types de conteneurs. Le paramètre s’applique à toutes les instances de conteneur du type de conteneur.

Exemple 1

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

L’exemple 1 active la détectabilité pour ce type de conteneur. Tout le contenu créé dans ce type de conteneur sera détectable dans l’expérience Microsoft 365, y compris sur les office.com, les onedrive.com, les fichiers recommandés et d’autres expériences de découverte intelligente.

Exemple 2

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false

L’exemple 2 active un modèle de partage ouvert pour ce type de conteneur. Tous les membres de conteneur et utilisateurs invités disposant d’autorisations de modification peuvent partager des fichiers créés dans le type de conteneur.

Exemple 3

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"

Cet exemple définit les URL d’hôte pour le type de conteneur avec l’ID 4f0af585-8dcc-0000-223d-661eb2c604e4.

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 de Get-SPOContainerType. 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

Mise à jour des types de conteneurs

Les administrateurs de développeurs peuvent mettre à jour un type de conteneur SharePoint Embedded dans leur locataire à l’aide de Set-SPOContainerType. Cette applet de commande modifie une ou plusieurs valeurs de propriété pour les types de conteneurs facturés en version d’évaluation, standard ou directe au client. Vous pouvez l’utiliser pour mettre à jour les informations de base, telles que le nom du type de conteneur ou les détails de facturation.

Pour mettre à jour les informations de base, vous devez être administrateur SharePoint Embedded. Pour modifier les informations de facturation, vous avez besoin d’un accès propriétaire ou contributeur à l’abonnement de facturation existant et au nouvel abonnement de facturation associé au type de conteneur.

Les propriétés suivantes ne peuvent pas être mises à jour : ID de type de conteneur et ID d’application propriétaire.

Exemple 1

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f -OwningApplicationId 12a9d93c-18d7-46a0-b43e-28d20addd56a - ContainerTypeName 'Red Container Type'

L’exemple 1 définit le nom du type de conteneur comme « Type de conteneur rouge »

Exemple 2

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f –Azure Subscription 12a9d93c-18d7-46a0-b43e-28d20addd56a -ResourceGroup RG200

Dans l’exemple 2, le profil de facturation du type de conteneur est mis à jour.

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 ceux de la collection de conteneurs supprimés. 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>]

Compteurs SharePoint Embedded

Pour en savoir plus sur les compteurs de paiement à l’utilisation pris en charge, reportez-vous à l’article Compteurs SharePoint Embedded .