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 エージェント分析情報レポートを表示できます。
例 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
表示またはダウンロードするレポートの種類を指定します。
このコマンドレットをM365AgentsOnSitesとして-Contentで実行すると、エージェントが作成されているすべてのサイトの一覧と、指定した日数で作成されたエージェントの名前を含むレポートが表示されます。
このコマンドレットがパラメーターとして-ReportIdで実行され、SiteDistributionとして-Contentされている場合は、指定した日数でサイト間で配布される 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」を参照してください。