Skip to main content

spo app get

Gets information about the specific app from the specified app catalog

Usage

m365 spo app get [options]

Options

-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. Allowed values: tenant, sitecollection. Defaults to tenant.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

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 the specified ID available in the tenant app catalog.

m365 spo app get --id b2307a39-e878-458b-bc90-03bc578531d6

Return details about the app with the specified name available in the tenant app catalog. Will try to detect the app catalog URL.

m365 spo app get --name solution.sppkg

Return details about the app with the specified name available in the tenant app catalog using the specified app catalog URL.

m365 spo app get --name solution.sppkg --appCatalogUrl https://contoso.sharepoint.com/sites/apps

Return details about the app with the specified ID available in the site collection app catalog of the specified site.

m365 spo app get --id b2307a39-e878-458b-bc90-03bc578531d6 --appCatalogScope sitecollection --appCatalogUrl https://contoso.sharepoint.com/sites/site1

Response

{
"AadAppId": "48535560-3cc0-442e-a1b4-94c084b3ff59",
"AadPermissions": "Microsoft Graph, Directory.ReadWrite.All",
"AppCatalogVersion": "1.6.0.0",
"CanUpgrade": false,
"CDNLocation": "SharePoint Online",
"ContainsTenantWideExtension": false,
"CurrentVersionDeployed": true,
"Deployed": true,
"ErrorMessage": "No errors.",
"ID": "b05196d4-65a3-4ee3-bf92-4acfb7a05cd7",
"InstalledVersion": "",
"IsClientSideSolution": true,
"IsEnabled": true,
"IsPackageDefaultSkipFeatureDeployment": true,
"IsValidAppPackage": true,
"ProductId": "1e5954e2-fc1c-4501-8678-27a6bd013422",
"ShortDescription": "spfx description",
"SkipDeploymentFeature": false,
"StoreAssetId": "",
"SupportsTeamsTabs": true,
"ThumbnailUrl": "",
"Title": "spfx-client-side-solution"
}

More information

CTRL + M