Utiliser le catalogue d’applications de collection de sites

Les parties de cet article portant sur les compléments SharePoint sont des conseils hérités. Le retrait ci-dessous ne met pas hors service les autres API ou plateformes décrites ici.

S’applique à : Office 365

Utilisez les catalogues d’applications de collection de sites pour décentraliser la gestion des solutions SharePoint Framework prises en charge et limiter le déploiement à des sites spécifiques. Ils ne permettent pas d’exécuter des compléments SharePoint retirés dans SharePoint Online.

Pourquoi des catalogues d’applications de collection de sites

Auparavant, la gestion des compléments et des solutions SharePoint Framework était centralisée dans le catalogue d’applications du client. Alors que les administrateurs de clients pouvaient déléguer l’accès à d’autres personnes de l’organisation, un package déployé était visible sur toutes les collections de sites. SharePoint ne prenait pas en charge le déploiement de compléments et de solutions SharePoint Framework vers des sites spécifiques.

Les administrateurs de clients peuvent activer un catalogue d’applications sur des sites spécifiques. Une fois activé, les administrateurs de collection de sites peuvent déployer des solutions SharePoint Framework prises en charge pour cette collection de sites.

Le schéma suivant illustre l’utilisation de catalogues d’applications de collection de sites :

Dans votre client Office 365, vous disposez d’un catalogue d’applications client. Les solutions déployées sur ce catalogue d’applications peuvent être installées dans n’importe quelle collection de sites du client. Les administrateurs client peuvent activer des catalogues d’applications de collection de sites sur des collections de sites spécifiques. Les solutions déployées dans les catalogues d’applications d’une collection de sites peuvent uniquement être installées dans cette collection.

Fonctionnalités prises en charge

Packages SharePoint Framework

Les catalogues d’applications de collection de sites prennent en charge les packages de solution SPFx (.sppkg). Le support historique des compléments SharePoint a pris fin avec leur retrait dans SharePoint Online. Pour les composants Copilot UX, suivez le catalogue d’applications client documenté et le cycle de vie du déploiement de l’agent ; Ne déduisez pas la prise en charge d’une autre étendue de déploiement d’agent à partir des fonctionnalités de package WebPart.

Inclusion de composants dans les packages de solution

Les packages de solution SharePoint Framework qui contiennent des ressources peuvent être déployés dans des catalogues d’applications de collection de sites. Les composants inclus sont déployés dans une bibliothèque de documents préconfigurée, dans la même collection de sites que celle où le catalogue d’applications est situé. Si le CDN Public Office 365 est configuré, les composants seront servis à partir du CDN. Dans le cas contraire, les composants seront servis directement à partir de la bibliothèque de documents.

Déploiement dans l’étendue client

Lors du déploiement de solutions SharePoint Framework qui prennent en charge le déploiement dans l’étendue client vers un catalogue de collection de sites, vous êtes invité à rendre cette solution accessible à tous les sites de l’organisation. Malgré cette formulation, si vous cochez cette case, la solution est mise à disposition immédiatement uniquement dans la collection de sites dans laquelle se trouve le catalogue. Les autres collections de sites de votre organisation ne pourront pas utiliser la solution. Si vous ne case activée pas cette option, vous devrez installer explicitement la solution sur votre site avant de pouvoir l’utiliser.

Restrictions en cours

Configurer et gérer des catalogues d’applications de collection de sites

Vous pouvez configurer et gérer des catalogues d’applications de collection de sites à l’aide de SharePoint Online Management Shell.

Vous pouvez de manière alternative utiliser leCLI pour Microsoft 365 pour gérer vos catalogues d’applications de collection de sites SharePoint. L’interface de ligne de commande multiplateforme pour Microsoft 365 est une interface de ligne de commande multiplateforme qui peut être utilisée sur n’importe quelle plateforme, y compris Windows, macOS et Linux. Dans Windows, l’option PnP PowerShell permet également de créer le catalogue d’applications ou de supprimer le catalogue d’applications.

Créer un catalogue d’applications de collection de sites

Cannot invoke method or retrieve property from null object. Object returned by the
following call stack is null. "TenantAppCatalog
RootWeb
GetSiteByUrl
new Microsoft.Online.SharePoint.TenantAdministration.Tenant()
"

Pour créer un catalogue d’applications de collection de sites, utilisez l’applet de Add-SPOSiteCollectionAppCatalog commande en transmettant la collection de sites dans laquelle le catalogue d’applications doit être créé en tant que -Site paramètre.

Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Vous pouvez également utiliser PnP PowerShell pour ajouter la fonctionnalité de catalogue d’applications du site à votre site après vous être connecté au site d’administration SharePoint Online :

Add-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Utilisez de manière alternative, la spo site appcatalog add commande si vous utilisez le CLI pour Microsoft 365:

m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/marketing

Après l’exécution de ce script, la bibliothèque Applications pour SharePoint est ajoutée à votre collection de sites, où vous pouvez déployer des compléments SharePoint et des solutions SharePoint Framework.

Désactiver le catalogue d’applications de collection de sites

Pour désactiver le catalogue d’applications de collection de sites dans votre collection de sites, utilisez la Remove-SPOSiteCollectionAppCatalog cmdle,t en transmettant la collection de sites dans laquelle le catalogue d’applications doit être désactivé en tant que -Site paramètre. Si vous disposez de l’ID de votre collection de sites, vous pouvez également utiliser la cmdlet Remove-SPOSiteCollectionAppCatalogById à la place.

Remove-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Vous pouvez également utiliser PnP PowerShell pour supprimer la fonctionnalité de catalogue d’applications du site de votre site après vous être connecté au site d’administration SharePoint Online :

Remove-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Utilisez de manière alternative, la spo site appcatalog remove commande si vous utilisez le CLI pour Microsoft 365

m365 spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing

Après l’exécution de ce script, la bibliothèque Applications pour SharePoint reste visible dans votre collection de sites, mais vous ne pouvez pas y déployer ou utiliser les solutions déployées.

Considérations

Gouvernance

Pour répertorier les collections de sites du client dans lesquelles le catalogue d’applications de collection de sites est activé, utilisez l’URL https://<tenant-app-catalog-URL>/Lists/SiteCollectionAppCatalogs/AllItems.aspx.

Sécurité

Avant de déployer des solutions vers des catalogues d’applications de collection de sites, les administrateurs de collections de site doivent vérifier que ces solutions sont conformes aux stratégies de l’organisation. Bien que les solutions installées dans les catalogues d’applications de collections de sites ne puissent être utilisées que dans ces collections de sites particulières, elles peuvent potentiellement accéder à des ressources provenant d’autres sites du locataire. Les administrateurs doivent donc s’assurer que les solutions qu’ils sont sur le point de déployer fonctionnent comme prévu.

Voir aussi

• Gérer le Catalogue d’Applications d’Organisation
• CLI pour Microsoft 365