Share via

Set-AdminPowerAppAsHero

  • Reference
Module:
Microsoft.PowerApps.Administration.PowerShell

Identifies the specified app as a hero application. Hero apps appear at the top of the app list in the Power Apps mobile player.

Syntax

PowerShell 
Set-AdminPowerAppAsHero
   -AppName <String>
   [-ApiVersion <String>]
   [<CommonParameters>]
PowerShell 
Set-AdminPowerAppAsHero
   [-ApiVersion <String>]
   [-ForceLease <Boolean>]
   [<CommonParameters>]

Description

The Set-AdminPowerAppAsHero cmdlet changes the isHero flag of a app to true. Hero apps appear at the top of the app list in the Power Apps mobile player and there can only be one hero app designated within the tenant. The specified app must be set as a featured app to be set as a hero. Use Set-AdminPowerAppAsFeatured to set an app as featured. Use Get-Help Set-AdminPowerAppAsHero -Examples for more detail.

Examples

EXAMPLE 1

PowerShell 
Set-AdminPowerAppAsHero -PowerAppName c3dba9c8-0f42-4c88-8110-04b582f20735

Updates the specified app to be the hero application of that tenant.

Parameters

-ApiVersion

PowerApps Api version date, defaults to "2017-05-01."

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

-AppName

App ID of PowerApp to operate on.

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

-ForceLease

Forces the lease when overwriting the Power Apps fields. Defaults to false if no input is provided.

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False