Get-SCInsights

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

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

> [!NOTE] > We recommend that you use the Exchange Online PowerShell V2 module to connect to Exchange Online PowerShell. For instructions, see Use the Exchange Online PowerShell V2 module (https://docs.microsoft.com/powershell/exchange/exchange-online/exchange-online-powershell-v2/exchange-online-powershell-v2).

For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-server/exchange-cmdlet-syntax).

Syntax

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

Description

This cmdlet returns the following output:

  • Organization: The Office 365 domain.

  • Date: The date of the even 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, "2016-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/2016 9:30 AM").ToUniversalTime(). For more information, see Get-Date.

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Office 365 Security & Compliance Center

Inputs

Outputs