Get-PnPFlow
SYNOPSIS
Required Permissions
- Azure: management.azure.com
- Azure Service Management : user_impersonation
- Dynamics CRM : user_impersonation
- PowerApps Service : User
- Link to Required permissions reference : https://pnp.github.io/powershell/articles/determinepermissions.html#help-i-cant-figure-out-which-permissions-i-need
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_impersonationscope - PowerApps Service API -
Userscope (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