Κοινή χρήση μέσω

Power Apps for Admins

  • Reference

Power Apps Management Connector for Administrators

This connector is available in the following products and regions:

Service Class Regions
Power Automate Standard All Power Automate regions
Power Apps Standard All Power Apps regions
Contact
Name Microsoft
URL Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://admin.powerapps.com/

Throttling Limits

Name Calls Renewal Period
API calls per connection 1000 60 seconds

Actions

Edit App Role Assignment as Admin

Sets permissions for a PowerApp.
Edit Connection Role Assignment as Admin

Sets permissions for a Connection.
Edit Connector Role Assignment as Admin

Sets permissions for a Connector.
Get App as Admin

Returns a PowerApp.
Get App Role Assignments as Admin

Returns permissions for a PowerApp.
Get Apps as Admin

Returns a list of apps.
Get Connection Role Assignments as Admin

Returns all permissions for a Connection.
Get Connections as Admin

Returns a list of Connections.
Get Connector Role Assignments as Admin

Returns permissions for a custom Connector.
Get Custom Connectors as Admin

Returns a list of custom Connectors.
Get PowerApp Conditional Access

Gets a PowerApp's conditional access properties.
Remove App as Admin

Deletes a PowerApp.
Remove Connection as Admin

Deletes a Connection.
Set App Owner

Updates a PowerApp's owner role, and specifies the old owner's new role.
Set App Quarantine State

Updates a PowerApp's quarantine state.
Set PowerApp Conditional Access

Updates a PowerApp's conditional access.

Edit App Role Assignment as Admin

Operation ID:
Edit-AdminAppRoleAssignment

Sets permissions for a PowerApp.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.
Filter Query
 $filter string

A filter query parameter.
Role Name
 roleName string

The name of the permission role. Choose from CanView, CanViewWithShare, and CanEdit.
capabilities
 capabilities array of string

capabilities
Notify Share Target Option
 NotifyShareTargetOption string

Notifies the new user if provided the string value 'Notify'.
Principal Email
 email string

The principal email of the user.
Principal Object ID
 id string

The principal object ID of the user.
Principal Type
 type string

The principal type of the user.
Tenant ID
 tenantId string

The principal tenant ID of the user.
Role ID
 id string

The ID field of the Role Assignment.

Returns

Name Path Type Description
put
 put array of object

App Role Assignment put object.
id
 put.id string

App Role Assignment ID field.
roleName
 put.properties.roleName string

App Role Assignment property roleName.
scope
 put.properties.scope string

App Role Assignment property scope.
id
 put.properties.principal.id string

App Role Assignment principal object ID.
email
 put.properties.principal.email string

App Role Assignment principal email.
type
 put.properties.principal.type string

App Role Assignment principal type.
resourceResponses
 put.properties.resourceResponses array of object

App Role Assignment resourceResponse object.
id
 put.properties.resourceResponses.id string

App Role Assignment resourceResponse ID.
statusCode
 put.properties.resourceResponses.statusCode string

App Role Assignment resourceResponse statusCode.
responseCode
 put.properties.resourceResponses.responseCode string

App Role Assignment resourceResponse responseCode.
message
 put.properties.resourceResponses.message string

App Role Assignment resourceResponse message.
type
 put.properties.resourceResponses.type string

App Role Assignment resourceResponse type.

Edit Connection Role Assignment as Admin

Operation ID:
Edit-AdminConnectionRoleAssignment

Sets permissions for a Connection.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
Connector Name
 connector True string

Name field of the Connector.
Connection Name
 connection True string

Name field of the Connection.
API Version
 api-version string

The date value of the API version.
Field Content Type
 Content-Type string

The content type of the API request.
Role ID
 id string

The ID field of the Role Assignment.
Role Name
 roleName string

The name of the permission role.
Principal ID
 id string

The principal ID of the user.

Edit Connector Role Assignment as Admin

Operation ID:
Edit-AdminConnectorRoleAssignment

Sets permissions for a Connector.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
Connector Name
 connectorName True string

Name field of the Connector.
API Version
 api-version string

The date value of the API version.
Field Content Type
 Content-Type string

The content type of the API request.
Role ID
 id string

The ID field of the Role Assignment.
Role Name
 roleName string

The name of the role.
Principal Object ID
 id string

The principal object ID of the user.

Get App as Admin

Operation ID:
Get-AdminApp

Returns a PowerApp.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.

Returns

Body
PowerApp

Get App Role Assignments as Admin

Operation ID:
Get-AdminAppRoleAssignment

Returns permissions for a PowerApp.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of App Role Assignments in the response.

Returns

Name Path Type Description
value
 value array of object

PowerApp Role Assignment value array.
Name
 value.name string

PowerApp Role Assignment name field.
id
 value.id string

PowerApp Role Assignment ID field.
type
 value.type string

PowerApp Role Assignment type field.
roleName
 value.properties.roleName string

PowerApp Role Assignment roleName.
id
 value.properties.principal.id string

PowerApp Role Assignment principal object ID.
displayName
 value.properties.principal.displayName string

PowerApp Role Assignment principal displayName.
email
 value.properties.principal.email string

PowerApp Role Assignment principal email.
type
 value.properties.principal.type string

PowerApp Role Assignment principal type.
scope
 value.properties.scope string

PowerApp Role Assignment scope.
Notify Share Target Option
 value.properties.notifyShareTargetOption string

PowerApp Role Assignment notifyShareTargetOption.

Get Apps as Admin

Operation ID:
Get-AdminApps

Returns a list of apps.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of Apps in the response.
Skip token
 $skiptoken string

Used to get next page of responses.

Returns

Body
ResourceArray[PowerApp]

Get Connection Role Assignments as Admin

Operation ID:
Get-AdminConnectionRoleAssignment

Returns all permissions for a Connection.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
Connector Name
 connectorName True string

Name field of the Connector.
Connection Name
 connectionName True string

Name field of the Connection.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of Connection Role Assignments in the response.

Returns

Name Path Type Description
value
 value array of object

Connection Role Assignment value array.
name
 value.name string

Connection Role Assignment name field.
id
 value.id string

Connection Role Assignment ID field.
type
 value.type string

Connection Role Assignment type field.
roleName
 value.properties.roleName string

Connection Role Assignment role name.
id
 value.properties.principal.id string

Connection Role Assignment principal object ID.
displayName
 value.properties.principal.displayName string

Connection Role Assignment principal displayName.
email
 value.properties.principal.email string

Connection Role Assignment principal email.
type
 value.properties.principal.type string

Connection Role Assignment principal type.
notifyShareTargetOption
 value.properties.notifyShareTargetOption string

Connection Role Assignment notify share target option.

Get Connections as Admin

Operation ID:
Get-AdminConnections

Returns a list of Connections.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of Connections in the response.

Returns

Name Path Type Description
value
 value array of object

Connection value array.
name
 value.name string

Connection name field.
id
 value.id string

Connection ID field.
type
 value.type string

Connection type field.
apiId
 value.properties.apiId string

Connection property apiId.
displayName
 value.properties.displayName string

Connection property displayName.
iconUri
 value.properties.iconUri string

Connection icon URI.
statuses
 value.properties.statuses array of object

Connection statuses.
status
 value.properties.statuses.status string

Connection status.
target
 value.properties.statuses.target string

Connection status target.
code
 value.properties.statuses.error.code string

Connection status error code.
message
 value.properties.statuses.error.message string

Connection status error message.
sku
 value.properties.connectionParameters.sku string

Connection parameter sku.
workflowName
 value.properties.connectionParameters.workflowName string

Connection parameter workflow name.
workflowPath
 value.properties.connectionParameters.workflowPath string

Connection parameter workflow path.
workflowEndpoint
 value.properties.connectionParameters.workflowEndpoint string

Connection parameter workflow endpoint.
workFlowCallbackUri
 value.properties.connectionParameters.workFlowCallbackUri string

Connection parameter workFlow Callback URI.
server
 value.properties.connectionParameters.server string

Connection parameter server.
database
 value.properties.connectionParameters.database string

Connection parameter database.
keywordsRemaining
 value.properties.keywordsRemaining integer

Connection property keywordsRemaining.
id
 value.properties.createdBy.id string

Connection creator principal object ID.
displayName
 value.properties.createdBy.displayName string

Connection creator principal display name.
email
 value.properties.createdBy.email string

Connection creator principal email.
type
 value.properties.createdBy.type string

Connection creator principal type.
tenantId
 value.properties.createdBy.tenantId string

Connection creator principal tenantId.
userPrincipalName
 value.properties.createdBy.userPrincipalName string

Connection creator user principal name.
createdTime
 value.properties.createdTime date-time

Connection created time.
lastModifiedTime
 value.properties.lastModifiedTime date-time

Connection last modified time.
id
 value.properties.environment.id string

Connection Environment ID.
name
 value.properties.environment.name string

Connection Environment name.
expirationTime
 value.properties.expirationTime date-time

Connection property expirationTime.
testLinks
 value.properties.testLinks array of object

Connection property testLinks.
requestUri
 value.properties.testLinks.requestUri string

Connection property testLink requestUri.
method
 value.properties.testLinks.method string

Connection property testLink method

Get Connector Role Assignments as Admin

Operation ID:
Get-AdminConnectorRoleAssignment

Returns permissions for a custom Connector.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
Connector Name
 connectorName True string

Name field of the Connector.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of Connector Role Assignments in the response.

Returns

Name Path Type Description
value
 value array of object

value
name
 value.name string

Connector Role Assignment name field.
id
 value.id string

Connector Role Assignment ID field.
type
 value.type string

Connector Role Assignment type field.
roleName
 value.properties.roleName string

Connector Role Assignment role name.
id
 value.properties.principal.id string

Connector Role Assignment principal object ID.
displayName
 value.properties.principal.displayName string

Connector Role Assignment principal displayName.
email
 value.properties.principal.email string

Connector Role Assignment principal email.
type
 value.properties.principal.type string

Connector Role Assignment principal type.
notifyShareTargetOption
 value.properties.notifyShareTargetOption string

The Name field of the notifyShareTargetOption.

Get Custom Connectors as Admin

Operation ID:
Get-AdminConnectors

Returns a list of custom Connectors.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
API Version
 api-version string

The date value of the API version.
Page size
 $top integer

Number of Custom Connectors in the response.

Returns

Name Path Type Description
value
 value array of object

value
name
 value.name string

Connector name field.
id
 value.id string

Connector id field.
type
 value.type string

Connector type field.
displayName
 value.properties.displayName string

Connector property displayName.
iconUri
 value.properties.iconUri string

Connector icon Uri.
iconBrandColor
 value.properties.iconBrandColor string

Connector icon brand color.
apiEnvironment
 value.properties.apiEnvironment string

Connector api Environment.
isCustomApi
 value.properties.isCustomApi boolean

True if the Connector is a Custom Api.
runtimeUrls
 value.properties.runtimeUrls array of string

runtimeUrls
primaryRuntimeUrl
 value.properties.primaryRuntimeUrl string

Connector primary Runtime Url.
source
 value.properties.metadata.source string

Connector source metadata.
brandColor
 value.properties.metadata.brandColor string

Connector brand Color metadata.
publisherUrl
 value.properties.metadata.publisherUrl string

Connector publisher URL metadata.
serviceUrl
 value.properties.metadata.serviceUrl string

Connector service URL metadata.
documentationUrl
 value.properties.metadata.documentationUrl string

Connector documentation URL.
environment
 value.properties.metadata.environment string

Connector environment metadata.
allowSharing
 value.properties.metadata.allowSharing boolean

Connector allow Sharing field.
capabilities
 value.properties.capabilities array of string

Connector capabilities.
description
 value.properties.description string

Connector description.
originalSwaggerUrl
 value.properties.apiDefinitions.originalSwaggerUrl string

Connector original swagger URL.
modifiedSwaggerUrl
 value.properties.apiDefinitions.modifiedSwaggerUrl string

Connector modified swagger URL.
id
 value.properties.createdBy.id string

Connector creator's principal object ID.
displayName
 value.properties.createdBy.displayName string

Connector creator's principal displayName.
email
 value.properties.createdBy.email string

Connector creator's principal email.
type
 value.properties.createdBy.type string

Connector creator's principal type.
tenantId
 value.properties.createdBy.tenantId string

Connector creator's principal tenantId.
userPrincipalName
 value.properties.createdBy.userPrincipalName string

Connector creator's user principal name.
id
 value.properties.modifiedBy.id string

Connector last modified by principal object ID.
displayName
 value.properties.modifiedBy.displayName string

Connector last modified by principal displayName.
email
 value.properties.modifiedBy.email string

Connector last modified by principal email.
type
 value.properties.modifiedBy.type string

Connector last modified by principal type.
tenantId
 value.properties.modifiedBy.tenantId string

Connector last modified by principal tenantId.
userPrincipalName
 value.properties.modifiedBy.userPrincipalName string

Connector last modified by user principal name.
createdTime
 value.properties.createdTime date-time

Connector created time.
changedTime
 value.properties.changedTime date-time

Connector changed time.
id
 value.properties.environment.id string

Connector Environment ID.
name
 value.properties.environment.name string

Connector Environment name.
tier
 value.properties.tier string

Connector tier.
publisher
 value.properties.publisher string

Connector publisher's principal display name.

Get PowerApp Conditional Access

Operation ID:
Get-PowerAppConditionalAccess

Gets a PowerApp's conditional access properties.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.

Returns

Name Path Type Description
array of string

Conditional Access Properties.

Remove App as Admin

Operation ID:
Remove-AdminApp

Deletes a PowerApp.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.

Remove Connection as Admin

Operation ID:
Remove-AdminConnection

Deletes a Connection.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
Connector Name
 connectorName True string

Name field of the Connector.
Connection Name
 connectionName True string

Name field of the Connection.
API Version
 api-version string

The date value of the API version.

Set App Owner

Operation ID:
Set-AdminAppOwner

Updates a PowerApp's owner role, and specifies the old owner's new role.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.
Content Type
 Content-Type string

The content type of the API request.
Role For Old App Owner
 roleForOldAppOwner string

The role name for the old app owner. Choose from CanView, CanViewWithShare, or CanEdit.
New PowerApp Owner
 newAppOwner string

The principal object ID of the new owner.

Set App Quarantine State

Operation ID:
Set-AppQuarantineState

Updates a PowerApp's quarantine state.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.
Content Type
 Content-Type string

The content type of the API request.
Quarantine Status
 quarantineStatus string

The quarantine status of the app. Choose from NotSpecified, Quarantined, or Unquarantined.

Set PowerApp Conditional Access

Operation ID:
Set-PowerAppConditionalAccess

Updates a PowerApp's conditional access.

Parameters

Name Key Required Type Description
Environment Name
 environment True string

Name field of the Environment.
PowerApp Name
 app True string

Name field of the PowerApp.
API Version
 api-version string

The date value of the API version.
Content Type
 Content-Type string

The content type of the API request.
Auth Context Ids
 authContextIds array of string

Definitions

ResourceArray[PowerApp]

Name Path Type Description
value
 value array of PowerApp
Next Link
 nextLink string

The URL to get the next page of the Apps list. Contains the skiptoken.

PowerApp

Name Path Type Description
id
 id string

PowerApp ID field.
name
 name string

PowerApp name field.
appVersion
 properties.appVersion date-time

PowerApp property appVersion.
major
 properties.createdByClientVersion.major integer

PowerApp property createdByClientVersion major.
minor
 properties.createdByClientVersion.minor integer

PowerApp property createdByClientVersion minor.
build
 properties.createdByClientVersion.build integer

PowerApp property createdByClientVersion build.
revision
 properties.createdByClientVersion.revision integer

PowerApp property createdByClientVersion revision.
majorRevision
 properties.createdByClientVersion.majorRevision integer

PowerApp property createdByClientVersion majorRevision.
minorRevision
 properties.createdByClientVersion.minorRevision integer

PowerApp property createdByClientVersion minorRevision.
major
 properties.minClientVersion.major integer

PowerApp property minClientVersion major.
minor
 properties.minClientVersion.minor integer

PowerApp property minClientVersion minor.
build
 properties.minClientVersion.build integer

PowerApp property minClientVersion build.
revision
 properties.minClientVersion.revision integer

PowerApp property minClientVersion revision.
majorRevision
 properties.minClientVersion.majorRevision integer

PowerApp property minClientVersion majorRevision.
minorRevision
 properties.minClientVersion.minorRevision integer

PowerApp property minClientVersion minorRevision.
id
 properties.owner.id string

PowerApp owner principal user ID.
displayName
 properties.owner.displayName string

PowerApp owner principal displayName.
email
 properties.owner.email string

PowerApp owner principal email.
type
 properties.owner.type string

PowerApp owner principal type.
tenantId
 properties.owner.tenantId string

PowerApp owner principal tenantId.
userPrincipalName
 properties.owner.userPrincipalName string

PowerApp owner principal userPrincipalName.
id
 properties.createdBy.id string

PowerApp creator principal object ID.
displayName
 properties.createdBy.displayName string

PowerApp creator principal displayName.
email
 properties.createdBy.email string

PowerApp creator principal email.
type
 properties.createdBy.type string

PowerApp creator principal type.
tenantId
 properties.createdBy.tenantId string

PowerApp creator principal tenantId.
userPrincipalName
 properties.createdBy.userPrincipalName string

PowerApp creator principal userPrincipalName.
id
 properties.lastModifiedBy.id string

PowerApp last modified by principal object ID.
displayName
 properties.lastModifiedBy.displayName string

PowerApp last modified by principal displayName.
email
 properties.lastModifiedBy.email string

PowerApp last modified by principal email.
type
 properties.lastModifiedBy.type string

PowerApp last modified by principal type.
tenantId
 properties.lastModifiedBy.tenantId string

PowerApp last modified by principal tenantId.
userPrincipalName
 properties.lastModifiedBy.userPrincipalName string

PowerApp last modified by principal userPrincipalName.
backgroundColor
 properties.backgroundColor string

PowerApp backgroundColor.
backgroundImageUri
 properties.backgroundImageUri string

PowerApp backgroundImageUri.
displayName
 properties.displayName string

PowerApp displayName.
description
 properties.description string

PowerApp description.
value
 properties.appUris.documentUri.value string

PowerApp appUri documentUri value.
readonlyValue
 properties.appUris.documentUri.readonlyValue string

PowerApp appUri documentUri readonlyValue.
imageUris
 properties.appUris.imageUris array of string

PowerApp appUri imageUris array.
createdTime
 properties.createdTime date-time

PowerApp property createdTime.
lastModifiedTime
 properties.lastModifiedTime date-time

PowerApp property lastModifiedTime.
sharedGroupsCount
 properties.sharedGroupsCount integer

PowerApp property sharedGroupsCount.
sharedUsersCount
 properties.sharedUsersCount integer

PowerApp property sharedUsersCount.
appOpenProtocolUri
 properties.appOpenProtocolUri string

PowerApp property appOpenProtocolUri.
appOpenUri
 properties.appOpenUri string

PowerApp property appOpenUri.
favorite
 properties.userAppMetadata.favorite string

PowerApp property userAppMetadata favorite.
includeInAppsList
 properties.userAppMetadata.includeInAppsList boolean

PowerApp property userAppMetadata includeInAppsList.
isFeaturedApp
 properties.isFeaturedApp boolean

PowerApp property isFeaturedApp.
bypassConsent
 properties.bypassConsent boolean

PowerApp property bypassConsent.
isHeroApp
 properties.isHeroApp boolean

PowerApp property isHeroApp.
id
 properties.environment.id string

PowerApp Environment ID.
name
 properties.environment.name string

PowerApp Environment name.
connectionReferences
 properties.connectionReferences ConnectionReferences
primaryDeviceWidth
 tags.primaryDeviceWidth string

PowerApp tag primaryDeviceWidth.
primaryDeviceHeight
 tags.primaryDeviceHeight string

PowerApp tag primaryDeviceHeight.
sienaVersion
 tags.sienaVersion string

PowerApp tag sienaVersion.
deviceCapabilities
 tags.deviceCapabilities string

PowerApp tag deviceCapabilities.
supportsPortrait
 tags.supportsPortrait string

PowerApp tag supportsPortrait.
supportsLandscape
 tags.supportsLandscape string

PowerApp tag supportsLandscape.
primaryFormFactor
 tags.primaryFormFactor string

PowerApp tag primaryFormFactor.
publisherVersion
 tags.publisherVersion string

PowerApp tag publisherVersion.
minimumRequiredApiVersion
 tags.minimumRequiredApiVersion date-time

PowerApp tag minimumRequiredApiVersion.
type
 type string

PowerApp type field.

ConnectionReferences

Name Path Type Description
Items
 ConnectionReference

ConnectionReference

Name Path Type Description
Connector Id
 id string
Connector display name
 displayName string
Icon URI
 iconUri string
Data sources
 dataSources array of string

List of data sources for the connection
Dependencies
 dependencies array of string

List of dependencies for the connection
Dependents
 dependents array of string

List of dependant connectors for the connector
Is on premise connection
 isOnPremiseConnection boolean

Flag indicates on premise data gateway
Bypass consent
 bypassConsent boolean

Flag indicates bypassed api consent
API tier
 apiTier string

Api tier is standard or premium
Custom API flag
 isCustomApiConnection boolean

Flag indicates custom connector
Runtime Policy Name
 runtimePolicyName string

String indicating the name of the runtime policy
Execution Restrictions
 executionRestrictions object

Execution restrictions for the runtime policy
Shared Connection Id
 sharedConnectionId string

String indicating the id of the shared connection