Get-AdminPowerAppRoleAssignment

Reference

Module:: Microsoft.PowerApps.Administration.PowerShell

Returns permission information about apps.

Syntax

Get-AdminPowerAppRoleAssignment
   -UserId <String>
   [-ApiVersion <String>]
   [<CommonParameters>]

Get-AdminPowerAppRoleAssignment
   -EnvironmentName <String>
   -UserId <String>
   [-ApiVersion <String>]
   [<CommonParameters>]

Get-AdminPowerAppRoleAssignment
   -EnvironmentName <String>
   -AppName <String>
   [-UserId <String>]
   [-ApiVersion <String>]
   [<CommonParameters>]

Description

This 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 Get-AdminPowerAppRoleAssignment cmdlet returns permission information about one or more apps.

Examples

EXAMPLE 1

Get-AdminPowerAppRoleAssignments -UserId [Guid]

Returns all app role assignments across all environments for the user with the specified object ID.

EXAMPLE 2

Get-AdminPowerAppRoleAssignments -EnvironmentName [Guid] -UserId [Guid]

Returns all app role assignments within the specified environment for the user with the specified object ID.

EXAMPLE 3

Get-AdminPowerAppRoleAssignments -AppName [Guid] -EnvironmentName [Guid] -UserId [Guid]

Returns all role assignments for the specified app in the specified environment for the user with the specified object ID.

EXAMPLE 4

Get-AdminPowerAppRoleAssignments -AppName [Guid] -EnvironmentName [Guid]

Returns all role assignments for the specified app in the environment.

Parameters

-ApiVersion

Version of Power Apps API to use.

Type:	String
Position:	Named
Default value:	2016-11-01
Accept pipeline input:	False
Accept wildcard characters:	False

-AppName

ID of the specific app to find.

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

-EnvironmentName

Limit apps returned to those in a specified environment.

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

-UserId

Object ID of the user you want to filter by.

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