Get-SPOCopilotAgentInsightsReport
Mit diesem Cmdlet kann der Administrator den Status aller aktiven und verfügbaren Berichte überprüfen, wenn keine Berichts-ID vorhanden ist, und einen Bericht anzeigen oder herunterladen, wenn eine Berichts-ID vorhanden ist.
Hinweis
Das mit diesem Cmdlet verknüpfte Feature wird in Kürze bereitgestellt.
Syntax
Default (Standard)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Beschreibung
Wenn dieses Cmdlet ohne Parameter ausgeführt wird, zeigt es den Status aller aktiven und abgeschlossenen Berichte mit den folgenden Eigenschaften an:
| Eigenschaft | Beschreibung |
|---|---|
| Id | Die eindeutige ID des Berichts. |
| CreatedDateTimeInUtc | Das Datum und die Uhrzeit in UTC, wann die Berichterstellung ausgelöst wurde. |
| Status | Der Status des Berichts. |
| ReportPeriodInDays | Die Berichtsdauer in Tagen. |
Hinweis
Alle Berichte halten sich an eine beliebige Zeitleiste für die Aufbewahrung gemäß Datenzugriffsgovernance.
Beispiele
BEISPIEL 1
Get-SPOCopilotAgentInsightsReport
Beispiel 1 ermöglicht Administratoren, den Status aller aktiven und abgeschlossenen Berichte anzuzeigen.
BEISPIEL 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
Beispiel 2 ermöglicht Administratoren das Anzeigen des Copilot-Agent-Insight-Berichts mit ReportId: 9d946216-afe7-49f5-8267-7b662435c70b.
BEISPIEL 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
Beispiel 3 ermöglicht es Administratoren, den Copilot-Agent-Insight-Bericht von ReportId: 9d946216-afe7-49f5-8267-7b662435c70b in denselben Pfad herunterzuladen, von dem aus der Befehl ausgeführt wurde.
Parameter
-Action
Anwendbar: SharePoint Online
Sie legt fest, ob ein Bericht angezeigt oder heruntergeladen wird. Wenn der Wert von -Action festgelegt ist als View, wird die Ausgabe auf dem PowerShell-Bildschirm angezeigt. Andernfalls, wenn der Wert von -Action festgelegt ist als Download, wird der vollständige Bericht im CSV-Format in den Pfad heruntergeladen, über den der Befehl ausgeführt wurde.
Parametereigenschaften
| Typ: | ActionType |
| Standardwert: | View |
| Zulässige Werte: | View, Download |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Content
Anwendbar: SharePoint Online
Sie gibt die Art des anzuzeigenden oder herunterzuladenden Berichts an. Es gibt drei Arten von Unterberichten: CopilotAgentsOnSites, TopSites, SiteDistribution.
Wenn dieses Cmdlet mit -Content als CopilotAgentsOnSitesausgeführt wird, wird ein Bericht mit einer Liste aller Websites, auf denen ein Copilot-Agent erstellt wird, zusammen mit den Namen des Copilot-Agents, der in der angegebenen Anzahl von Tagen erstellt wurde, mit den folgenden Eigenschaften angezeigt:
| Eigenschaft | Beschreibung |
|---|---|
| Sitename | Der Name der SharePoint-Website. |
| URL | Die URL der SharePoint-Website. |
| Vorlage | Die Websitevorlage der SharePoint-Website. |
| Websitebesitzer | Name des Besitzers der SharePoint-Website. |
| Copilot-Name | Name des Copilot-Agents auf der SharePoint-Website. |
| Sensitivity | Die Vertraulichkeitsbezeichnung der SharePoint-Website. |
| Websitezugriff einschränken aktiviert | Einschränken des Status des Websitezugriffs (Ja/Nein) der SharePoint-Website. |
| Site-Discovery einschränken aktiviert | Einschränken des Site-Discovery-Status (Ja/Nein) der SharePoint-Website. |
| Externe Freigabe | Status "Externe Freigabe" (Ja/Nein) der SharePoint-Website. |
Wenn dieses Cmdlet mit -ReportId einem as-Parameter und -Content als TopSitesausgeführt wird, werden die ersten 100 Datensätze, die die Anzahl der Copilot-Agents auf Websites zusammenfassen, die in der angegebenen Anzahl von Tagen erstellt wurden, mit den folgenden Eigenschaften angezeigt:
| Eigenschaft | Beschreibung |
|---|---|
| Sitename | Der Name der SharePoint-Website. |
| URL | Die URL der SharePoint-Website. |
| Vorlage | Die Websitevorlage der SharePoint-Website. |
| Websitebesitzer | Name des Besitzers der SharePoint-Website. |
| Copilot-Agents | Anzahl der Copilot-Agents auf der SharePoint-Website. |
| Sensitivity | Die Vertraulichkeitsbezeichnung der SharePoint-Website. |
| Websitezugriff einschränken aktiviert | Einschränken des Status des Websitezugriffs (Ja/Nein) der SharePoint-Website. |
| Site-Discovery einschränken aktiviert | Einschränken des Site-Discovery-Status (Ja/Nein) der SharePoint-Website. |
| Externe Freigabe | Status "Externe Freigabe" (Ja/Nein) der SharePoint-Website. |
Wenn dieses Cmdlet mit -ReportId einem as-Parameter und -Content als SiteDistributionausgeführt wird, wird ein Bericht angezeigt, der die Verteilung von Copilot über Websites in der angegebenen Anzahl von Tagen mit den folgenden Eigenschaften anzeigt:
| Eigenschaft | Beschreibung |
|---|---|
| Websitevorlage | Die Websitevorlage der SharePoint-Website. |
| Websites | Die Anzahl der Websites, die dieser bestimmten Websitevorlage entsprechen. |
| Copilot-Agents | Anzahl der Copilot-Agents auf der SharePoint-Website, die dieser bestimmten Websitevorlage entsprechen. |
Parametereigenschaften
| Typ: | Microsoft.Online.SharePoint.TenantAdministration.SPOCopilotAgentInsightType |
| Standardwert: | CopilotAgentsOnSites |
| Zulässige Werte: | CopilotAgentsOnSites, TopSites, SiteDistribution |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReportId
Anwendbar: SharePoint Online
Sie gibt die eindeutige ID des anzuzeigenden oder herunterzuladenden Berichts an.
Parametereigenschaften
| Typ: | System.Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.