Get-AdminPowerAppConnectionRoleAssignment

Module:: Microsoft.PowerApps.Administration.PowerShell

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

Syntax

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

Description

The Get-AdminPowerAppConnectionRoleAssignment cmdlet returns all roles assignments for an connection or all connection 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) . Use Get-Help Get-AdminPowerAppConnectionRoleAssignment -Examples for more detail.

Examples

EXAMPLE 1

Get-AdminPowerAppConnectionRoleAssignment

Returns all connection role assignments for the calling user.

EXAMPLE 2

Get-AdminPowerAppConnectionRoleAssignment -ConnectionName 3b4b9592607147258a4f2fb33517e97a -ConnectorName shared_sharepointonline -EnvironmentName ee1eef10-ba55-440b-a009-ce379f86e20c

Returns all role assignments for the connection with name 3b4b9592607147258a4f2fb33517e97ain environment with name ee1eef10-ba55-440b-a009-ce379f86e20c for the connector named shared_sharepointonline.

EXAMPLE 3

Get-AdminPowerAppConnectionRoleAssignment -ConnectionName 3b4b9592607147258a4f2fb33517e97a -ConnectorName shared_sharepointonline -EnvironmentName ee1eef10-ba55-440b-a009-ce379f86e20c -PrincipalObjectId aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Returns all role assignments for the user, or group with an object of 00000000-0000-0000-0000-000000000000 for the connection with name 3b4b9592607147258a4f2fb33517e97ain environment with name 00000000-0000-0000-0000-000000000000 for the connector named shared_sharepointonline.

Parameters

-ApiVersion

The api version to call with.

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

-ConnectionName

The connection identifier.

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

-ConnectorName

The connection's connector identifier.

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

-EnvironmentName

The connections's environment ID.

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

-PrincipalObjectId

The objectId of a user or group, if specified, this function will only return role assignments for that user or group.

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

Share via