Rapport Insights sur les agents dans SharePoint

Le rapport d’insights sur les agents dans SharePoint fournit aux administrateurs SharePoint des informations enrichies sur les agents récemment créés sur tous les sites SharePoint et les sites OneDrive au sein de leur organisation. Ce rapport permet aux administrateurs d’en savoir plus sur les sites ayant créé le plus grand nombre d’agents. En utilisant ce rapport, les administrateurs SharePoint peuvent régir et maintenir l’intégrité du contenu utilisé par les agents comme données de base.

Le rapport d’insights est basé sur les données d’audit Microsoft enregistrées pour les agents créés dans SharePoint via les événements FileCreated et FileRenamed.

Vous pouvez générer et gérer le rapport d’informations sur les agents dans SharePoint Administration Center ou à l’aide de SharePoint Online Management Shell.

Ce qu’il vous faut pour accéder au rapport Agent Insights

Consultez Conditions préalables pour la gestion avancée de SharePoint.

Comment accéder au rapport d’informations des agents dans le Centre d’administration SharePoint

1. Connectez-vous au Centre d’administration SharePoint avec les informations d’identification d’administrateur SharePoint de votre organisation.

2. Dans le volet de navigation, développez Rapports , puis sélectionnez Agent Insights.

Comment créer des rapports dans le Centre d’Administration SharePoint

1. En tant qu’administrateur SharePoint, sélectionnez Créer un rapport pour créer le rapport.

   

2. Entrez le nom du rapport. Sous Durée du rapport, spécifiez la période du rapport.

   

3. Sélectionnez Créer et exécuter.

Afficher le status du rapport dans le Centre d’Administration SharePoint

Pour case activée si un rapport est prêt ou quand il a été mis à jour pour la dernière fois, consultez la colonne État.

Afficher le rapport dans le Centre d’Administration SharePoint

Lorsqu’un rapport est prêt, sélectionnez-le pour afficher les données. Vous pouvez afficher les 100 premiers enregistrements hébergeant le plus grand nombre d’agents. Vous pouvez rechercher des sites ou filtrer sur le modèle de site et les stratégies de gouvernance.

Appliquer des stratégies de gouvernance de contenu dans le Centre d’administration SharePoint

Vous pouvez appliquer des stratégies de gouvernance de contenu sur les sites à partir du rapport d’analyse. Les stratégies disponibles sont Restreindre la stratégie d’accès au site et Restreindre la stratégie de découverte de contenu.

Rapport d’Agent Insights dans SharePoint Online Management Shell

Vous pouvez générer et gérer des rapports d’informations d’agent à l’aide de SharePoint Online Management Shell.

1. Si vous ne l’avez pas déjà fait, téléchargez et installez la dernière version de SharePoint Online Management Shell.

2. Connectez-vous à SharePoint Online en tant qu’administrateur SharePoint au minimum dans Microsoft 365. Pour plus d’informations, voir Prise en main de SharePoint Online Management Shell.

3. Pour générer et afficher ces rapports, assurez-vous que l’organisation dispose de la référence SKU du module complémentaire Gestion avancée de SharePoint ou de la licence Microsoft Copilot.

Avec les autorisations d’au moins un administrateur SharePoint, vous pouvez générer et afficher le rapport d’insights à l’aide des commandes suivantes :

1. Pour générer un rapport pour la durée du rapport par défaut d’un jour, exécutez la commande suivante :

   Start-SPOCopilotAgentInsightsReport
   

2. Pour générer un rapport pour toute autre durée (7, 14 ou 28 jours), exécutez la commande suivante :

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
   

   Par exemple, pour générer un rapport pour les 28 derniers jours, exécutez la commande :

   Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
   

3. Pour case activée le status de tous les rapports actifs et disponibles, exécutez la commande suivante :

   Get-SPOCopilotAgentInsightsReport
   

4. Pour case activée le status d’un rapport spécifique, exécutez la commande suivante :

   Get-SPOCopilotAgentInsightsReport –ReportId
   

5. Pour télécharger et afficher le rapport, exécutez la commande suivante :

   Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
   

   Remarque

   PowerShell affiche jusqu’à 100 enregistrements, mais les rapports téléchargés peuvent contenir jusqu’à 1 million d’enregistrements.

   Get-SPOCopilotAgentInsightsReport –ReportId -Action View
   

6. Pour afficher des rapports plus détaillés, utilisez les options suivantes :

   1. CopilotAgentsOnSites: fournit le nom de tous les agents actuellement disponibles sur tous les sites. Ce rapport contient jusqu’à 1 000 000 d’enregistrements.

      Remarque

      La valeur par défaut du -Content paramètre est CopilotAgentsOnSites.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
      

   2. TopSites: fournit une liste de 100 sites avec le nombre d’agents disponibles sur chaque site.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
      

   3. SiteDistribution: fournit la vue résumée des agents sur tous les types de sites tels que les sites de communication, les sites connectés du Groupe Microsoft 365, les sites OneDrive, etc.

      Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
      

Collecte de données pour le rapport Insights sur les agents dans SharePoint

Si vous n’avez pas de licence Microsoft Gestion avancée de SharePoint, vous devez activer la collecte des données. Cette section explique comment activer et case activée le status de collecte de données pour le rapport Insights sur les agents dans SharePoint.

Activer la collecte de données

Cette commande PowerShell commence à collecter les données d’audit pour les rapports sur les activités des 28 derniers jours.

Start-SPOAuditDataCollectionForActivityInsights  

Désactiver la collecte de données

Cette commande PowerShell arrête la collecte des données d’audit pour les rapports sur les activités des 28 derniers jours.

Stop-SPOAuditDataCollectionForActivityInsights  

Vérifier le status de la collecte de données

Après avoir activé la collecte de données, vous pouvez générer les rapports au bout de 24 heures. Pour case activée si vous pouvez générer des rapports, utilisez la commande Get-SPOAuditDataCollectionStatusForActivityInsightsPowerShell. La commande renvoie le status actuel de la collecte de données, qui peut être NotInitiated, InProgressou Paused. Vous pouvez générer des rapports lorsque le status est InProgress.

Get-SPOAuditDataCollectionStatusForActivityInsights 

Expériences connues avec les rapports d’agent Insights dans SharePoint

Les expériences suivantes sont connues avec les rapports d’agent Insights générés dans SharePoint Administration Center ou en utilisant SharePoint Online Management Shell :

• Vous ne pouvez réexécuter un rapport qu’au bout de 24 heures après la génération du dernier rapport.

• Dans les grands clients, la disponibilité des données peut prendre jusqu’à 48 heures.

• Un seul rapport peut exister pour chaque valeur de plage de rapport (1, 7, 14 ou 28 jours). Cette limitation signifie que vous pouvez voir un maximum de quatre rapports à un moment donné.

• Le rapport nouvellement généré remplace le rapport créé précédemment avec la même plage de dates. Pour conserver le rapport créé précédemment, téléchargez-le avant de créer un rapport pour la même plage de dates.

• Ces rapports utilisent des données d’audit unifiées Microsoft 365 et peuvent ne pas couvrir tous les événements d’audit.

Articles connexes

• Limiter l’accès au site SharePoint avec des groupes Microsoft 365 et des groupes de sécurité Microsoft Entra
• Restreindre la découverte des sites et du contenu SharePoint
• Microsoft.Online.SharePoint.PowerShell Module