Table of Contents

Get-PnPFlow

SYNOPSIS

Required Permissions

Returns Power Automate Flows

SYNTAX

All (Default)

Get-PnPFlow [-Environment <PowerAutomateEnvironmentPipeBind>] [-AsAdmin] [-SharingStatus <FlowSharingStatus>] [-Connection <PnPConnection>] [-Verbose]

By Identity

Get-PnPFlow [-Environment <PowerAutomateEnvironmentPipeBind>] [-AsAdmin] [-Identity <PowerPlatformPipeBind>] [-Connection <PnPConnection>] [-Verbose]

DESCRIPTION

This cmdlet returns Power Automate Flows meeting the specified criteria.

Prerequisites

Your Entra app registration must have the user_impersonation delegated permission from the Azure Service Management API. To add this permission using Azure CLI:

az ad app permission add --id <your-app-id> --api 797f4846-ba00-4fd7-ba43-dac1f8f63013 --api-permissions 41094075-9dad-400e-a0bd-54e686782033=Scope
az ad app permission admin-consent --id <your-app-id>

For full Power Platform access, you may also need to add permissions from:

  • Dynamics CRM API (00000007-0000-0000-c000-000000000000) - user_impersonation scope
  • PowerApps Service API - User scope (can be found under "APIs my organization uses" in Azure Portal)

EXAMPLES

Example 1

Get-PnPFlow -AsAdmin

Returns all the flows in the default Power Platform environment belonging to any user

Example 2

Get-PnPPowerPlatformEnvironment -Identity "MyOrganization (default)" | Get-PnPFlow

Returns all the flows for a given Power Platform environment belonging to the current user

Example 3

Get-PnPFlow -SharingStatus SharedWithMe

Returns all the flows which have been shared with the current user in the default Power Platform environment

Example 4

Get-PnPFlow -Identity fba63225-baf9-4d76-86a1-1b42c917a182

Returns a specific flow from the default Power Platform environment

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

-Identity

The Name/Id of the flow to retrieve.

Type: PowerPlatformPipeBind
Parameter Sets: By Identity
Aliases:

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

-AsAdmin

If specified returns all the flows as admin. If not specified only the flows for the current user will be returned.

Type: SwitchParameter
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

-SharingStatus

Allows specifying the type of Power Automate Flows that should be returned. Valid values: All, SharedWithMe, Personal.

Type: FlowSharingStatus
Parameter Sets: All

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

-Verbose

When provided, additional debug statements will be shown while executing the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)

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

Microsoft 365 Patterns and Practices

Edit this page