Get-SCInsights

Reference

Module:: ExchangePowerShell

Applies to:: Exchange Online, Security & Compliance, Exchange Online Protection

This cmdlet is available only in the cloud-based service.

Use the Get-SCInsights cmdlet to view Microsoft 365 insights information.

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.

Syntax

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

Description

This cmdlet returns the following output:

Organization: The Microsoft 365 domain.
Date: The date of the event in Coordinated Universal Time (UTC).
InsightType
InsightSubType: The value All or Archive.
UsersCount: An integer count, or the size in megabytes for the InsightType value.

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet.

Examples

Example 1

Get-SCInsights

This example returns all insights data.

Example 2

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

This example return insights data for March 15, 2018.

Parameters

-EndDate

The EndDate parameter specifies the end date of the date range.

To specify a date/time value for this parameter, use either of the following options:

Specify the date/time value in UTC: For example, "2021-05-06 14:30:00z".
Specify the date/time value as a formula that converts the date/time in your local time zone to UTC: For example, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). For more information, see 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