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 の Copilot エージェント分析情報レポートをダウンロードできます。コマンドの実行元と同じパスに 9d946216-afe7-49f5-8267-7b662435c70b します。
パラメーター
-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 種類があります。
このコマンドレットがCopilotAgentsOnSitesとして-Contentで実行された場合、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で実行し、SiteDistributionとして-Contentすると、指定した日数のサイト間での 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」を参照してください。