Set-AdminPowerAppConnectionRoleAssignment

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

Sets permissions to the connection.

Syntax

Set-AdminPowerAppConnectionRoleAssignment
   [-ConnectionName] <String>
   -ConnectorName <String>
   -EnvironmentName <String>
   -RoleName <String>
   -PrincipalType <String>
   -PrincipalObjectId <String>
   [-ApiVersion <String>]
   [<CommonParameters>]

Set-AdminPowerAppConnectionRoleAssignment
   [-ConnectionName] <String>
   -ConnectorName <String>
   -EnvironmentName <String>
   -RoleName <String>
   -PrincipalType <String>
   [-PrincipalObjectId <String>]
   [-ApiVersion <String>]
   [<CommonParameters>]

Description

The cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

The Set-AdminPowerAppConnectionRoleAssignment cmdlet sets permission to connection.

Examples

EXAMPLE 1

Set-AdminPowerAppConnectionRoleAssignment -PrincipalType Group -PrincipalObjectId [Guid] -RoleName CanEdit -ConnectionName [Guid] -ConnectorName shared_vsts -EnvironmentName Default-[Guid]

Gives the specified security group CanEdit permissions to the specified connection in the specified default environment.

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 to update.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ConnectorName

Name of the connection's connector.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-EnvironmentName

ID of the environment of the connection.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PrincipalObjectId

Object ID of the user or security group principal to share the connection. You can use the Get-UsersOrGroupsFromGraph cmdlet to look up the object ID for a user or group in Azure Active Directory.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrincipalType

Type of principal that the connection is being shared with: a user, a security group, or the entire tenant. Valid options are User, Group.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-RoleName

Permission level given to the connection. Options are CanView, CanViewWithShare, CanEdit. Sharing with the entire tenant is supported only for CanView.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False