Set-AdminPowerAppConnectorRoleAssignment

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

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-1c435bc655a0

Gives 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