Partager via

Rapport Insights sur les agents SharePoint

Le rapport Insights sur les agents SharePoint fournit aux administrateurs SharePoint des informations détaillées sur les agents SharePoint récemment créés sur tous les sites SharePoint et les sites OneDrive au sein de leur organization. Ce rapport permet aux administrateurs d’en savoir plus sur les sites avec le plus grand nombre d’agents créés. À l’aide de ce rapport, les administrateurs SharePoint peuvent davantage gouverner 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 SharePoint via les événements FileCreated et FileRenamed.

Vous pouvez générer et gérer le rapport Insights de l’agent SharePoint dans le Centre Administration SharePoint ou avec SharePoint Online Management Shell.

De quoi avez-vous besoin pour accéder au rapport Insights de l’agent SharePoint ?

Quelles sont les exigences de licence ?

Votre organization doit disposer de la licence appropriée et répondre à certaines autorisations ou rôles administratifs pour utiliser la fonctionnalité décrite dans cet article.

Tout d’abord, votre organization doit avoir l’une des licences de base suivantes :

  • Office 365 E3, E5 ou A5
  • Microsoft 365 E1, E3, E5 ou A5

En outre, vous devez avoir Microsoft 365 Copilot licence.

Remarque

Au moins un utilisateur de votre organization doit se voir attribuer une licence Copilot (cet utilisateur n’a pas besoin d’être administrateur SharePoint). Si votre organization dispose d’une licence Copilot et qu’au moins une personne de votre organization se voit attribuer une licence Copilot, les administrateurs SharePoint ont automatiquement accès aux fonctionnalités de gestion avancée sharePoint nécessaires au déploiement de Copilot.

Configuration requise pour l’administrateur

Vous devez être administrateur SharePoint ou disposer d’autorisations équivalentes.

Importante

Si vous ne disposez pas d’une licence Microsoft SharePoint Advanced Management, vous êtes invité à activer la collecte de données afin que le produit commence à collecter les données d’audit pertinentes pour générer ce rapport. Une fois activés, les rapports peuvent être générés 24 heures plus tard et contenir des données à partir du point de collecte. Les données sont stockées pendant 28 jours. Si aucun rapport n’est généré au moins une fois tous les trois mois, la collecte de données est suspendue et doit être à nouveau activée. Pour activer la collecte de données pour ces rapports, reportez-vous à la section Collecte de données pour le rapport Insights sur les agents SharePoint de cet article.

Comment accéder au rapport SharePoint Agent Insights dans le Centre Administration SharePoint

  1. Connectez-vous au Centre d’administration SharePoint avec les informations d’identification de l’administrateur SharePoint pour votre organization.
  2. Dans le volet gauche, développez Rapports , puis sélectionnez Agent Insights.

Comment créer des rapports dans le Centre Administration SharePoint

  1. Avec les autorisations d’un administrateur SharePoint, vous pouvez créer le rapport en sélectionnant Créer un rapport.

    Capture d’écran de la création d’un rapport dans SharePoint Agent Insights.

  2. Indiquez le nom du rapport et, sous Durée du rapport, spécifiez le délai pour le rapport.

    Capture d’écran de la spécification d’une période de rapport dans SharePoint Agent Insights.

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

Remarque

Vous pouvez créer un rapport pour les 1, 7, 14 ou 28 derniers jours.

Afficher les status de rapport dans le Centre Administration SharePoint

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

Capture d’écran de la status de rapport.

Afficher le rapport dans le Centre 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.

Capture d’écran du rapport d’affichage.

Appliquer des stratégies de gouvernance du contenu dans le Centre Administration SharePoint

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

Capture d’écran de l’application de RCD.

Remarque

Une fois qu’une stratégie est appliquée au site à partir du rapport d’insights, la stratégie status sur le rapport existant n’est pas mise à jour. Pour afficher les status mises à jour de la stratégie sur le site, sélectionnez la stratégie pour afficher la dernière status ou accéder au panneau Site actif et passer en revue les paramètres du site.

Rapport Insights de l’agent SharePoint dans SharePoint Online Management Shell

Vous pouvez générer et gérer le rapport Insights de l’agent SharePoint à l’aide de SharePoint Online Management Shell.

  1. Si ce n’est pas le cas, 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 moins dans Microsoft 365. Pour plus d’informations, consultez Prise en main de SharePoint Online Management Shell.
  3. Pour générer et afficher ces rapports, vérifiez que le organization dispose de la référence SKU du module complémentaire Gestion avancée SharePoint ou de la licence Microsoft 365 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 une durée de rapport par défaut d’un jour, exécutez la commande :

    Start-SPOCopilotAgentInsightsReport

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

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays

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

    Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>

    Capture d’écran des scripts PowerShell pour le rapport genearte.

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

    Get-SPOCopilotAgentInsightsReport

    Capture d’écran de la status de script PowerShell.

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

    Get-SPOCopilotAgentInsightsReport –ReportId

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

    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, les options suivantes sont disponibles :

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

    Remarque

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

    Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites

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

    Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites

    c. 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 au groupe Microsoft 365, le site OneDrive, etc.

    Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution

Collecte de données pour le rapport d’insights sur les agents SharePoint

Si vous n’avez pas de licence Microsoft SharePoint Advanced Management, vous êtes invité à activer la collecte de données. Cette section explique comment activer et case activée status pour la collecte de données pour le rapport Insights sur les agents SharePoint.

Activer la collecte de données

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

Start-SPOAuditDataCollectionForActivityInsights

Désactivation de 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érification de la status de collecte de données

Une fois la collecte de données activée, les rapports peuvent être générés après 24 heures. Pour case activée si des rapports peuvent être générés, utilisez la commande PowerShell Get-SPOAuditDataCollectionStatusForActivityInsights. La commande retourne la collection de données actuelle status, qui peut être « NotInitiated », « InProgress », « Paused ». Des rapports peuvent être générés lorsque le status est « InProgress ».

Get-SPOAuditDataCollectionStatusForActivityInsights

Expériences connues avec les rapports SharePoint Agent Insights

Voici quelques expériences connues avec les rapports SharePoint Agent Insights générés dans le Centre Administration SharePoint ou à l’aide de SharePoint Online Management Shell :

  • Un rapport ne peut être réexécuté qu’au bout de 24 heures depuis le dernier rapport généré.

  • Dans les grands locataires, 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). Cela 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 par la même plage de dates. Pour conserver le rapport créé précédemment, téléchargez d’abord le rapport avant de créer un rapport pour la même plage de dates.

  • Ces rapports sont générés à l’aide de données d’audit unifiées Microsoft 365 et peuvent ne pas couvrir tous les événements d’audit.

  • Last updated on