Get-AdminPowerAppConnectionRoleAssignment
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 |