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 paramètre, elle affiche les 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 auxquelles la création du rapport a été déclenchée. |
| Statut | Status du rapport. |
| ReportPeriodInDays | Durée du rapport en jours. |
Remarque
Tous les rapports respectent les chronologie de rétention conformément à la gouvernance de l’accès aux données.
Exemples
EXEMPLE 1
Get-SPOCopilotAgentInsightsReport
L’exemple 1 permet à l’administrateur d’afficher les 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’insights de l’agent Copilot de 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’insights de l’agent Copilot de ReportId : 9d946216-afe7-49f5-8267-7b662435c70b sur le 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 doit être consulté ou téléchargé. Si la valeur de -Action est définie sur View, elle affiche la sortie sur l’écran PowerShell. Sinon, si la valeur de -Action est définie sur Download, il télécharge le rapport complet au format CSV sur le même chemin d’accès à 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 de site du site SharePoint. |
| Propriétaire du site | Nom du propriétaire du site SharePoint. |
| Nom du copilote | Nom de l’agent Copilot sur le site SharePoint. |
| Niveau de confidentialité | Étiquette de confidentialité du site SharePoint. |
| Restreindre l’accès au site activé | Restreindre l’accès au site status (Oui/Non) du site SharePoint. |
| Limiter l’activation de la découverte de sites | Restreindre les status de découverte de site (Oui/Non) du site SharePoint. |
| Partage externe | Partage externe status (Oui/Non) du site SharePoint. |
Si cette applet de commande est exécutée avec -ReportId comme paramètre et -Content comme TopSites, les 100 premiers enregistrements résumant le nombre d’agents Copilot sur les sites créés dans le nombre de jours spécifié sont 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 de 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 l’accès au site status (Oui/Non) du site SharePoint. |
| Limiter l’activation de la découverte de sites | Restreindre les status de découverte de site (Oui/Non) du site SharePoint. |
| Partage externe | Partage externe status (Oui/Non) du site SharePoint. |
Si cette applet de commande est exécutée avec -ReportId comme paramètre et -Content comme SiteDistribution, un 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 de 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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.