Get-AdminPowerAppConnectorRoleAssignment

Module:
Microsoft.PowerApps.Administration.PowerShell

Returns the connection role assignments for a user or a custom connection.

Syntax

Get-AdminPowerAppConnectorRoleAssignment
   [[-ConnectorName] <String>]
   [[-EnvironmentName] <String>]
   [[-PrincipalObjectId] <String>]
   [[-ApiVersion] <String>]
   [<CommonParameters>]

Description

The Get-AdminConnectorRoleAssignment cmdlet returns all roles assignments for an custom connector or all custom connectors roles assignments for a user (across all of their connections). A connection's role assignments determine which users have access to the connection for using or building apps and flows and with which permission level (CanUse, CanUseAndShare). Owner role assignments cannot be deleted without deleting the connection resource.

Examples

EXAMPLE 1

Get-AdminPowerAppConnectorRoleAssignment

Returns all role assignments for all custom connectors in all environments.

EXAMPLE 2

Get-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_customapi2.[Guid]

Returns all role assignments for the connector with name shared_customapi2.[Guid] in all environments.

EXAMPLE 3

Get-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_customapi2.[Guid] -EnvironmentName [Guid] -PrincipalObjectId [Guid]

Returns all role assignments for the user or group with the specified principal object ID for the custom connector with name shared_customapi2.[Guid] in the specified environment.

Parameters

-ApiVersion

Version of Power Apps API to use.

Type:String
Position:4
Default value:2017-06-01
Accept pipeline input:False
Accept wildcard characters:False
-ConnectorName

Id of the connector.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EnvironmentName

Id of the environment of the connector.

Type:String
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PrincipalObjectId

Object Id of a user or group. If you specify this parameter, this command returns role assignments for only that user or group.

Type:String
Position:3
Default value:None
Accept pipeline input:False
Accept wildcard characters:False