Get-AdminPowerApp

  • Reference
Module:
Microsoft.PowerApps.Administration.PowerShell

Returns information about 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

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-AdminPowerApp cmdlet looks up information about one or more apps.

Examples

EXAMPLE 1

Get-AdminPowerApp

Returns all apps from all environments where the calling user is an Environment Admin. For Global admins, this command searches across all environments in the tenant.

EXAMPLE 2

Get-AdminPowerApp *PowerApps*

Returns all apps with a name that include the text "PowerApps" from all environments where the calling user is an Environment Admin. For Global admins, this command searches across all environments in the tenant.

EXAMPLE 3

Get-AdminPowerApp -Owner john@contoso.com

Returns all apps created by the user with an email of "john@contoso.com" from all environments where the calling user is an Environment Admin. For Global admins, this command searches across all environments in the tenant.

EXAMPLE 4

Get-AdminPowerApp -EnvironmentName [Guid]

Finds all apps within the specified environment.

EXAMPLE 5

Get-AdminPowerApp *Contoso* -EnvironmentName [Guid]

Finds all apps in the specified environment that contain the string "Contoso" in their display name.

EXAMPLE 6

Get-AdminPowerApp -AppName [Guid] -EnvironmentName [Guid]

Returns the details for the specified app in the specified environment.

Parameters

-ApiVersion

Version of Power Apps API to use.

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

-AppName

ID of the specific app to find.

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

-EnvironmentName

Limit apps returned to those in the specified environment.

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

-Filter

Finds flows matching the specified filters. Wildcards are 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 an email address or object Id.

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