Update-MgBetaReportUserInsightMonthly
Update the navigation property monthly in reports
Syntax
UpdateExpanded (Default)
Update-MgBetaReportUserInsightMonthly
[-ResponseHeadersVariable <string>]
[-ActiveUsers <IMicrosoftGraphActiveUsersMetric[]>]
[-AdditionalProperties <hashtable>]
[-Authentications <IMicrosoftGraphAuthenticationsMetric[]>]
[-Id <string>]
[-InactiveUsers <IMicrosoftGraphMonthlyInactiveUsersMetric[]>]
[-InactiveUsersByApplication <IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric[]>]
[-MfaCompletions <IMicrosoftGraphMfaCompletionMetric[]>]
[-MfaRegisteredUsers <IMicrosoftGraphMfaUserCountMetric[]>]
[-Requests <IMicrosoftGraphUserRequestsMetric[]>]
[-SignUps <IMicrosoftGraphUserSignUpMetric[]>]
[-Summary <IMicrosoftGraphInsightSummary[]>]
[-Break]
[-Headers <IDictionary>]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-ProxyUseDefaultCredentials]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update
Update-MgBetaReportUserInsightMonthly
-BodyParameter <IMicrosoftGraphMonthlyUserInsightMetricsRoot>
[-ResponseHeadersVariable <string>]
[-Break]
[-Headers <IDictionary>]
[-HttpPipelineAppend <SendAsyncStep[]>]
[-HttpPipelinePrepend <SendAsyncStep[]>]
[-Proxy <uri>]
[-ProxyCredential <pscredential>]
[-ProxyUseDefaultCredentials]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphActiveUsersMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AdditionalProperties
Additional Parameters
Parameter properties
| Type: | System.Collections.Hashtable |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphAuthenticationsMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-BodyParameter
monthlyUserInsightMetricsRoot To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyUserInsightMetricsRoot |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Update
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Break
Wait for .NET debugger to attach
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Headers
Optional headers that will be added to the request.
Parameter properties
| Type: | System.Collections.IDictionary |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HttpPipelineAppend
SendAsync Pipeline Steps to be appended to the front of the pipeline
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-HttpPipelinePrepend
SendAsync Pipeline Steps to be prepended to the front of the pipeline
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Runtime.SendAsyncStep[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Id
The unique identifier for an entity. Read-only.
Parameter properties
| Type: | System.String |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InactiveUsers
To construct, see NOTES section for INACTIVEUSERS properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyInactiveUsersMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InactiveUsersByApplication
To construct, see NOTES section for INACTIVEUSERSBYAPPLICATION properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyInactiveUsersByApplicationMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMfaCompletionMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-MfaRegisteredUsers
To construct, see NOTES section for MFAREGISTEREDUSERS properties and create a hash table.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMfaUserCountMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Proxy
The URI for the proxy server to use
Parameter properties
| Type: | System.Uri |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProxyCredential
Credentials for a proxy server to use for the remote call
Parameter properties
| Type: | System.Management.Automation.PSCredential |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ProxyUseDefaultCredentials
Use the default credentials for the proxy
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Default value: | False |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphUserRequestsMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ResponseHeadersVariable
Optional Response Headers Variable.
Parameter properties
| Type: | System.String |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | RHV |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphUserSignUpMetric[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphInsightSummary[] |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
UpdateExpanded
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
| Type: | System.Management.Automation.SwitchParameter |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyUserInsightMetricsRoot
{{ Fill in the Description }}
System.Collections.IDictionary
{{ Fill in the Description }}
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphMonthlyUserInsightMetricsRoot
{{ Fill in the Description }}
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). [AuthFlow <String>]: [Browser <String>]: [Country <String>]: The location where the customers authenticated from. Supports $filter (eq). [FactDate <DateTime?>]: The date of the user insight. [Failures <IMicrosoftGraphAuthenticationFailure[]>]: [Id <String>]: The unique identifier for an entity. Read-only. [Count <Int64?>]: [Reason <String>]: [ReasonCode <String>]: authenticationFailureReasonCode [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).
[AuthFlow <String>]:
[Browser <String>]:
[Country <String>]: The location where the customers authenticated from.
Supports $filter (eq).
[FactDate <DateTime?>]: The date of the user insight.
[Failures <IMicrosoftGraphAuthenticationFailure[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Count <Int64?>]:
[Reason <String>]:
[ReasonCode <String>]: authenticationFailureReasonCode
[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).
[MfaRegisteredUsers <IMicrosoftGraphMfaUserCountMetric[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Count <Int64?>]:
[FactDate <DateTime?>]:
[MfaType <String>]: mfaType
[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>]:
[Browser <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>]:
[Browser <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).
MFAREGISTEREDUSERS <IMicrosoftGraphMfaUserCountMetric[]>: . [Id <String>]: The unique identifier for an entity. Read-only. [Count <Int64?>]: [FactDate <DateTime?>]: [MfaType <String>]: mfaType
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>]: [Browser <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>]: [Browser <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.