Gérer des conteneurs avec PowerShell

S’applique à : Administrateur client consommant — Administrateur SharePoint Embedded / Administrateur général

Utilisez SharePoint Online Management Shell pour automatiser l’administration des conteneurs et des applications SharePoint Embedded.

PowerShell est utile pour l’inventaire, la création de rapports, les opérations de cycle de vie, les mises à jour des étiquettes de confidentialité, le partage de la configuration et la révision des autorisations.

Cet article indique les applets de commande d’administrateur prises en charge et des liens vers des références d’applets de commande canoniques pour plus de détails sur la syntaxe.

Importante

Utilisez la dernière version de SharePoint Online Management Shell avant d’exécuter les applets de commande d’administration de conteneur SharePoint Embedded.

Avant de commencer

Confirmez ces prérequis.

  • Votre compte a le rôle Administrateur SharePoint Incorporé ou Administrateur général.
  • Vous pouvez vous connecter au locataire avec SharePoint Online Management Shell.
  • Vous connaissez l’URL de l’administrateur du locataire.
  • Vous connaissez l’ID d’application propriétaire lors du filtrage des résultats de l’application ou du conteneur.
  • Vous comprenez l’impact sur l’entreprise avant de supprimer des conteneurs.

Pour plus d’informations sur le rôle, consultez Administrateur SharePoint Embedded.

Installer SharePoint Online Management Shell

Installez le SharePoint Online Management Shell.

Ouvrez-le à partir du menu Démarrer ou utilisez un hôte PowerShell pris en charge avec le module disponible.

Installez le dernier interpréteur de commandes et connectez-vous à SharePoint Online avant d’exécuter les applets de commande SharePoint Embedded.

Pour plus d’informations sur la connexion, consultez Connect-SPOService.

Se connecter à SharePoint Online

Connectez-vous au point de terminaison d’administration de votre locataire.

Connect-SPOService -Url https://<tenant>-admin.sharepoint.com

Remplacez par <tenant> le nom de votre locataire.

Connectez-vous avec un compte disposant du rôle d’administrateur requis.

Conseil

Utilisez un compte d’administration dédié qui suit les stratégies d’accès privilégié de votre organization.

Inventaire des applications SharePoint Embedded

Répertorier les applications SharePoint Embedded inscrites dans le locataire.

Get-SPOApplication

Afficher les détails d’une application propriétaire spécifique.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Pour plus d’informations sur la commande, consultez Get-SPOApplication.

Afficher les autorisations des applications invitées

Afficher les autorisations des applications invitées pour une application SharePoint Embedded.

Get-SPOApplication -OwningApplicationId <OwningApplicationId> -ApplicationId <ApplicationId>

OwningApplicationId est l’ID de l’application propriétaire SharePoint Embedded. ApplicationId est l’ID d’application invitée qui a accès à l’application SharePoint Embedded.

Les applets de commande d’administration d’application ne s’appliquent pas aux Microsoft Loop.

Configurer le partage d’applications

Les administrateurs clients qui consomment peuvent configurer la fonctionnalité de partage externe au niveau de l’application.

Set-SPOApplication -OwningApplicationId <OwningApplicationId> -SharingCapability <SharingCapability> -OverrideTenantSharingCapability <OverrideTenantSharingCapability>

SharingCapability prend en charge ces valeurs :

  • Disabled
  • ExistingExternalUserSharingOnly
  • ExternalUserSharingOnly
  • ExternalUserAndGuestSharing

La OverrideTenantSharingCapability valeur peut être $true ou $false. Passez en revue votre stratégie de partage de locataire avant de remplacer le comportement de partage de locataire.

Répertorier les conteneurs actifs

Répertorier les conteneurs actifs pour une application SharePoint Embedded.

Get-SPOContainer -OwningApplicationId <OwningApplicationId> | FT

est OwningApplicationId l’ID de l’application SharePoint Embedded.

Pour Microsoft Loop conteneurs, utilisez cet ID d’application propriétaire avec les applets de commande d’administration de conteneur :

a187e399-0c36-4b98-8f04-1edc167a0996

Pour plus d’informations sur la commande, consultez Get-SPOContainer.

Répertorier les conteneurs triés par stockage

Triez les conteneurs par stockage lors de l’examen des coûts ou de la croissance.

Get-SPOContainer -OwningApplicationId <OwningApplicationId> -SortByStorage <value> | FT

Utilisez Ascending ou Descending pour <value>.

Utilisez cette vue avec Surveiller l’utilisation, la facturation et le coût pour rechercher des applications ou des conteneurs à forte croissance.

Obtenir les détails du conteneur

Afficher les détails d’un conteneur spécifique par ID de conteneur ou URL de site.

Get-SPOContainer -Identity <ContainerId>
Get-SPOContainer -Identity <SiteURL>

Le résultat détaillé peut inclure le stockage, les détails de propriété, l’URL du site, les informations d’étiquette et le nombre de propriétaires.

Utilisez l’URL du site lors de la configuration de certains contrôles de conformité dans Microsoft Purview.

Définir ou supprimer une étiquette de confidentialité

Définissez l’étiquette de confidentialité d’un conteneur.

Set-SPOContainer -Identity <ContainerID> -SensitivityLabel <SensitivityLabel>

Supprimez l’étiquette de confidentialité d’un conteneur.

Set-SPOContainer -Identity <ContainerID> -RemoveLabel

Coordonner les modifications des étiquettes de confidentialité avec les administrateurs de conformité.

Pour obtenir des conseils sur la conformité, consultez Appliquer des contrôles de sécurité et de conformité.

Gérer l’appartenance au conteneur

Les administrateurs clients consommateurs peuvent ajouter, supprimer ou modifier directement le rôle d’un utilisateur sur un conteneur (septembre 2025) :

Add-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Set-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName> -Role <Reader|Writer|Manager|Owner>
Remove-SPOContainerUser -ContainerId <ContainerId> -LoginName <UserPrincipalName>

Pour plus d’informations sur la commande, consultez Add-SPOContainerUser, Set-SPOContainerUser et Remove-SPOContainerUser.

Supprimer un conteneur

Déplacer un conteneur vers la collection de conteneurs supprimée.

Remove-SPOContainer -Identity <ContainerId>

La suppression d’un conteneur peut entraîner une perte de données, des liens rompus, des échecs d’application et des problèmes d’autorisation.

Informez les propriétaires de conteneurs et les propriétaires d’applications avant la suppression.

Avertissement

La suppression d’un conteneur peut interrompre l’utilisation de l’application SharePoint Embedded qui en est propriétaire.

Pour plus d’informations sur la commande, consultez Remove-SPOContainer.

Afficher les conteneurs supprimés

Répertorie les conteneurs supprimés dans la collection de conteneurs supprimés.

Get-SPODeletedContainer

Pour plus d’informations sur la commande, consultez Get-SPODeletedContainer.

Restaurer un conteneur supprimé

Restaurez un conteneur supprimé à partir de la collection de conteneurs supprimée.

Restore-SPODeletedContainer -Identity <ContainerId>

Après la restauration, validez le conteneur dans le Centre d’administration SharePoint et demandez au propriétaire de l’application de tester l’application.

Supprimer définitivement un conteneur

Supprimez définitivement un conteneur de la collection de conteneurs supprimée lorsque la récupération n’est plus nécessaire.

Remove-SPODeletedContainer -Identity <ContainerId>

Pour plus d’informations sur la commande, consultez Remove-SPODeletedContainer.

Attention

La suppression définitive ne peut pas être annulée. Confirmez les exigences légales et de rétention avant d’exécuter cette commande.

Gérer les autorisations des applications invitées

Si cela est autorisé, les administrateurs peuvent ajouter, modifier et supprimer l’accès aux applications invitées aux applications SharePoint Embedded. Utilisez Set-SPOApplicationPermission pour ce scénario.

Set-SPOApplicationPermission
   [[-OwningApplicationId] <OwningApplicationid>]
   [[-GuestApplicationId] <GuestApplicationId>]
   [[-PermissionAppOnly] <AppOnlyPermission>]
   [[-PermissionDelegated] <DelegatedPermission>]

Pour plus d’informations sur la commande, consultez Set-SPOApplicationPermission.

Script en toute sécurité

Suivez ces pratiques opérationnelles.

  • Exporter l’inventaire avant les changements de cycle de vie.
  • Testez d’abord les filtres avec des commandes en lecture seule.
  • Utilisez des ID de conteneur explicites pour les opérations de suppression et de restauration.
  • Sortie de commande de journal pour les enregistrements de modification.
  • Informez les propriétaires d’applications avant de supprimer ou de restaurer des conteneurs.
  • Passez en revue les conteneurs contenant beaucoup de stockage avant de prendre des décisions en matière de coûts.
  • Coordonner les modifications d’étiquette et de conformité avec les administrateurs de conformité.

Contenu connexe

Étapes suivantes

Surveiller la consommation dans Surveiller l’utilisation, la facturation et les coûts.

  • Last updated on