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
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-AdminPowerAppConnectorRoleAssignmentReturns all role assignments for all custom connectors in all environments.
EXAMPLE 2
Get-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698Returns 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 0fc02431-15fb-4563-a5ab-8211beb2a86f -PrincipalObjectId a1caec2d-8b48-40cc-8eb8-5cf95b445b46Returns all role assignments for the user, or group with an principal object ID of a1caec2d-8b48-40cc-8eb8-5cf95b445b46 for the custom connector with name shared_customapi2.5f0629412a7d1fe83e.5f6f049093c9b7a698 in environment with name 0fc02431-15fb-4563-a5ab-8211beb2a86f.
Parameters
-ApiVersion
The api version to call with.
| Type: | String |
| Position: | 4 |
| Default value: | 2017-06-01 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectorName
The connector's identifier.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnvironmentName
The connector's environment.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrincipalObjectId
The object ID of a user or group, if specified, this parameter only returns role assignments for that user or group.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |