Get-SCInsights

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-SCInsights コマンドレットを使用して、Microsoft 365 の分析情報を表示します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-SCInsights
   [-EndDate <DateTime>]
   [<CommonParameters>]

説明

このコマンドレットは、次の出力情報を返します。

  • 組織: Microsoft 365 ドメイン。
  • 日付: 世界協定時刻 (UTC) のイベントの日付。
  • InsightType
  • InsightSubType:値 All または Archive。
  • UsersCount:InsightType 値の整数カウント、またはメガバイト単位のサイズ。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

Get-SCInsights

この例では、すべての分析データを返します。

例 2

Get-SCInsights -EndDate (Get-Date "3/3/2018 9:30 AM").ToUniversalTime()

この例では、2018 年 3 月 15 日の分析情報データを返します。

パラメーター

-EndDate

EndDate パラメーターには、日付範囲の終了日を指定します。

このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。

  • UTC で日付/時刻の値を指定します。たとえば、"2021-05-06 14:30:00z" です。
  • ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します(例: (Get-Date "5/6/2021 9:30 AM").ToUniversalTime())。 詳細については、「Get-Date」を参照してください。
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Security & Compliance, Exchange Online Protection