external help file | Module Name | online version | schema | ms.subservice |
---|---|---|---|---|
Microsoft.Graph.Reports-help.xml |
Microsoft.Graph.Reports |
2.0.0 |
reports |
Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization.
Note
To view the beta release of this cmdlet, view Get-MgBetaReportEmailActivityCount
Get-MgReportEmailActivityCount -Period <String> -OutFile <String> [-ResponseHeadersVariable <String>]
[-Headers <IDictionary>] [-PassThru] [-ProgressAction <ActionPreference>] [<CommonParameters>]
Get-MgReportEmailActivityCount -InputObject <IReportsIdentity> -OutFile <String>
[-ResponseHeadersVariable <String>] [-Headers <IDictionary>] [-PassThru] [-ProgressAction <ActionPreference>]
[<CommonParameters>]
Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization.
Permissions [!INCLUDE permissions-table]
Import-Module Microsoft.Graph.Reports
Get-MgReportEmailActivityCount -Period $periodId
This example shows how to use the Get-MgReportEmailActivityCount Cmdlet.
Optional headers that will be added to the request.
Type: IDictionary
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
Type: IReportsIdentity
Parameter Sets: GetViaIdentity
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
Path to write output file to
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Returns true when the command succeeds
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Usage: period='{period}'
Type: String
Parameter Sets: Get
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
{{ Fill ProgressAction Description }}
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Optional Response Headers Variable.
Type: String
Parameter Sets: (All)
Aliases: RHV
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
COMPLEX PARAMETER PROPERTIES
To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
INPUTOBJECT <IReportsIdentity>
: Identity Parameter
[Date <DateTime?>]
: Usage: date={date}[DeviceManagementExportJobId <String>]
: The unique identifier of deviceManagementExportJob[DirectoryAuditId <String>]
: The unique identifier of directoryAudit[EndDateTime <DateTime?>]
: Usage: endDateTime={endDateTime}[Filter <String>]
: Usage: filter='{filter}'[GroupId <String>]
: Usage: groupId='{groupId}'[IncludedUserRoles <String>]
: Usage: includedUserRoles='{includedUserRoles}'[IncludedUserTypes <String>]
: Usage: includedUserTypes='{includedUserTypes}'[ManifestId <String>]
: The unique identifier of manifest[OperationId <String>]
: The unique identifier of operation[Period <String>]
: Usage: period='{period}'[PrintUsageByPrinterId <String>]
: The unique identifier of printUsageByPrinter[PrintUsageByUserId <String>]
: The unique identifier of printUsageByUser[PrinterId <String>]
: Usage: printerId='{printerId}'[ProvisioningObjectSummaryId <String>]
: The unique identifier of provisioningObjectSummary[SignInId <String>]
: The unique identifier of signIn[Skip <Int32?>]
: Usage: skip={skip}[SkipToken <String>]
: Usage: skipToken='{skipToken}'[StartDateTime <DateTime?>]
: Usage: startDateTime={startDateTime}[Top <Int32?>]
: Usage: top={top}[UserId <String>]
: Usage: userId='{userId}'[UserRegistrationDetailsId <String>]
: The unique identifier of userRegistrationDetails
https://learn.microsoft.com/powershell/module/microsoft.graph.reports/get-mgreportemailactivitycount
https://learn.microsoft.com/graph/api/reportroot-getemailactivitycounts?view=graph-rest-1.0