Skip to content

Latest commit

 

History

History
283 lines (246 loc) · 15.7 KB

File metadata and controls

283 lines (246 loc) · 15.7 KB

import Global from '../../_global.mdx'; import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

pa app get

Gets information about the specified Microsoft Power App

Usage

m365 pa app get [options]

Options

`-n, --name [name]`
: The name of the Microsoft Power App to get information about.

`-d, --displayName [displayName]`
: The display name of the Microsoft Power App to get information about.

`--asAdmin`
: Run the command as admin for apps you don't have permission to.

`-e, --environmentName [environmentName]`
: The name of the environment. Required when using `asAdmin`.

Remarks

:::warning

This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.

:::

As a maker, you are able to retrieve the Power Apps you have permission to. As an administrator, you are also able to retrieve Power Apps from other users you don't have permission to. To get the app from another user, use the asAdmin option and make sure to specify the environment option as well.

If you try to retrieve a non-existing Microsoft Power App, you will get the Request failed with status code 404 error.

Examples

Get information about the specified Microsoft Power App by the app's name.

m365 pa app get --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d

Get information about the specified Microsoft Power App by the app's display name.

m365 pa app get --displayName App

Get information about the specific app you do not have access to.

m365 pa app get --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin

Response

{
  "name": "37ea6004-f07b-46ca-8ef3-a256b67b4dbb",
  "id": "/providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb",
  "type": "Microsoft.PowerApps/apps",
  "tags": {
    "primaryDeviceWidth": "1366",
    "primaryDeviceHeight": "768",
    "supportsPortrait": "true",
    "supportsLandscape": "true",
    "primaryFormFactor": "Tablet",
    "publisherVersion": "3.22102.32",
    "minimumRequiredApiVersion": "2.2.0",
    "hasComponent": "false",
    "hasUnlockedComponent": "false",
    "isUnifiedRootApp": "false",
    "sienaVersion": "20221025T212812Z-3.22102.32.0"
  },
  "properties": {
    "appVersion": "2022-10-25T21:28:12Z",
    "lastDraftVersion": "2022-10-25T21:28:12Z",
    "lifeCycleId": "Published",
    "status": "Ready",
    "createdByClientVersion": {
      "major": 3,
      "minor": 22102,
      "build": 32,
      "revision": 0,
      "majorRevision": 0,
      "minorRevision": 0
    },
    "minClientVersion": {
      "major": 3,
      "minor": 22102,
      "build": 32,
      "revision": 0,
      "majorRevision": 0,
      "minorRevision": 0
    },
    "owner": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "contoso",
      "email": "[email protected]",
      "type": "User",
      "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "userPrincipalName": "[email protected]"
    },
    "createdBy": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "contoso",
      "email": "[email protected]",
      "type": "User",
      "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "userPrincipalName": "[email protected]"
    },
    "lastModifiedBy": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "contoso",
      "email": "[email protected]",
      "type": "User",
      "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "userPrincipalName": "[email protected]"
    },
    "lastPublishedBy": {
      "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
      "displayName": "contoso",
      "email": "[email protected]",
      "type": "User",
      "tenantId": "e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "userPrincipalName": "[email protected]"
    },
    "backgroundColor": "RGBA(0,176,240,1)",
    "backgroundImageUri": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zddd642012aba4021a4886c8e21a3e1cb/logoSmallFile?sv=2018-03-28&sr=c&sig=cOkbwChyhCO%2BEJpqMDRxrXaxRoPD1TbTy%2B%2BFkdJEOjI%3D&se=2022-12-24T10%3A06%3A27Z&sp=rl",
    "teamsColorIconUrl": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000ze297221f3dc643ed9686b72b22d9a414/teamscoloricon.png?sv=2018-03-28&sr=c&sig=Fhk8E0LO4Lw0mHvNawCF5Ld7GHzPHo9l7RxvZbeZY48%3D&se=2022-12-24T10%3A06%3A27Z&sp=rl",
    "teamsOutlineIconUrl": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000ze297221f3dc643ed9686b72b22d9a414/teamsoutlineicon.png?sv=2018-03-28&sr=c&sig=Fhk8E0LO4Lw0mHvNawCF5Ld7GHzPHo9l7RxvZbeZY48%3D&se=2022-12-24T10%3A06%3A27Z&sp=rl",
    "displayName": "Test application",
    "description": "",
    "commitMessage": "",
    "appUris": {
      "documentUri": {
        "value": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zddd642012aba4021a4886c8e21a3e1cb/document.msapp?sv=2018-03-28&sr=c&sig=laSGdpZL03POyAABXvdsyxv8YDDB8JPZIBccztIe39Q%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl",
        "readonlyValue": "https://pafeblobprodam-secondary.blob.core.windows.net/20221025t000000zddd642012aba4021a4886c8e21a3e1cb/document.msapp?sv=2018-03-28&sr=c&sig=laSGdpZL03POyAABXvdsyxv8YDDB8JPZIBccztIe39Q%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl"
      },
      "imageUris": [],
      "additionalUris": []
    },
    "createdTime": "2022-10-25T21:28:12.7171469Z",
    "lastModifiedTime": "2022-10-25T21:28:12.7456297Z",
    "lastPublishTime": "2022-10-25T21:28:12Z",
    "sharedGroupsCount": 0,
    "sharedUsersCount": 0,
    "appOpenProtocolUri": "ms-apps:///providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb",
    "appOpenUri": "https://apps.powerapps.com/play/e/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/a/37ea6004-f07b-46ca-8ef3-a256b67b4dbb?tenantId=e1dd4023-a656-480a-8a0e-c1b1eec51e1d&hint=296b0ef7-b4d0-4124-b835-f9c220a1f4bc",
    "appPlayUri": "https://apps.powerapps.com/play/e/default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/a/37ea6004-f07b-46ca-8ef3-a256b67b4dbb?tenantId=e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
    "appPlayEmbeddedUri": "https://apps.powerapps.com/play/e/default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/a/37ea6004-f07b-46ca-8ef3-a256b67b4dbb?tenantId=e1dd4023-a656-480a-8a0e-c1b1eec51e1d&hint=296b0ef7-b4d0-4124-b835-f9c220a1f4bc&telemetryLocation=eu",
    "appPlayTeamsUri": "https://apps.powerapps.com/play/e/default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/a/37ea6004-f07b-46ca-8ef3-a256b67b4dbb?tenantId=e1dd4023-a656-480a-8a0e-c1b1eec51e1d&source=teamstab&hint=296b0ef7-b4d0-4124-b835-f9c220a1f4bc&telemetryLocation=eu&locale={locale}&channelId={channelId}&channelType={channelType}&chatId={chatId}&groupId={groupId}&hostClientType={hostClientType}&isFullScreen={isFullScreen}&entityId={entityId}&subEntityId={subEntityId}&teamId={teamId}&teamType={teamType}&theme={theme}&userTeamRole={userTeamRole}",
    "userAppMetadata": {
      "favorite": "NotSpecified",
      "includeInAppsList": true
    },
    "isFeaturedApp": false,
    "bypassConsent": false,
    "isHeroApp": false,
    "environment": {
      "id": "/providers/Microsoft.PowerApps/environments/default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d",
      "name": "default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d"
    },
    "appPackageDetails": {
      "playerPackage": {
        "value": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl",
        "readonlyValue": "https://pafeblobprodam-secondary.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl"
      },
      "webPackage": {
        "value": "https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl",
        "readonlyValue": "https://pafeblobprodam-secondary.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl"
      },
      "unauthenticatedWebPackage": {
        "value": "https://pafeblobprodam.blob.core.windows.net/alt20221025t000000z529d41282a634bf6b94383dde5a8d52c/20221025T212824Z/index.web.html"
      },
      "documentServerVersion": {
        "major": 3,
        "minor": 22102,
        "build": 33,
        "revision": 0,
        "majorRevision": 0,
        "minorRevision": 0
      },
      "appPackageResourcesKind": "Split",
      "packagePropertiesJson": "{\"cdnUrl\":\"https://content.powerapps.com/resource/app\",\"preLoadIdx\":\"https://content.powerapps.com/resource/app/kdfj31mdao7t9/preloadindex.web.html\",\"id\":\"638023301009567627\",\"v\":2.1}",
      "id": "20221025t000000zac5237a2672a4782ad5a7d71040c032bhttps://pafeblobprodam.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rlhttps://pafeblobprodam.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rlhttps://pafeblobprodam.blob.core.windows.net/alt20221025t000000z529d41282a634bf6b94383dde5a8d52c/20221025T212824Z/index.web.html"
    },
    "almMode": "Environment",
    "performanceOptimizationEnabled": true,
    "unauthenticatedWebPackageHint": "296b0ef7-b4d0-4124-b835-f9c220a1f4bc",
    "canConsumeAppPass": true,
    "enableModernRuntimeMode": false,
    "executionRestrictions": {
      "isTeamsOnly": false,
      "dataLossPreventionEvaluationResult": {
        "status": "Compliant",
        "lastEvaluationDate": "2022-10-25T21:28:30.2281817Z",
        "violations": [],
        "violationsByPolicy": [],
        "violationErrorMessage": "De app gebruikt de volgende connectors: ."
      }
    },
    "appPlanClassification": "Standard",
    "usesPremiumApi": false,
    "usesOnlyGrandfatheredPremiumApis": true,
    "usesCustomApi": false,
    "usesOnPremiseGateway": false,
    "usesPcfExternalServiceUsage": false,
    "isCustomizable": true
  },
  "appLocation": "europe",
  "appType": "ClassicCanvasApp",
  "displayName": "PowerApps Application",
  "description": "App Description",
  "appVersion": "2022-10-25T21:28:12Z",
  "owner": "[email protected]"
}
appLocation: europe
appType    : ClassicCanvasApp
appVersion : 2022-10-25T21:28:12Z
description: App Description
displayName: PowerApps Application
id         : /providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb
name       : 37ea6004-f07b-46ca-8ef3-a256b67b4dbb
owner      : [email protected]
properties : {"almMode":"Environment","appOpenProtocolUri":"ms-apps:///providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb","appOpenUri":"https://apps.powerapps.com/play/e/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/a/37ea6004-f07b-46ca-8ef3-a256b67b4dbb?tenantId=e1dd4023-a656-480a-8a0e-c1b1eec51e1d&hint=296b0ef7-b4d0-4124-b835-f9c220a1f4bc","appPackageDetails":{"appPackageResourcesKind":"Split","documentServerVersion":{"build":33,"major":3,"majorRevision":0,"minor":22102,"minorRevision":0,"revision":0},"id":"20221025t000000zac5237a2672a4782ad5a7d71040c032bhttps://pafeblobprodam.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rlhttps://pafeblobprodam.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rlhttps://pafeblobprodam.blob.core.windows.net/alt20221025t000000z529d41282a634bf6b94383dde5a8d52c/20221025T212824Z/index.web.html","packagePropertiesJson":"{\"cdnUrl\":\"https://content.powerapps.com/resource/app\",\"id\":\"638023301009567627\",\"preLoadIdx\":\"https://content.powerapps.com/resource/app/kdfj31mdao7t9/preloadindex.web.html\",\"v\":2.1}","playerPackage":{"readonlyValue":"https://pafeblobprodam-secondary.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl","value":"https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/player.msappk?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl"},"unauthenticatedWebPackage":{"value":"https://pafeblobprodam.blob.core.windows.net/alt20221025t000000z529d41282a634bf6b94383dde5a8d52c/20221025T212824Z/index.web.html"},"webPackage":{"readonlyValue":"https://pafeblobprodam-secondary.blob.core.windows.net/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl","value":"https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zac5237a2672a4782ad5a7d71040c032b/5b38cd68-a930-4a14-be71-c622de887d1a/web/index.web.html?sv=2018-03-28&sr=c&sig=eztEkTd1pFaFEITA%2Bqqj2XCpxwgeujMC7FahMmEkujA%3D&se=2022-11-04T12%3A00%3A00Z&sp=rl"}},"backgroundColor":"RGBA(0,176,240,1)","backgroundImageUri":"https://pafeblobprodam.blob.core.windows.net:443/20221025t000000zddd642012aba4021a4886c8e21a3e1cb/logoSmallFile?sv=2018-03-28&sr=c&sig=cOkbwChyhCO%2BEJpqMDRxrXaxRoPD1TbTy%2B%2BFkdJEOjI%3D&se=2022-12-24T10%3A06%3A27Z&sp=rl","bypassConsent":false,"canConsumeAppPass":true}
tags       : {"hasComponent":"false","hasUnlockedComponent":"false","isUnifiedRootApp":"false","minimumRequiredApiVersion":"2.2.0","primaryDeviceHeight":"768","primaryDeviceWidth":"1366","primaryFormFactor":"Tablet","publisherVersion":"3.22102.32","supportsLandscape":"true","supportsPortrait":"true"}
type       : Microsoft.PowerApps/apps
name,displayName,description,appVersion,owner
37ea6004-f07b-46ca-8ef3-a256b67b4dbb,PowerApps Application,App Description,2022-10-25T21:28:12Z,[email protected]
# pa app get --displayName "PowerApps Application"

Date: 9/1/2023

## PowerApps Application (/providers/Microsoft.PowerApps/apps/fe36f75e-c103-410b-a18a-2bf6df06ac3a)

Property | Value
---------|-------
name | fe36f75e-c103-410b-a18a-2bf6df06ac3a
id | /providers/Microsoft.PowerApps/apps/fe36f75e-c103-410b-a18a-2bf6df06ac3a
type | Microsoft.PowerApps/apps
appLocation | europe
appType | ClassicCanvasApp
displayName | PowerApps Application
description | App Description
appVersion | 2022-10-25T21:28:12Z
owner | [email protected]