Get-AdminPowerAppConnectionRoleAssignment
Returns the connection role assignments for a user or a connection. Owner role assignments can't be deleted without deleting the connection resource.
Syntax
Default (Default)
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.
Parameter properties
| Type: | String |
| Default value: | 2017-06-01 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ConnectionName
The connection 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 |
-ConnectorName
The connection's connector identifier.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-EnvironmentName
The connections's environment ID.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-PrincipalObjectId
The objectId of a user or group, if specified, this function will only return role assignments for that user or group.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| 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.