Get-SPOM365AgentAccessInsightsReport
このコマンドレットを使用すると、管理者は、レポート ID が存在しない場合に、アクティブで利用可能なすべての分析レポートの状態をチェックし、レポート ID が存在する場合はレポートを表示またはダウンロードできます。
注:
このコマンドレットに関連付けられている機能は、まもなくロールアウトされる予定です。
構文
Default (既定)
Get-SPOM365AgentAccessInsightsReport
[-ReportId <Guid>]
[-Action <ActionType>]
[-Content <M365AgentsOnSites>]
[<CommonParameters>]
説明
このコマンドレットをパラメーターなしで実行すると、アクティブなレポートと完了したレポートがすべて表示されます。
注:
すべてのレポートは、データ アクセス ガバナンスに従った保持タイムラインに準拠します。
例
例 1
Get-SPOM365AgentAccessInsightsReport
例 1 では、管理者はすべてのアクティブおよび完了した分析レポートのステータスを表示できます。
例 2
Get-SPOM365AgentAccessInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b
例 2 では、管理者は特定のレポート ID の Microsoft 365 エージェント インサイト レポートを表示できます。 これにより、最大 100 のサイトのデータが表示され、サイトごとに最大 20 のエージェントが表示されます。
例 3
Get-SPOM365AgentAccessInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download
例 3 では、管理者は、指定されたレポート ID の Microsoft 365 エージェント インサイト レポートを、コマンドが実行されたのと同じパスにダウンロードできます。
パラメーター
-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
表示またはダウンロードするレポートの種類を指定します。
-ContentをM365AgentsOnSitesとしてこのコマンドレットを実行すると、エージェントが作成されているすべてのサイトの一覧と、指定した日数以内に作成されたエージェントの名前を含むレポートが表示されます。
パラメーターとして -ReportId 、 -Content を SiteDistribution としてこのコマンドレットを実行すると、指定された日数以内に Microsoft 365 エージェントがサイト間で分布していることを示すレポートが表示されます。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantAdministration.SPOM365AgentInsightType |
| 規定値: | M365AgentsOnSites |
| 指定可能な値: | M365AgentsOnSites, 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」を参照してください。