@pnp/cli-microsoft365 6.8.0 → 6.9.0-beta.1cd2525

package/docs/docs/cmd/spo/app/app-add.mdx

@@ -0,0 +1,63 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app add
+
+Adds an app to the specified SharePoint Online app catalog
+
+## Usage
+
+```sh
+m365 spo app add [options]
+```
+
+## Options
+
+```md definition-list
+`-p, --filePath <filePath>`
+: Absolute or relative path to the solution package file to add to the app catalog
+
+`--overwrite`
+: Set to overwrite the existing package file
+
+`-s, --appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: The URL of the app catalog where the solution package will be added. It must be specified when the scope is `sitecollection`
+```
+
+<Global />
+
+## Remarks
+
+When specifying the path to the app package file you can use both relative and absolute paths. Note, that `~` in the path, will not be resolved and will most likely result in an error.
+
+When adding an app to the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to add the app to a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+If you try to upload a package that already exists in the app catalog without specifying the `--overwrite` option, the command will fail with an error stating that the specified package already exists.
+
+## Examples
+
+Add the _spfx.sppkg_ package to the tenant app catalog
+
+```sh
+m365 spo app add --filePath /Users/pnp/spfx/sharepoint/solution/spfx.sppkg
+```
+
+Overwrite the _spfx.sppkg_ package in the tenant app catalog with the newer version
+
+```sh
+m365 spo app add --filePath sharepoint/solution/spfx.sppkg --overwrite
+```
+
+Add the _spfx.sppkg_ package to the site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_
+
+```sh
+m365 spo app add --filePath c:\spfx.sppkg --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-deploy.mdx

@@ -0,0 +1,76 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app deploy
+
+Deploys the specified app in the specified app catalog
+
+## Usage
+
+```sh
+m365 spo app deploy [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the app to deploy. Specify the `id` or the `name` but not both
+
+`-n, --name [name]`
+: Name of the app to deploy. Specify the `id` or the `name` but not both
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+
+`--skipFeatureDeployment`
+: If the app supports tenant-wide deployment, deploy it to the whole tenant
+
+`-s, --appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+```
+
+<Global />
+
+## Remarks
+
+When deploying an app in the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to deploy the app in a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error. Before you can deploy an app, you have to add it to the app catalog first using the [spo app add](./app-add.mdx) command.
+
+## Examples
+
+Deploy the specified app in the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically.
+
+```sh
+m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3
+```
+
+Deploy the specified app in the site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_
+
+```sh
+m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
+```
+
+Deploy the app with the specified name in the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically.
+
+```sh
+m365 spo app deploy --name solution.sppkg
+```
+
+Deploy the specified app in the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_
+
+```sh
+m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps
+```
+
+Deploy the specified app to the whole tenant at once. Features included in the solution will not be activated.
+
+```sh
+m365 spo app deploy --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --skipFeatureDeployment
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-get.mdx

@@ -0,0 +1,65 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app get
+
+Gets information about the specific app from the specified app catalog
+
+## Usage
+
+```sh
+m365 spo app get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: ID of the app to retrieve information for. Specify the `id` or the `name` but not both
+
+`-n, --name [name]`
+: Name of the app to retrieve information for. Specify the `id` or the `name` but not both
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+
+`-s, --appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+```
+
+<Global />
+
+## Remarks
+
+When getting information about an app from the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to get information about an app from a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+## Examples
+
+Return details about the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ available in the tenant app catalog.
+
+```sh
+m365 spo app get --id b2307a39-e878-458b-bc90-03bc578531d6
+```
+
+Return details about the app with name _solution.sppkg_ available in the tenant app catalog. Will try to detect the app catalog URL
+
+```sh
+m365 spo app get --name solution.sppkg
+```
+
+Return details about the app with name _solution.sppkg_ available in the tenant app catalog using the specified app catalog URL
+
+```sh
+m365 spo app get --name solution.sppkg --appCatalogUrl https://contoso.sharepoint.com/sites/apps
+```
+
+Return details about the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ available in the site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.
+
+```sh
+m365 spo app get --id b2307a39-e878-458b-bc90-03bc578531d6 --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-install.mdx

@@ -0,0 +1,48 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app install
+
+Installs an app from the specified app catalog in the site
+
+## Usage
+
+```sh
+m365 spo app install [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the app to install
+
+`-s, --siteUrl <siteUrl>`
+: Absolute URL of the site to install the app in
+
+`--appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+```
+
+<Global />
+
+## Remarks
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error. Before you can install app in a site, you have to add it to the tenant or site collection app catalog first using the [spo app add](./app-add.mdx) command.
+
+## Examples
+
+Install the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ in the _https://contoso.sharepoint.com_ site.
+
+```sh
+m365 spo app install --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+```
+
+Install the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ in the _https://contoso.sharepoint.com_ site from site collection app catalog.
+
+```sh
+m365 spo app install --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --appCatalogScope sitecollection
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-instance-list.mdx

@@ -0,0 +1,28 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app instance list
+
+Retrieve apps installed in a site
+
+## Usage
+
+```sh
+m365 spo app instance list [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --siteUrl <siteUrl>`
+: URL of the site collection to retrieve the apps for
+```
+
+<Global />
+
+## Examples
+
+Return a list of installed apps on site _https://contoso.sharepoint.com/sites/site1_.
+
+```sh
+m365 spo app instance list --siteUrl https://contoso.sharepoint.com/sites/site1
+```

package/docs/docs/cmd/spo/app/app-list.mdx

@@ -0,0 +1,49 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app list
+
+Lists apps from the specified app catalog
+
+## Usage
+
+```sh
+m365 spo app list [options]
+```
+
+## Options
+
+```md definition-list
+`-s, --appCatalogScope [appCatalogScope]`
+: Target app catalog. `tenant,sitecollection`. Default `tenant`
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+```
+
+<Global />
+
+## Remarks
+
+When listing information about apps available in the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to list information about apps in a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+When using the text output type (default), the command lists only the values of the `Title`, `ID`, `Deployed` and `AppCatalogVersion` properties of the app. When setting the output type to JSON, all available properties are included in the command output.
+
+## Examples
+
+Return the list of available apps from the tenant app catalog. Show the installed version in the site if applicable.
+
+```sh
+m365 spo app list
+```
+
+Return the list of available apps from a site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.
+
+```sh
+m365 spo app list --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-remove.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app remove
+
+Removes the specified app from the specified app catalog
+
+## Usage
+
+```sh
+m365 spo app remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the app to remove. Needs to be available in the app catalog
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+
+`-s, --appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+
+`--confirm`
+: Don't prompt for confirming removing the app
+```
+
+<Global />
+
+## Remarks
+
+When removing an app from the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to remove the app from a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error.
+
+## Examples
+
+Remove the specified app from the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically. Additionally, will prompt for confirmation before actually retracting the app.
+
+```sh
+m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3
+```
+
+Remove the specified app from the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_. Additionally, will prompt for confirmation before actually retracting the app.
+
+```sh
+m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps
+```
+
+Remove the specified app from the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_. Don't prompt for confirmation.
+
+```sh
+m365 spo app remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps --confirm
+```
+
+Remove the specified app from a site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.
+
+```sh
+m365 spo app remove --id d95f8c94-67a1-4615-9af8-361ad33be93c --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1/AppCatalog
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-retract.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app retract
+
+Retracts the specified app from the specified app catalog
+
+## Usage
+
+```sh
+m365 spo app retract [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the app to retract. Needs to be available in the app catalog.
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant or site collection app catalog. It must be specified when the scope is `sitecollection`
+
+`-s, --appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+
+`--confirm`
+: Don't prompt for confirming retracting the app
+```
+
+<Global />
+
+## Remarks
+
+When getting information about an app from the tenant app catalog, it's not necessary to specify the tenant app catalog URL. When the URL is not specified, the CLI will try to resolve the URL itself. Specifying the app catalog URL is required when you want to get information about an app from a site collection app catalog.
+
+When specifying site collection app catalog, you can specify the URL either with our without the _AppCatalog_ part, for example `https://contoso.sharepoint.com/sites/team-a/AppCatalog` or `https://contoso.sharepoint.com/sites/team-a`. CLI will accept both formats.
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error.
+
+## Examples
+
+Retract the specified app from the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically. Additionally, will prompt for confirmation before actually retracting the app.
+
+```sh
+m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3
+```
+
+Retract the specified app from the tenant app catalog located at _https://contoso.sharepoint.com/sites/apps_. Additionally, will prompt for confirmation before actually retracting the app.
+
+```sh
+m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --appCatalogUrl https://contoso.sharepoint.com/sites/apps
+```
+
+Retract the specified app from the tenant app catalog. Try to resolve the URL of the tenant app catalog automatically. Will not prompt for confirmation before retracting the app.
+
+```sh
+m365 spo app retract --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --confirm
+```
+
+Retract the specified app from a site collection app catalog of site _https://contoso.sharepoint.com/sites/site1_.
+
+```sh
+m365 spo app retract --id d95f8c94-67a1-4615-9af8-361ad33be93c --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-teamspackage-download.mdx

@@ -0,0 +1,60 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app teamspackage download
+
+Downloads Teams app package for an SPFx solution deployed to tenant app catalog
+
+## Usage
+
+```sh
+m365 spo app teamspackage download [options]
+```
+
+## Options
+
+```md definition-list
+`--appItemUniqueId [appItemUniqueId]`
+: The unique ID of the SPFx app to download the Teams package for. Specify `appItemUniqueId`, `appItemId` or `appName`
+
+`--appItemId [appItemId]`
+: The ID of the list item behind the SPFx app to download the Teams package for. Specify `appItemUniqueId`, `appItemId` or `appName`
+
+`--appName [appName]`
+: The name of the sppkg file to download the Teams package for. Specify `appItemUniqueId`, `appItemId` or `appName`
+
+`--fileName [fileName]`
+: Name of the file to save the package to. If not specified will use the name of the sppkg file with a `.zip` extension
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the tenant app catalog. If not specified, the command will try to autodiscover it
+```
+
+<Global />
+
+## Remarks
+
+Download the Teams app package for an SPFx solution works only for solutions deployed to the tenant app catalog.
+
+If you try to download Teams app package for an SPFx solution that doesn't support deployment to Teams, you'll get the _Request failed with status code 404_ error.
+
+For maximum performance, specify the URL of the tenant app catalog, the item ID (`appItemId`) of the SPFx package for which you want to download the Teams app package and the name of the file where you want to save the downloaded package to (`fileName`).
+
+## Examples
+
+Downloads the Teams app package for the SPFx solution deployed to the tenant app catalog with the ID `1` to a file with .zip extension named after the .sppkg file:
+
+```sh
+m365 spo app teamspackage download --appItemId 1
+```
+
+Downloads the Teams app package for the SPFx solution deployed to the tenant app catalog with the unique item ID `335a5612-3e85-462d-9d5b-c014b5abeac5` to the specified file:
+
+```sh
+m365 spo app teamspackage download --appItemUniqueId 335a5612-3e85-462d-9d5b-c014b5abeac5 --fileName my-app.zip
+```
+
+Downloads the Teams app package for the SPFx solution deployed to the specified tenant app catalog:
+
+```sh
+m365 spo app teamspackage download --appName my-app.sppkg --appCatalogUrl https://contoso.sharepoint.com/sites/appcatalog
+```

package/docs/docs/cmd/spo/app/app-uninstall.mdx

@@ -0,0 +1,57 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app uninstall
+
+Uninstalls an app from the site
+
+## Usage
+
+```sh
+m365 spo app uninstall [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the app to uninstall
+
+`-s, --siteUrl <siteUrl>`
+: Absolute URL of the site to uninstall the app from
+
+`--appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+
+`--confirm`
+: Don't prompt for confirming uninstalling the app
+```
+
+<Global />
+
+## Remarks
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error.
+
+## Examples
+
+Uninstall the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ from the _https://contoso.sharepoint.com_ site.
+
+```sh
+m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+```
+
+Uninstall the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ from the _https://contoso.sharepoint.com_ site without prompting for confirmation.
+
+```sh
+m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+```
+
+Uninstall the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ from the _https://contoso.sharepoint.com_ site where the app is deployed to the site collection app catalog of _https://contoso.sharepoint.com_.
+
+```sh
+m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --appCatalogScope sitecollection
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)

package/docs/docs/cmd/spo/app/app-upgrade.mdx

@@ -0,0 +1,48 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spo app upgrade
+
+Upgrades app in the specified site
+
+## Usage
+
+```sh
+m365 spo app upgrade [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id <id>`
+: ID of the app to upgrade
+
+`-s, --siteUrl <siteUrl>`
+: Absolute URL of the site to upgrade the app in
+
+`--appCatalogScope [appCatalogScope]`
+: Scope of the app catalog: `tenant,sitecollection`. Default `tenant`
+```
+
+<Global />
+
+## Remarks
+
+If the app with the specified ID doesn't exist in the app catalog, the command will fail with an error.
+
+## Examples
+
+Upgrade the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ in the _https://contoso.sharepoint.com_ site.
+
+```sh
+m365 spo app upgrade --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
+```
+
+Upgrade the app with ID _b2307a39-e878-458b-bc90-03bc578531d6_ in the _https://contoso.sharepoint.com_ site from site collection app catalog.
+
+```sh
+m365 spo app upgrade --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --appCatalogScope sitecollection
+```
+
+## More information
+
+- Application Lifecycle Management (ALM) APIs: [https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins](https://docs.microsoft.com/en-us/sharepoint/dev/apis/alm-api-for-spfx-add-ins)