Get-PnPApp

Tip

We encourage you to make improvements to this documentation. Please navigate to https://github.com/pnp/powershell/blob/dev/documentation/Get-PnPApp.md to change this file.

Returns the available apps from the app catalog

Syntax

Get-PnPApp
   [[-Identity] <AppMetadataPipeBind>]
   [-Scope <AppCatalogScope>]
   [-Connection <PnPConnection>]
   [<CommonParameters>]

Examples

EXAMPLE 1

Get-PnPApp

This will return all available apps from the tenant app catalog. It will list the installed version in the current site.

EXAMPLE 2

Get-PnPApp -Scope Site

This will return all available apps from the site collection scoped app catalog. It will list the installed version in the current site.

EXAMPLE 3

Get-PnPApp -Identity 2646ccc3-6a2b-46ef-9273-81411cbbb60f

This will retrieve the specific app from the app catalog.

Parameters

-Connection

Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.

Type:PnPConnection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Identity

Specifies the Id of an app which is available in the app catalog

Type:AppMetadataPipeBind
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Scope

Defines which app catalog to use. Defaults to Tenant

Type:AppCatalogScope
Accepted values:Tenant, Site
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False