Share via


Set-AdminPowerAppAsHero

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

Name (Default)

Set-AdminPowerAppAsHero
    -AppName <String>
    [-ApiVersion <String>]
    [<CommonParameters>]

Filter

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

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."

Parameter properties

Type:String
Default value:2017-05-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

App ID of PowerApp to operate on.

Parameter properties

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

Parameter sets

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

-ForceLease

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

Parameter properties

Type:Boolean
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

Filter
Position:Named
Mandatory:False
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.