Update-MgBetaReportUserInsightMonthly
Update the navigation property monthly in reports
Syntax
Update-MgBetaReportUserInsightMonthly
[-ResponseHeadersVariable <String>]
[-ActiveUsers <IMicrosoftGraphActiveUsersMetric[]>]
[-AdditionalProperties <Hashtable>]
[-Authentications <IMicrosoftGraphAuthenticationsMetric[]>]
[-Id <String>]
[-InactiveUsers <IMicrosoftGraphMonthlyInactiveUsersMetric[]>]
[-InactiveUsersByApplication <IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric[]>]
[-MfaCompletions <IMicrosoftGraphMfaCompletionMetric[]>]
[-Requests <IMicrosoftGraphUserRequestsMetric[]>]
[-SignUps <IMicrosoftGraphUserSignUpMetric[]>]
[-Summary <IMicrosoftGraphInsightSummary[]>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Update-MgBetaReportUserInsightMonthly
-BodyParameter <IMicrosoftGraphMonthlyUserInsightMetricsRoot>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Update the navigation property monthly in reports
Parameters
-ActiveUsers
Insights for active users on apps registered in the tenant for a specified period. To construct, see NOTES section for ACTIVEUSERS properties and create a hash table.
| Type: | IMicrosoftGraphActiveUsersMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AdditionalProperties
Additional Parameters
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Authentications
Insights for authentications on apps registered in the tenant for a specified period. To construct, see NOTES section for AUTHENTICATIONS properties and create a hash table.
| Type: | IMicrosoftGraphAuthenticationsMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BodyParameter
monthlyUserInsightMetricsRoot To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
| Type: | IMicrosoftGraphMonthlyUserInsightMetricsRoot |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Headers
Optional headers that will be added to the request.
| Type: | IDictionary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Id
The unique identifier for an entity. Read-only.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InactiveUsers
. To construct, see NOTES section for INACTIVEUSERS properties and create a hash table.
| Type: | IMicrosoftGraphMonthlyInactiveUsersMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InactiveUsersByApplication
. To construct, see NOTES section for INACTIVEUSERSBYAPPLICATION properties and create a hash table.
| Type: | IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MfaCompletions
Insights for MFA usage on apps registered in the tenant for a specified period. To construct, see NOTES section for MFACOMPLETIONS properties and create a hash table.
| Type: | IMicrosoftGraphMfaCompletionMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgressAction
{{ Fill ProgressAction Description }}
| Type: | ActionPreference |
| Aliases: | proga |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Requests
Insights for all user requests on apps registered in the tenant for a specified period. To construct, see NOTES section for REQUESTS properties and create a hash table.
| Type: | IMicrosoftGraphUserRequestsMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResponseHeadersVariable
Optional Response Headers Variable.
| Type: | String |
| Aliases: | RHV |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SignUps
Total sign-ups on apps registered in the tenant for a specified period. To construct, see NOTES section for SIGNUPS properties and create a hash table.
| Type: | IMicrosoftGraphUserSignUpMetric[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Summary
Summary of all usage insights on apps registered in the tenant for a specified period. To construct, see NOTES section for SUMMARY properties and create a hash table.
| Type: | IMicrosoftGraphInsightSummary[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyUserInsightMetricsRoot
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyUserInsightMetricsRoot
Notes
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.
ACTIVEUSERS <IMicrosoftGraphActiveUsersMetric- []>: Insights for active users on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[AppName <String>]:[Count <Int64?>]: The total number of users who made at least one authentication request within the specified time period.[Country <String>]:[FactDate <DateTime?>]: Date of the insight.[Language <String>]:[OS <String>]:
AUTHENTICATIONS <IMicrosoftGraphAuthenticationsMetric- []>: Insights for authentications on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[Appid <String>]: The ID of the Microsoft Entra application. Supports $filter (eq).[AttemptsCount <Int64?>]: The number of authentication requests made in the specified period. Supports $filter (eq).[Country <String>]: The location where the customers authenticated from. Supports $filter (eq).[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[OS <String>]: The platform for the device that the customers used. Supports $filter (eq).[SuccessCount <Int64?>]: Number of successful authentication requests. Supports $filter (eq).
BODYPARAMETER <IMicrosoftGraphMonthlyUserInsightMetricsRoot>: monthlyUserInsightMetricsRoot
[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ActiveUsers <IMicrosoftGraphActiveUsersMetric-[]>]: Insights for active users on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[AppName <String>]:[Count <Int64?>]: The total number of users who made at least one authentication request within the specified time period.[Country <String>]:[FactDate <DateTime?>]: Date of the insight.[Language <String>]:[OS <String>]:
[Authentications <IMicrosoftGraphAuthenticationsMetric-[]>]: Insights for authentications on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[Appid <String>]: The ID of the Microsoft Entra application. Supports $filter (eq).[AttemptsCount <Int64?>]: The number of authentication requests made in the specified period. Supports $filter (eq).[Country <String>]: The location where the customers authenticated from. Supports $filter (eq).[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[OS <String>]: The platform for the device that the customers used. Supports $filter (eq).[SuccessCount <Int64?>]: Number of successful authentication requests. Supports $filter (eq).
[InactiveUsers <IMicrosoftGraphMonthlyInactiveUsersMetric-[]>]:[AppId <String>]:[FactDate <DateTime?>]:[Inactive30DayCount <Int64?>]:[Inactive60DayCount <Int64?>]:[Inactive90DayCount <Int64?>]:[Id <String>]: The unique identifier for an entity. Read-only.[InactiveCalendarMonthCount <Int64?>]:
[InactiveUsersByApplication <IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric-[]>]:[AppId <String>]:[FactDate <DateTime?>]:[Inactive30DayCount <Int64?>]:[Inactive60DayCount <Int64?>]:[Inactive90DayCount <Int64?>]:[Id <String>]: The unique identifier for an entity. Read-only.[InactiveCalendarMonthCount <Int64?>]:
[MfaCompletions <IMicrosoftGraphMfaCompletionMetric-[]>]: Insights for MFA usage on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]: The ID of the Microsoft Entra application. Supports $filter (eq).[AttemptsCount <Int64?>]: Number of users who attempted to sign up. Supports $filter (eq).[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[MfaFailures <IMicrosoftGraphMfaFailure-[]>]:[Id <String>]: The unique identifier for an entity. Read-only.[Count <Int64?>]:[Reason <String>]:[ReasonCode <String>]: mfaFailureReasonCode
[MfaMethod <String>]: The MFA authentication method used by the customers. Supports $filter (eq).[OS <String>]: The platform of the device that the customers used. Supports $filter (eq).[SuccessCount <Int64?>]: Number of users who signed up successfully. Supports $filter (eq).
[Requests <IMicrosoftGraphUserRequestsMetric-[]>]: Insights for all user requests on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[RequestCount <Int64?>]: Number of requests to the tenant. Supports $filter (eq).
[SignUps <IMicrosoftGraphUserSignUpMetric-[]>]: Total sign-ups on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[Count <Int64?>]: The total number of users who signed up in the specified period. Supports $filter (eq).[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[OS <String>]: The device plaform that the customers used. Supports $filter (eq).
[Summary <IMicrosoftGraphInsightSummary-[]>]: Summary of all usage insights on apps registered in the tenant for a specified period.[Id <String>]: The unique identifier for an entity. Read-only.[ActiveUsers <Int64?>]: Daily active users.[AppId <String>]: The ID of the Microsoft Entra application.[AuthenticationCompletions <Int64?>]: Daily authentication completions.[AuthenticationRequests <Int64?>]: Daily authentication requests.[FactDate <DateTime?>]: The date of the insight.[OS <String>]: The platform for the device that the customers used. Supports $filter (eq).[SecurityTextCompletions <Int64?>]: Daily MFA SMS completions.[SecurityTextRequests <Int64?>]: Daily MFA SMS requests.[SecurityVoiceCompletions <Int64?>]: Daily MFA Voice completions.[SecurityVoiceRequests <Int64?>]: Daily MFA Voice requests.
INACTIVEUSERS <IMicrosoftGraphMonthlyInactiveUsersMetric- []>: .
[AppId <String>]:[FactDate <DateTime?>]:[Inactive30DayCount <Int64?>]:[Inactive60DayCount <Int64?>]:[Inactive90DayCount <Int64?>]:[Id <String>]: The unique identifier for an entity. Read-only.[InactiveCalendarMonthCount <Int64?>]:
INACTIVEUSERSBYAPPLICATION <IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric- []>: .
[AppId <String>]:[FactDate <DateTime?>]:[Inactive30DayCount <Int64?>]:[Inactive60DayCount <Int64?>]:[Inactive90DayCount <Int64?>]:[Id <String>]: The unique identifier for an entity. Read-only.[InactiveCalendarMonthCount <Int64?>]:
MFACOMPLETIONS <IMicrosoftGraphMfaCompletionMetric- []>: Insights for MFA usage on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]: The ID of the Microsoft Entra application. Supports $filter (eq).[AttemptsCount <Int64?>]: Number of users who attempted to sign up. Supports $filter (eq).[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[MfaFailures <IMicrosoftGraphMfaFailure-[]>]:[Id <String>]: The unique identifier for an entity. Read-only.[Count <Int64?>]:[Reason <String>]:[ReasonCode <String>]: mfaFailureReasonCode
[MfaMethod <String>]: The MFA authentication method used by the customers. Supports $filter (eq).[OS <String>]: The platform of the device that the customers used. Supports $filter (eq).[SuccessCount <Int64?>]: Number of users who signed up successfully. Supports $filter (eq).
REQUESTS <IMicrosoftGraphUserRequestsMetric- []>: Insights for all user requests on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[RequestCount <Int64?>]: Number of requests to the tenant. Supports $filter (eq).
SIGNUPS <IMicrosoftGraphUserSignUpMetric- []>: Total sign-ups on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[AppId <String>]:[Count <Int64?>]: The total number of users who signed up in the specified period. Supports $filter (eq).[Country <String>]:[FactDate <DateTime?>]: The date of the user insight.[IdentityProvider <String>]:[Language <String>]:[OS <String>]: The device plaform that the customers used. Supports $filter (eq).
SUMMARY <IMicrosoftGraphInsightSummary- []>: Summary of all usage insights on apps registered in the tenant for a specified period.
[Id <String>]: The unique identifier for an entity. Read-only.[ActiveUsers <Int64?>]: Daily active users.[AppId <String>]: The ID of the Microsoft Entra application.[AuthenticationCompletions <Int64?>]: Daily authentication completions.[AuthenticationRequests <Int64?>]: Daily authentication requests.[FactDate <DateTime?>]: The date of the insight.[OS <String>]: The platform for the device that the customers used. Supports $filter (eq).[SecurityTextCompletions <Int64?>]: Daily MFA SMS completions.[SecurityTextRequests <Int64?>]: Daily MFA SMS requests.[SecurityVoiceCompletions <Int64?>]: Daily MFA Voice completions.[SecurityVoiceRequests <Int64?>]: Daily MFA Voice requests.