Table of Contents

Get-PnPFlowRun

SYNOPSIS

Required Permissions

  • Azure: management.azure.com

Returns the flows runs for a given flow.

SYNTAX

Get-PnPFlowRun [-Environment <PowerAutomateEnvironmentPipeBind>] -Flow <PowerAutomateFlowPipeBind> [-Identity <PowerAutomateFlowRunPipeBind>]
[-Connection <PnPConnection>] 

DESCRIPTION

This cmdlet returns the flow runs for a given flow.

EXAMPLES

Example 1

Get-PnPFlowRun -Flow fba63225-baf9-4d76-86a1-1b42c917a182

This returns all the flow runs for a given flow in the default environment

Example 2

Get-PnPFlowRun -Environment (Get-PnPPowerPlatformEnvironment -Identity "myenvironment") -Flow fba63225-baf9-4d76-86a1-1b42c917a182 -Identity 08585531682024670884771461819CU230

This returns a specific flow run for a given flow in a specific environment

Example 3

$flowrun = Get-PnPFlowRun -Flow fba63225-baf9-4d76-86a1-1b42c917a182 -Identity 08585531682024670884771461819CU230
$flowrun.Properties.trigger

This returns the trigger information of a run of a specific flow located in the default environment as shown below

Output

Name              : Recurrence
StartTime         : 2024-02-02 06:00:00
EndTime           : 2024-02-02 06:00:00
ScheduledTime     : 2024-02-02 06:00:00
OriginHistoryName : 08584947532854535568834568113CU171
Code              : OK
Status            : Succeeded

Example 4

$flowruns = Get-PnPFlowRun -Environment (Get-PnPPowerPlatformEnvironment -Identity "myenvironment") -Flow fba63225-baf9-4d76-86a1-1b42c917a182
$flowruns.Properties.trigger

This returns the trigger information of a run of a specific flow located in the specified environment as shown below

Output

Name              : Recurrence
StartTime         : 2024-02-02 06:00:00
EndTime           : 2024-02-02 06:00:00
ScheduledTime     : 2024-02-02 06:00:00
OriginHistoryName : 08584947532854535568834568113CU171
Code              : OK
Status            : Succeeded

Name              : Recurrence
StartTime         : 2024-02-01 06:00:00
EndTime           : 2024-02-01 06:00:00
ScheduledTime     : 2024-02-01 06:00:00
OriginHistoryName : 08584948396849679000001446214CU251
Code              : OK
Status            : Succeeded

Name              : Recurrence
StartTime         : 2024-01-31 06:00:00
EndTime           : 2024-01-31 06:00:00
ScheduledTime     : 2024-01-31 06:00:00
OriginHistoryName : 08584949260853628013416159080CU185
Code              : OK
Status            : Succeeded

PARAMETERS

-Environment

The name of the Power Platform environment or an Environment instance. If omitted, the default environment will be used.

Type: PowerPlatformEnvironmentPipeBind
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: The default environment
Accept pipeline input: True
Accept wildcard characters: False

-Flow

The Name/Id of the flow to retrieve the available runs for.

Type: PowerAutomateFlowPipeBind
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identity

The Name/Id of the flow run to retrieve.

Type: PowerAutomateFlowRunPipeBind
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type: PnPConnection
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Microsoft 365 Patterns and Practices