Now available in public preview are four new Connectors that let you access resources in the Power Platform in an Admin or Maker scope. These Connectors are accompanying the Flow Management Connector, which gives you just about as much control over access to these resources as we have.

 

About

Similar to the PowerShell cmdlets for PowerApps, we have exposed the Power Platform APIs as Standard Connectors so you can more easily interact with PowerApps and Flow resources within PowerApps and Flow. To add these Connectors to your project, search for them like any Connector either in a Canvas App, or add an action in Flow.

The Admin Connectors (Powerplatform for Admins, Microsoft Flow for Admins and PowerApps for Admins) will give the user access to resources tenant-wide, whereas the Maker Connector (PowerApps for App Makers) only gives access to the resources if the user has some ownership of the resource (e.g., Owner, Editor, Shared with, etc.).

 

Prerequisites

Any user with a valid PowerApps license can create a connection to the PowerApps for App Makers Connector.

Creating a connection to Powerplatform for Admins, Microsoft Flow for Admins and PowerApps for Admins Connectors requires the following to work properly. Anyone can create a Connection to the admin Connectors, but will hit an error if they don’t have the correct license.

• A paid PowerApps Plan 2 license or a PowerApps Plan 2 trial license. You can sign-up for a 30-day trial license at http://web.powerapps.com/trial. Trial licenses can be renewed if they've expired.
• Office 365 Global Administrator or Azure Active Directory Global Administrator permissions if you need to search through another user’s resources. (Note that Environment Admins only have access to those environments and environment resources for which they have permissions, and global admins can see all resources across the tenant.)

 

Connector Browser tool

Use this PowerApp that acts as an Connector Browser to test out these Connectors. The purpose of this app is to make it easier to understand how to use each operation. All methods available in the Connectors are implemented and ready for use. Read through the provided definitions and example images to see how to implement these operations.

Download the Connector Browser tool export package here and import it into your Environment.

To run the operations, choose one of the connector functions on the left side of the screen, make sure all input parameters have values, and click the submit button. To view the implementations, open the tool in the studio and view the OnSelect property of the ‘SUBMIT’ button that runs the operations. Read the descriptions and look at the images provided by clicking the camera button on the right hand side of the description panel.

 

 

 

Example Scenario: Scheduled Flow to Get list of new PowerApps and Flows

A new Flow template using the admin Connectors is also new available. Use this template to generate reports of new PowerApps, Flows and Connectors that have been created over a specified time interval.

You can find the template here.

 

 

 

Connectors and Operations

 

 

Read, delete Environments	Get-AdminEnvironment Remove-AdminEnvironment
Create, read, update, delete Environment Role Assignments	Get-AdminEnvironmentRoleAssignment Edit-AdminEnvironmentRoleAssignment
Read, update DLP Policies	Get-AdminDlpPolicy Edit-AdminDlpPolicy

 

 

 

Update, delete Flows	Enable-AdminFlow Disable-AdminFlow Remove-AdminFlow
Create, read, update, delete Flow Role Assignments	Get-AdminFlowOwnerRole Edit-AdminFlowOwnerRole
Read, delete Flow User Details	Get-AdminFlowUserDetails Remove-AdminFlowUserDetails
Delete Flow Approvals	Remove-AdminFlowApproval

 

 

 

Read, delete PowerApps (Canvas)	Get-AdminApp Get-AdminApps Remove-AdminApp
Create, read, update, delete App Role Assignments	Get-AdminAppRoleAssignment Set-AdminAppOwner Edit-AdminAppRoleAssignment
Read Custom Connectors	Get-AdminConnectors
Create, read, update, delete Admin Connector Role Assignments	Get-AdminApp Get-AdminConnectorRoleAssignment Edit-AdminConnectorRoleAssignment
Read, delete Connections	Get-AdminConnections Remove-AdminConnections
Create, read, update, delete Connection Role Assignments	Get-AdminConnectionRoleAssignment Edit-AdminConnectionRoleAssignment

 

 

 

Read, update, delete PowerApps (Canvas)	Get-App Get-Apps Remove-App Publish-App Set-AppDisplayName
Create, read, update, delete App Role Assignments	Get-AppRoleAssignment Edit-AppRoleAssignment
Read, restore App Versions	Get-AppVersions Restore-AppVersion
Read Connectors	Get-Connector Get-Connectors
Create, read, update, delete Connector Role Assignments	Get-ConnectorRoleAssignment Edit-ConnectorRoleAssignment
Read, delete Connections	Get-Connections Remove-Connection
Create, read, update, delete Connection Role Assignments	Get-ConnectionRoleAssignment Edit-ConnectionRoleAssignment
Read Environments (where user is admin)	Get-Environments

 

Known Issues

Limitation on page size

Some operations that return a large payload of items will be paged, so not all items are returned on the first request. To get the next page requires a skiptoken from the nextLink field if it’s provided in the response (example implantation provided in the API Browser below). Here are the operations affected by this:

• Power Platform for Admins / Get-AdminEnvironment (page size: 15)
• PowerApps for Admins / Get-AdminApps (page size: 100)