LifecycleWorkflows.ReadReports.All

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the LifecycleWorkflows.ReadReports.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	-
DisplayText	-	-
Description	-	-
AdminConsentRequired	Yes	No

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow_id}/runs/{runId}/userProcessingResults/{userProcessingResultId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/userProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/{taskReportId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow_id}/runs/{runId}/userProcessingResults/{userProcessingResultId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflow-id}/userProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/{runId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/runs/summary(startDateTime={timestamp},endDateTime={timestamp})
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/taskReports/{taskReportId}/taskProcessingResults
	GET /identityGovernance/lifecycleWorkflows/workflows/{workflowId}/userProcessingResults/{userProcessingResultId}/taskProcessingResults

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgIdentityGovernanceLifecycleWorkflowRun
	Get-MgIdentityGovernanceLifecycleWorkflowRunTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowRunUserProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowRunUserProcessingResultTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowTaskReport
	Get-MgIdentityGovernanceLifecycleWorkflowTaskReportTaskProcessingResult
	Get-MgIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Invoke-MgSummaryIdentityGovernanceLifecycleWorkflowRun

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRun
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunUserProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowRunUserProcessingResultTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTaskReport
	Get-MgBetaIdentityGovernanceLifecycleWorkflowTaskReportTaskProcessingResult
	Get-MgBetaIdentityGovernanceLifecycleWorkflowUserProcessingResult
	Invoke-MgBetaSummaryIdentityGovernanceLifecycleWorkflowRun

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: run

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the run completed. Value is `null` if the workflow hasn't completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedTasksCount	Int32	The number of tasks that failed in the run execution.
failedUsersCount	Int32	The number of users that failed in the run execution.
id	String	A unique identifier for the workflow run.
lastUpdatedDateTime	DateTimeOffset	The datetime that the run was last updated. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The run execution status. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
scheduledDateTime	DateTimeOffset	The date time that the run is scheduled to be executed for a workflow. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time that the run execution started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
successfulUsersCount	Int32	The number of successfully completed users in the run.
totalUsersCount	Int32	The total number of users in the workflow execution.
totalTasksCounts	Int32	The total number of tasks in the run execution.
totalUnprocessedTasksCount	Int32	The total number of unprocessed tasks in the run execution.
workflowExecutionType	microsoft.graph.identityGovernance.workflowExecutionType	The execution type of the workflows associated with the run. The possible values are: `scheduled`, `onDemand`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.

Graph reference: runSummary

Property	Type	Description
failedRuns	Int32	The number of failed workflow runs.
failedTasks	Int32	The number of failed tasks of a workflow.
successfulRuns	Int32	The number of successful workflow runs.
totalRuns	Int32	The total number of runs for a workflow.
totalTasks	Int32	The total number of tasks processed by a workflow.
totalUsers	Int32	The total number of users processed by a workflow.

Graph reference: taskProcessingResult

Property	Type	Description
completedDateTime	DateTimeOffset	The date time when taskProcessingResult execution ended. Value is `null` if task execution is still in progress. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
createdDateTime	DateTimeOffset	The date time when the taskProcessingResult was created. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failureReason	String	Describes why the taskProcessingResult has failed.
id	String	Identifier used for individually addressing a specific task processing result. Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	Describes the execution status of the `taskProcessingResult`. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time when taskProcessingResult execution started. Value is `null` if task execution has not yet started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: taskReport

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the associated run completed. Value is `null` if the run has not completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedUsersCount	Int32	The number of users in the run execution for which the associated task failed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
id	String	The unique identifier of the task report. Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
lastUpdatedDateTime	DateTimeOffset	The date and time that the task report was last updated.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The processing status of the associated task based on the taskProcessingResults. The possible values are based on the number of `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, and `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
runId	String	The unique identifier of the associated run.
startedDateTime	DateTimeOffset	The date time that the associated run started. Value is `null` if the run has not started.
successfulUsersCount	Int32	The number of users in the run execution for which the associated task succeeded. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
totalUsersCount	Int32	The total number of users in the run execution for which the associated task was scheduled to execute. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
unprocessedUsersCount	Int32	The number of users in the run execution for which the associated task is `queued`, `in progress`, or `canceled`. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Graph reference: userProcessingResult

Property	Type	Description
completedDateTime	DateTimeOffset	The date time that the workflow execution for a user completed. Value is null if the workflow hasn't completed. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
failedTasksCount	Int32	The number of tasks that failed in the workflow execution.
id	String	Identifier used for individually addressing a specific user processing result.Inherited from entity. Supports `$filter`(`eq`, `ne`) and `$orderby`.
processingStatus	microsoft.graph.identityGovernance.lifecycleWorkflowProcessingStatus	The workflow execution status. The possible values are: `queued`, `inProgress`, `completed`, `completedWithErrors`, `canceled`, `failed`, `unknownFutureValue`. Supports `$filter`(`eq`, `ne`) and `$orderby`.
scheduledDateTime	DateTimeOffset	The date time that the workflow is scheduled to be executed for a user. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
startedDateTime	DateTimeOffset	The date time that the workflow execution started. Value is `null` if the workflow execution has not started. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
totalTasksCount	Int32	The total number of tasks that in the workflow execution.
totalUnprocessedTasksCount	Int32	The total number of unprocessed tasks for the workflow.
workflowExecutionType	microsoft.graph.identityGovernance.workflowExecutionType	Describes the execution type of the workflow. The possible values are: `scheduled`, `onDemand`, `unknownFutureValue`. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
workflowVersion	Int32	The version of the workflow that was executed.

Graph reference: workflow

Property	Type	Description
category	microsoft.graph.identityGovernance.lifecycleWorkflowCategory	The category of the HR function supported by the workflows created using this template. A workflow can only belong to one category. The possible values are: `joiner`, `leaver`, `mover`, `unknownFutureValue`. Inherited from workflowBase. Required. Supports `$filter`(`eq`,`ne`) and `$orderby`
createdDateTime	DateTimeOffset	When the `workflow` was created. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
deletedDateTime	DateTimeOffset	When the workflow was deleted. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
description	String	The description of the `workflow`. Inherited from workflowBase. Optional.
displayName	String	The display name of the `workflow`. Inherited from workflowBase. Required. Supports `$filter`(`eq`, `ne`) and `orderby`.
executionConditions	microsoft.graph.identityGovernance.workflowExecutionConditions	Conditions describing when to execute the workflow and the criteria to identify in-scope subject set. Inherited from workflowBase. Required.
id	String	Identifier used for individually addressing a specific workflow. Supports `$filter`(`eq`, `ne`) and `$orderby`.
isEnabled	Boolean	Whether the workflow is enabled or disabled. If this setting is `true`, the workflow can be run on demand or on schedule when isSchedulingEnabled is `true`. Inherited from workflowBase. Optional. Defaults to `true`. Supports `$filter`(`eq`, `ne`) and `orderBy`.
isSchedulingEnabled	Boolean	If `true`, the Lifecycle Workflow engine executes the workflow based on the schedule defined by tenant settings. Cannot be `true` for a disabled workflow (where isEnabled is `false`). Inherited from workflowBase. Optional. Defaults to `false`. Supports `$filter`(`eq`, `ne`) and `orderBy`.
lastModifiedDateTime	DateTimeOffset	The date time when the `workflow` was last modified. Inherited from workflowBase. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.
nextScheduleRunDateTime	DateTimeOffset	The date time when the `workflow` is expected to run next based on the schedule interval, if there are any users matching the execution conditions. Supports `$filter`(`lt`,`gt`) and `$orderby`.
version	Int32	The current version number of the workflow. Value is 1 when the workflow is first created. Supports `$filter`(`lt`, `le`, `gt`, `ge`, `eq`, `ne`) and `$orderby`.

Table of Contents

LifecycleWorkflows.ReadReports.All

Graph Methods

Resources