Get-AdminPowerApp

  • Reference
Module:
Microsoft.PowerApps.Administration.PowerShell

Returns information about one or more apps.

Syntax

Get-AdminPowerApp
   [[-Filter] <String[]>]
   [-EnvironmentName <String>]
   [-Owner <String>]
   [-ApiVersion <String>]
   [<CommonParameters>]
Get-AdminPowerApp
   [[-Filter] <String[]>]
   [-EnvironmentName <String>]
   -Owner <String>
   [-ApiVersion <String>]
   [<CommonParameters>]
Get-AdminPowerApp
   -EnvironmentName <String>
   -AppName <String>
   [-ApiVersion <String>]
   [<CommonParameters>]

Description

The Get-AdminPowerApp cmdlet looks up information about one or more apps depending on parameters. Use Get-Help Get-AdminPowerApp -Examples for more detail.

Examples

EXAMPLE 1

Get-AdminPowerApp

Returns all apps from all environments where the calling user is an environment admin. For global admins, this searches across all environments in the tenant.

EXAMPLE 2

Get-AdminPowerApp *PowerApps*

Returns all apps with the text "PowerApps" from all environments where the calling user is an Environment Admin For Global admins, this will search across all environments in the tenant.

EXAMPLE 3

Get-AdminPowerApp -CreatedBy foo@bar.onmicrosoft.com

Returns all apps created by the user with an email of "foo@bar.onmicrosoft.com" from all environment where the calling user is an environment admin. For global admins, this searches across all environments in the tenant.

EXAMPLE 4

Get-AdminPowerApp -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Finds apps within the 3c2f7648-ad60-4871-91cb-b77d7ef3c239 environment.

EXAMPLE 5

Get-AdminPowerApp *Foobar* -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Finds all app in environment 3c2f7648-ad60-4871-91cb-b77d7ef3c239 that contain the string "Foobar" in their display name.

EXAMPLE 6

Get-AdminPowerApp -AppName 4d1f7648-ad60-4871-91cb-b77d7ef3c239 -EnvironmentName 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Returns the details for the app named 4d1f7648-ad60-4871-91cb-b77d7ef3c239 in Environment 3c2f7648-ad60-4871-91cb-b77d7ef3c239

Parameters

-ApiVersion

The api version to call with.

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

-AppName

Finds a specific ID.

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

-EnvironmentName

Limit apps returned to those in a specified environment by environment ID. Required when using App.

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

-Filter

Finds apps matching the specified filter (wildcards supported).

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

Limit apps returned to those owned by the specified user (you can specify a email address or object id).

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