Set-AdminPowerAppConnectorRoleAssignment
Sets permissions to the custom connectors.
Syntax
Set-AdminPowerAppConnectorRoleAssignment
-ConnectorName <String>
-EnvironmentName <String>
-RoleName <String>
-PrincipalType <String>
-PrincipalObjectId <String>
[-ApiVersion <String>]
[<CommonParameters>] Set-AdminPowerAppConnectorRoleAssignment
-ConnectorName <String>
-EnvironmentName <String>
-RoleName <String>
-PrincipalType <String>
[-PrincipalObjectId <String>]
[-ApiVersion <String>]
[<CommonParameters>] Description
The Set-AdminPowerAppConnectorRoleAssignment cmdlet sets up permission to custom connectors depending on the parameters. Use Get-Help Set-AdminPowerAppConnectorRoleAssignment -Examples for more detail.
Examples
EXAMPLE 1
Set-AdminPowerAppConnectorRoleAssignment -ConnectorName shared_testapi.5f0629412a7d1fe83e.5f6f049093c9b7a698 -EnvironmentName 0fc02431-15fb-4563-a5ab-8211beb2a86f -RoleName CanView -PrincipalType User -PrincipalObjectId a9f34b89-b7f2-48ef-a3ca-1c435bc655a0Gives the specified user CanView permissions to the connector with ID shared_testapi.5f0629412a7d1fe83e.5f6f049093c9b7a698.
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 |
-ConnectorName
The custom connector's identifier.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-EnvironmentName
The connectors's environment ID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrincipalObjectId
If this connector is being shared with a user or security group principal, this field specifies the ObjectId for that principal.
Use the Get-UsersOrGroupsFromGraph cmdlet to look-up the ObjectId for a user or group in Microsoft Entra ID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PrincipalType
Specifies the type of principal this connector is being shared with; a user, a security group, or the entire tenant.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RoleName
Specifies the permission level given to the connector: CanView, CanViewWithShare, CanEdit.
Sharing with the entire tenant is only supported for CanView.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |