Share via


Get-AdminPowerAppRoleAssignment

Returns permission information about one or more apps.

Syntax

User (Default)

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

Environment

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

App

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

Description

The Get-AdminPowerAppRoleAssignment cmdlet returns permission information about one or more apps. Use Get-Help Get-AdminPowerAppRoleAssignment -Examples for more detail.

Examples

EXAMPLE 1

Get-AdminPowerAppRoleAssignments -UserId 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Returns all app role assignments across all environments for the user with an object ID of 00aa00aa-bb11-cc22-dd33-44ee44ee44ee.

EXAMPLE 2

Get-AdminPowerAppRoleAssignments -EnvironmentName 00000000-0000-0000-0000-000000000000 -UserId 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Returns all app role assignments within environment with id 00000000-0000-0000-0000-000000000000 for the user with an object ID of 00aa00aa-bb11-cc22-dd33-44ee44ee44ee.

EXAMPLE 3

Get-AdminPowerAppRoleAssignments -AppName 00001111-aaaa-2222-bbbb-3333cccc4444 -EnvironmentName 00000000-0000-0000-0000-000000000000 -UserId 00aa00aa-bb11-cc22-dd33-44ee44ee44ee

Returns all role assignments for the app with ID 00001111-aaaa-2222-bbbb-3333cccc4444 in environment 00000000-0000-0000-0000-000000000000 for the user with an object ID of 00aa00aa-bb11-cc22-dd33-44ee44ee44ee.

EXAMPLE 4

Get-AdminPowerAppRoleAssignments -AppName 00001111-aaaa-2222-bbbb-3333cccc4444 -EnvironmentName 00000000-0000-0000-0000-000000000000

Returns all role assignments for the app with ID 00001111-aaaa-2222-bbbb-3333cccc4444 in environment 00000000-0000-0000-0000-000000000000.

Parameters

-ApiVersion

The api version to call with.

Parameter properties

Type:String
Default value:2016-11-01
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AppName

Finds a specific ID.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

App
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-EnvironmentName

Limit apps returned to those in a specified environment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Environment
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False
App
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-UserId

A object ID of the user you want to filter by.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

User
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Environment
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.