Share via


Get-AdminPowerAppConnectorRoleAssignment

Returns the connection role assignments for a user or a custom connection. Owner role assignments can't be deleted without deleting the connection resource.

Syntax

Default (Default)

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

Description

The Get-AdminConnectorRoleAssignment cmdlet returns all roles assignments for a custom connector or all custom connectors' roles assignments for a user (across all of their connections). A connection's role assignments determines which users have access to the connection for using or building apps and flows and with which permission level (CanUse, CanUseAndShare) . Use Get-Help Get-AdminPowerAppConnectorRoleAssignment -Examples for more detail.

Examples

EXAMPLE 1

Get-AdminPowerAppConnectorRoleAssignment

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

EXAMPLE 2

Get-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698

Returns all role assignments for the connector with name shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 in all environments

EXAMPLE 3

Get-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 -EnvironmentName bbbbbbbb-1111-2222-3333-cccccccccccc -PrincipalObjectId aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Returns all role assignments for the user, or group with an principal object ID of aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb for the custom connector with name shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 in environment with name bbbbbbbb-1111-2222-3333-cccccccccccc.

Parameters

-ApiVersion

The api version to call with.

Parameter properties

Type:String
Default value:2017-06-01
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:4
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ConnectorName

The connector's identifier.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-EnvironmentName

The connector's environment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PrincipalObjectId

The object ID of a user or group, if specified, this parameter only returns role assignments for that user or group.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.