Get-AdminPowerAppConnectionRoleAssignment

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

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

Syntax

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

Description

The Get-AdminPowerAppConnectionRoleAssignment cmdlet returns all roles assignments for a connection or all connection role assignments for a user (across all of their connections). Role assignments for a connection 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-AdminPowerAppConnectionRoleAssignment

Returns all connection role assignments for the calling user.

EXAMPLE 2

Get-AdminPowerAppConnectionRoleAssignment -ConnectionName [Guid] -ConnectorName shared_sharepointonline -EnvironmentName [Guid]

Returns all role assignments for the specified connection in the specified environment for the connector named shared_sharepointonline.

EXAMPLE 3

Get-AdminPowerAppConnectionRoleAssignment -ConnectionName [Guid] -ConnectorName shared_sharepointonline -EnvironmentName [Guid] -PrincipalObjectId [Guid]

Returns all role assignments for the user or group with the specified object ID for the specified connection in the specified environment for the connector named shared_sharepointonline.

Parameters

-ApiVersion

Version of Power Apps API to use.

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

-ConnectionName

ID of the connection.

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

-ConnectorName

ID of the connection's connector.

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

-EnvironmentName

ID of the connection's environment.

Type:	String
Position:	Named
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:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False