Get-SPOCopilotAgentInsightsReport
Cette applet de commande permet à l’administrateur de case activée status de tous les rapports actifs et disponibles lorsqu’aucun ID de rapport n’est présent et d’afficher ou de télécharger un rapport si l’ID de rapport est présent.
Remarque
La fonctionnalité associée à cette applet de commande sera bientôt déployée.
Syntaxe
Default (Par défaut)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Description
Si cette applet de commande est exécutée sans aucun paramètre, elle affiche le status de tous les rapports actifs et terminés avec les propriétés suivantes :
| Propriété | Description |
|---|---|
| ID | ID unique du rapport. |
| CreatedDateTimeInUtc | Date et heure UTC de déclenchement de la création du rapport. |
| Statut | Status du rapport. |
| ReportPeriodInDays | Durée du rapport en jours. |
Remarque
Tous les rapports respectent la chronologie de conservation conformément à la gouvernance de l’accès aux données.
Exemples
EXEMPLE 1
Get-SPOCopilotAgentInsightsReport
L’exemple 1 permet à l’administrateur d’afficher le status de tous les rapports actifs et terminés.
EXEMPLE 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
L’exemple 2 permet à l’administrateur d’afficher le rapport d’insight de l’agent Copilot ReportId : 9d946216-afe7-49f5-8267-7b662435c70b.
EXEMPLE 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
L’exemple 3 permet à l’administrateur de télécharger le rapport d’insight de l’agent Copilot de ReportId : 9d946216-afe7-49f5-8267-7b662435c70b au même chemin d’accès que celui à partir duquel la commande a été exécutée.
Paramètres
-Action
Applicable : SharePoint Online
Il détermine si un rapport peut être consulté ou téléchargé. Si la valeur de -Action est définie sur View, la sortie s’affiche sur l’écran PowerShell. Sinon, si la valeur de -Action est définie comme Download, elle téléchargera le rapport complet au format CSV dans le même chemin à partir duquel la commande a été exécutée.
Propriétés du paramètre
| Type: | ActionType |
| Valeur par défaut: | View |
| Valeurs acceptées: | View, Download |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Content
Applicable : SharePoint Online
Il spécifie le type de rapport à afficher ou à télécharger. Il existe 3 types de sous-rapports : CopilotAgentsOnSites, TopSites, SiteDistribution.
Si cette applet de commande est exécutée avec -Content comme CopilotAgentsOnSites, un rapport avec la liste de tous les sites sur lesquels un agent Copilot est créé ainsi que les noms de l’agent Copilot créé dans le nombre de jours spécifié s’affiche avec les propriétés suivantes :
| Propriété | Description |
|---|---|
| Nom du site | Nom du site SharePoint. |
| URL | URL du site SharePoint. |
| Modèle | Modèle Site du site SharePoint. |
| Propriétaire du site | Nom du propriétaire du site SharePoint. |
| Nom Copilot | Nom de l’assistant Copilot sur le site SharePoint. |
| Niveau de confidentialité | Étiquette de confidentialité du site SharePoint. |
| Restreindre l’accès au site activé | Restreindre le status d’accès au site (Oui/Non) du site SharePoint. |
| Restreindre la découverte de site activée | Restreindre le status de découverte de site (Oui/Non) du site SharePoint. |
| Partage externe | le status du partage externe (oui/non) du site SharePoint ; |
Si cette applet de commande est exécutée avec -ReportId as parameter et -Content as TopSites, les 100 premiers enregistrements résumant le nombre d’agents Copilot sur les sites créés dans le nombre de jours spécifié seront affichés avec les propriétés suivantes :
| Propriété | Description |
|---|---|
| Nom du site | Nom du site SharePoint. |
| URL | URL du site SharePoint. |
| Modèle | Modèle Site du site SharePoint. |
| Propriétaire du site | Nom du propriétaire du site SharePoint. |
| Agents Copilot | Nombre d’agents Copilot sur le site SharePoint. |
| Niveau de confidentialité | Étiquette de confidentialité du site SharePoint. |
| Restreindre l’accès au site activé | Restreindre le status d’accès au site (Oui/Non) du site SharePoint. |
| Restreindre la découverte de site activée | Restreindre le status de découverte de site (Oui/Non) du site SharePoint. |
| Partage externe | le status du partage externe (oui/non) du site SharePoint ; |
Si cette applet de commande est exécutée avec -ReportId as parameter et -Content , SiteDistributionun rapport montrant la distribution de Copilot entre les sites dans le nombre de jours spécifié s’affiche avec les propriétés suivantes :
| Propriété | Description |
|---|---|
| Modèle de site | Modèle Site du site SharePoint. |
| Sites | Nombre de sites correspondant à ce modèle de site particulier. |
| Agents Copilot | Nombre d’agents Copilot sur le site SharePoint correspondant à ce modèle de site particulier. |
Propriétés du paramètre
| Type: | Microsoft.Online.SharePoint.TenantAdministration.SPOCopilotAgentInsightType |
| Valeur par défaut: | CopilotAgentsOnSites |
| Valeurs acceptées: | CopilotAgentsOnSites, TopSites, SiteDistribution |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ReportId
Applicable : SharePoint Online
Il spécifie l’ID unique du rapport à afficher ou à télécharger.
Propriétés du paramètre
| Type: | System.Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.