Get-SPOCopilotAgentInsightsReport
このコマンドレットを使用すると、管理者は、レポート ID が存在しない場合に、すべてのアクティブ レポートと使用可能なレポートの状態をチェックし、レポート ID が存在する場合はレポートを表示またはダウンロードできます。
注:
このコマンドレットに関連付けられている機能は、まもなくロールアウトされる予定です。
構文
Default (既定)
Get-SPOCopilotAgentInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <SPOCopilotAgentInsightType>]
[<CommonParameters>]
説明
このコマンドレットをパラメーターなしで実行すると、すべてのアクティブ レポートと完了レポートの状態が次のプロパティで表示されます。
| プロパティ | 説明 |
|---|---|
| ID | レポートの一意の ID。 |
| CreatedDateTimeInUtc | レポートの作成がトリガーされた UTC での日時。 |
| 状態 | レポートの状態。 |
| ReportPeriodInDays | レポート期間 (日数)。 |
注:
すべてのレポートは、データ アクセス ガバナンスに従った保持タイムラインに準拠します。
例
例 1
Get-SPOCopilotAgentInsightsReport
例 1 では、管理者はすべてのアクティブなレポートと完了したレポートのステータスを表示できます。
例 2
Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
例 2 では、管理者は ReportId: 9d946216-afe7-49f5-8267-7b662435c70b の Copilot エージェント分析レポートを表示できます。
例 3
Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
例 3 では、管理者は ReportId: 9d946216-afe7-49f5-8267-7b662435c70b の Copilot エージェント分析情報レポートをダウンロードして、コマンドが実行された場所と同じパスにすることができます。
パラメーター
-Action
適用対象: SharePoint Online
レポートの表示またはダウンロードの用途を決定します。
-Action の値が View に設定されている場合、PowerShell 画面に出力が表示されます。 それ以外の場合、 -Action の値が Download に設定されている場合は、コマンドが実行された場所と同じパスに完全なレポートが CSV 形式でダウンロードされます。
パラメーターのプロパティ
| 型: | ActionType |
| 規定値: | View |
| 指定可能な値: | View, Download |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Content
適用対象: SharePoint Online
表示またはダウンロードするレポートの種類を指定します。 サブレポートには、CopilotAgentsOnSites、TopSites、SiteDistribution の 3 種類があります。
このコマンドレットを -Content を CopilotAgentsOnSitesとして実行すると、Copilot エージェントが作成されているすべてのサイトの一覧と、指定した日数以内に作成された Copilot エージェントの名前を含むレポートが、次のプロパティで表示されます。
| プロパティ | 説明 |
|---|---|
| サイト名 | SharePoint サイトの名前。 |
| URL | SharePoint サイトの URL。 |
| テンプレート | SharePoint サイトのサイト テンプレート。 |
| サイト所有者 | SharePoint サイトの所有者の名前。 |
| Copilot 名 | SharePoint サイトでの Copilot エージェントの名前。 |
| Sensitivity | SharePoint サイトの秘密度ラベル。 |
| サイトへのアクセス制限を有効にする | SharePoint サイトのサイト アクセス状態 (はい/いいえ) を制限します。 |
| サイト検出を有効にする制限 | SharePoint サイトのサイト検出状態 (はい/いいえ) を制限します。 |
| 外部共有 | SharePoint サイトの外部共有状態 (はい/いいえ)。 |
パラメーターとして -ReportId、TopSites として -Content を指定してこのコマンドレットを実行すると、指定した日数に作成されたサイトの Copilot エージェントの数を集計した上位 100 レコードが次のプロパティで表示されます。
| プロパティ | 説明 |
|---|---|
| サイト名 | SharePoint サイトの名前。 |
| URL | SharePoint サイトの URL。 |
| テンプレート | SharePoint サイトのサイト テンプレート。 |
| サイト所有者 | SharePoint サイトの所有者の名前。 |
| Copilot エージェント | SharePoint サイト上の Copilot エージェントの数。 |
| Sensitivity | SharePoint サイトの秘密度ラベル。 |
| サイトへのアクセス制限を有効にする | SharePoint サイトのサイト アクセス状態 (はい/いいえ) を制限します。 |
| サイト検出を有効にする制限 | SharePoint サイトのサイト検出状態 (はい/いいえ) を制限します。 |
| 外部共有 | SharePoint サイトの外部共有状態 (はい/いいえ)。 |
パラメーターとして -ReportId 、 -Content を SiteDistributionとしてこのコマンドレットを実行すると、指定した日数以内のサイト全体の Copilot 分布を示すレポートが次のプロパティで表示されます。
| プロパティ | 説明 |
|---|---|
| サイト テンプレート | SharePoint サイトのサイト テンプレート。 |
| サイト | その特定のサイト テンプレートに対応するサイトの数。 |
| Copilot エージェント | その特定のサイト テンプレートに対応する SharePoint サイト上の Copilot エージェントの数。 |
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantAdministration.SPOCopilotAgentInsightType |
| 規定値: | CopilotAgentsOnSites |
| 指定可能な値: | CopilotAgentsOnSites, TopSites, SiteDistribution |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReportId
適用対象: SharePoint Online
これは、表示またはダウンロードするレポートの一意の ID を指定します。
パラメーターのプロパティ
| 型: | System.Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。