Get-SPOCopilotAgentInsightsReport
Mit diesem Cmdlet kann der Administrator status aller aktiven und verfügbaren Berichte überprüfen, wenn keine Berichts-ID vorhanden ist, und einen Bericht anzeigen oder herunterladen, wenn die Berichts-ID vorhanden ist.
Hinweis
Das feature, das diesem Cmdlet zugeordnet ist, wird in Kürze eingeführt.
Syntax
Default (Standardwert)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
Beschreibung
Wenn dieses Cmdlet ohne Parameter ausgeführt wird, wird die status aller aktiven und abgeschlossenen Berichte mit den folgenden Eigenschaften angezeigt:
| Eigenschaft | Beschreibung |
|---|---|
| Id | Die eindeutige ID des Berichts. |
| CreatedDateTimeInUtc | Das Datum und die Uhrzeit in UTC, an dem die Berichtserstellung ausgelöst wurde. |
| Status | Die status des Berichts. |
| ReportPeriodInDays | Die Berichtsdauer in Tagen. |
Hinweis
Alle Berichte entsprechen den aufbewahrungsbasierten Zeitleiste gemäß Datenzugriffsgovernance.
Beispiele
BEISPIEL 1
Get-SPOCopilotAgentInsightsReport
In Beispiel 1 kann der Administrator die status aller aktiven und abgeschlossenen Berichte anzeigen.
BEISPIEL 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
Beispiel 2 ermöglicht dem Administrator das Anzeigen des Copilot-Agent-Erkenntnisberichts von ReportId: 9d946216-afe7-49f5-8267-7b662435c70b.
BEISPIEL 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
Beispiel 3 ermöglicht dem Administrator das Herunterladen des Copilot-Agent-Erkenntnisberichts von ReportId: 9d946216-afe7-49f5-8267-7b662435c70b in denselben Pfad, von dem aus der Befehl ausgeführt wurde.
Parameter
-Action
Anwendbar: SharePoint Online
Es bestimmt, ob ein Bericht angezeigt oder heruntergeladen wird. Wenn der Wert von -Action auf Viewfestgelegt ist, wird die Ausgabe auf dem PowerShell-Bildschirm angezeigt. Wenn der Wert von -Action auf Downloadfestgelegt ist, wird der vollständige Bericht im CSV-Format in denselben Pfad heruntergeladen, von dem aus 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
Es gibt die Art des Berichts an, der angezeigt oder heruntergeladen werden soll. Es gibt drei Arten von Unterberichten: CopilotAgentsOnSites, TopSites, SiteDistribution.
Wenn dieses Cmdlet mit -ContentCopilotAgentsOnSitesals ausgeführt wird, wird ein Bericht mit einer Liste aller Websites, auf denen ein Copilot-Agent erstellt wird, zusammen mit den Namen des Copilot-Agents angezeigt, der in der angegebenen Anzahl von Tagen erstellt wurde, mit den folgenden Eigenschaften:
| 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. |
| Einschränken des Websitezugriffs aktiviert | Schränken Sie den Websitezugriff status (Ja/Nein) der SharePoint-Website ein. |
| Websiteermittlung einschränken aktiviert | Schränken Sie die Websiteermittlung status (Ja/Nein) der SharePoint-Website ein. |
| Externe Freigabe | Externe Freigabe status (Ja/Nein) der SharePoint-Website. |
Wenn dieses Cmdlet mit -ReportId als Parameter und -ContentTopSitesals ausgefü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. |
| Einschränken des Websitezugriffs aktiviert | Schränken Sie den Websitezugriff status (Ja/Nein) der SharePoint-Website ein. |
| Websiteermittlung einschränken aktiviert | Schränken Sie die Websiteermittlung status (Ja/Nein) der SharePoint-Website ein. |
| Externe Freigabe | Externe Freigabe status (Ja/Nein) der SharePoint-Website. |
Wenn dieses Cmdlet mit -ReportId als Parameter und -ContentSiteDistributionausgeführt wird, wird ein Bericht mit der Copilot-Verteilung über Standorte in der angegebenen Anzahl von Tagen mit den folgenden Eigenschaften angezeigt:
| Eigenschaft | Beschreibung |
|---|---|
| Websitevorlage | Die Websitevorlage der SharePoint-Website. |
| Websites | 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
Es gibt die eindeutige ID des Berichts an, der angezeigt oder heruntergeladen werden soll.
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.