Add-PnPApp

Add/uploads an available app to the app catalog

Syntax

Add-PnPApp
   -Path <String>
             [-Scope <AppCatalogScope>]
             [-Overwrite [<SwitchParameter>]]
             [-Timeout <Int>]
             [-Connection <SPOnlineConnection>]
Add-PnPApp
   -Path <String>
             -Publish [<SwitchParameter>]
             [-SkipFeatureDeployment [<SwitchParameter>]]
             [-Scope <AppCatalogScope>]
             [-Overwrite [<SwitchParameter>]]
             [-Timeout <Int>]
             [-Connection <SPOnlineConnection>]

Examples

------------------EXAMPLE 1------------------

Add-PnPApp -Path ./myapp.sppkg

This will upload the specified app package to the app catalog

------------------EXAMPLE 2------------------

Add-PnPApp -Path ./myapp.sppkg -Publish

This will upload the specified app package to the app catalog and deploy/trust it at the same time.

------------------EXAMPLE 3------------------

Add-PnPApp -Path ./myapp.sppkg -Scope Site -Publish

This will upload the specified app package to the site collection app catalog and deploy/trust it at the same time.

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.

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:SPOnlineConnection
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Overwrite

Overwrites the existing app package if it already exists

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Path

Specifies the Id or an actual app metadata instance

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:String
Position:0
Accept pipeline input:True
Accept wildcard characters:False
-Publish

This will deploy/trust an app into the app catalog

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Scope

Defines which app catalog to use. Defaults to Tenant

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:AppCatalogScope
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-SkipFeatureDeployment

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:SwitchParameter
Position:Named
Accept pipeline input:False
Accept wildcard characters:False
-Timeout

Specifies the timeout in seconds. Defaults to 200.

Only applicable to: SharePoint Online, SharePoint Server 2019

Type:Int
Position:Named
Accept pipeline input:False
Accept wildcard characters:False

Outputs

OfficeDevPnP.Core.ALM.AppMetadata