Get-SCInsights

モジュール:
Exchange PowerShell

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

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

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

構文

Default (既定) 

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

適用対象: Exchange Online、セキュリティ & コンプライアンス、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

  • UTC で日付/時刻の値を指定します: たとえば、"2021-05-06 14:30:00z" です。
  • ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します。たとえば、 (Get-Date "5/6/2021 9:30 AM").ToUniversalTime() などです。 詳細については、「Get-Date」を参照してください。

パラメーターのプロパティ

型:DateTime
規定値: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」を参照してください。