@pnp/cli-microsoft365 10.4.0 → 10.5.0-beta.31351d1

package/dist/utils/entraApp.js

@@ -1,6 +1,8 @@
 import fs from 'fs';
 import request from '../request.js';
 import { odata } from './odata.js';
+import { formatting } from './formatting.js';
+import { cli } from '../cli/cli.js';
 async function getCertificateBase64Encoded({ options, logger, debug }) {
     if (options.certificateBase64Encoded) {
         return options.certificateBase64Encoded;
@@ -278,6 +280,32 @@ export const entraApp = {
             await logger.logToStderr(`OAuth2 permissions: ${JSON.stringify(entraApp.appPermissions.flatMap(permission => permission.scope), null, 2)}`);
         }
         return resolvedApis;
+    },
+    async getAppRegistrationByAppId(appId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications?$filter=appId eq '${appId}'`;
+        if (properties) {
+            url += `&$select=${properties.join(',')}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `App with appId '${appId}' not found in Microsoft Entra ID`;
+        }
+        return apps[0];
+    },
+    async getAppRegistrationByAppName(appName, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications?$filter=displayName eq '${formatting.encodeQueryParameter(appName)}'`;
+        if (properties) {
+            url += `&$select=${properties.join(',')}`;
+        }
+        const apps = await odata.getAllItems(url);
+        if (apps.length === 0) {
+            throw `App with name '${appName}' not found in Microsoft Entra ID`;
+        }
+        if (apps.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', apps);
+            return await cli.handleMultipleResultsFound(`Multiple apps with name '${appName}' found in Microsoft Entra ID.`, resultAsKeyValuePair);
+        }
+        return apps[0];
     }
 };
 //# sourceMappingURL=entraApp.js.map

package/docs/docs/cmd/booking/business/business-get.mdx

@@ -137,6 +137,19 @@ m365 booking business get --name 'business name'
   email             : runningdevadmin@contoso.onmicrosoft.com
   id                : Accounting@contoso.onmicrosoft.com
   phone             :
+  address           : {city:"",countryOrRegion:"",postalCode:"",state:"",street:""}
+  businessHours     : [{day:"monday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"tuesday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"wednesday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"thursday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"friday",timeSlots:[{endTime:"17:00:00.0000000",startTime:"08:00:00.0000000"}]},{day:"saturday",timeSlots:[]},{day:"sunday",timeSlots:[]}]
+  businessType      : "Financial services"
+  defaultCurrencyIso: "USD"
+  displayName       : "Accounting"
+  email             : "runningdevadmin@contoso.onmicrosoft.com"
+  id                : "Accounting@contoso.onmicrosoft.com"
+  isPublished       : true
+  languageTag       : ""
+  phone             : ""
+  publicUrl         : "https://outlook.office365.com/owa/calendar/Accounting@contoso.onmicrosoft.com/bookings/"
+  schedulingPolicy  : {allowStaffSelection:true,maximumAdvance:"P365D",minimumLeadTime:"P1D",sendConfirmationsToOwner:true,timeSlotInterval:"PT30M"}
+  webSiteUrl        : ""
   ```
 
   </TabItem>

package/docs/docs/cmd/entra/user/user-guest-add.mdx

@@ -105,6 +105,17 @@ m365 entra user guest add --emailAddress john.doe@contoso.com --messageLanguage
   resetRedemption        : false
   sendInvitationMessage  : true
   status                 : PendingAcceptance
+  id                     : "35f7f726-c541-4aef-a64e-a7b6868fe47f"
+  inviteRedeemUrl        : "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0"
+  inviteRedirectUrl      : "https://myapplications.microsoft.com/"
+  invitedUser            : {id:"5257b5b2-4056-4a45-a05e-df5c92d53e6e"}
+  invitedUserDisplayName : "John Doe"
+  invitedUserEmailAddress: "john.doe@contoso.com"
+  invitedUserMessageInfo : {ccRecipients:[{emailAddress:{address:"maria.jones@contoso.com",name:null}}],customizedMessageBody:"Hi John, welcome to the organization!",messageLanguage:"en-US"}
+  invitedUserType        : "Guest"
+  resetRedemption        : false
+  sendInvitationMessage  : true
+  status                 : "PendingAcceptance"
   ```
 
   </TabItem>

package/docs/docs/cmd/flow/environment/environment-get.mdx

@@ -137,6 +137,8 @@ m365 flow environment get
   location         : india
   name             : Default-d87a7535-dd31-4437-bfe1-95340acd55c5
   provisioningState: Succeeded
+  properties       : {azureRegionHint:"centralindia",cluster:{category:"Prod",environment:"Prod",geoShortName:"IN",number:"101",uriSuffix:"in-il101.gateway.prod.island"},createdBy:{displayName:"SYSTEM",id:"SYSTEM",type:"NotSpecified"},createdTime:"2019-12-21T18:32:11.8708704Z",creationType:"DefaultTenant",displayName:"contoso (default)",environmentFeatures:{isOpenApiEnabled:false},environmentSku:"Default",environmentType:"NotSpecified",governanceConfiguration:{protectionLevel:"Basic"},isDefault:true,isPayAsYouGoEnabled:false,linkedEnvironmentMetadata:{baseLanguage:1033,createdTime:"2019-12-25T15:46:14.433Z",domainName:"orgfc80770f",friendlyName:"contoso (default)",instanceApiUrl:"https://orgfc80770f.api.crm8.dynamics.com",instanceState:"Ready",instanceUrl:"https://orgfc80770f.crm8.dynamics.com/",resourceId:"3aa550bf-52ac-42fc-98f7-5d1833c1501c",type:"NotSpecified",uniqueName:"orgfc80770f",version:"9.2.22105.00154"},provisioningState:"Succeeded",runtimeEndpoints:{microsoft.ApiManagement:"https://management.INDIA.azure-apihub.net",microsoft.BusinessAppPlatform:"https://india.api.bap.microsoft.com",microsoft.CommonDataModel:"https://india.api.cds.microsoft.com",microsoft.Flow:"https://india.api.flow.microsoft.com",microsoft.PowerApps:"https://india.api.powerapps.com",microsoft.PowerAppsAdvisor:"https://india.api.advisor.powerapps.com",microsoft.PowerVirtualAgents:"https://powervamg.in-il101.gateway.prod.island.powerapps.com"},states:{management:{id:"NotSpecified"},runtime:{id:"Enabled",requestedBy:{displayName:"SYSTEM",type:"NotSpecified"},runtimeReasonCode:"NotSpecified"}}}
+  type             : "Microsoft.ProcessSimple/environments"
   ```
 
   </TabItem>

package/docs/docs/cmd/flow/flow-get.mdx

@@ -284,8 +284,10 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
   actions    : OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem
   description:
   displayName: My Flow
+  id         : /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f
   name       : ca76d7b8-3b76-4050-8c03-9fb310ad172f
   triggers   : OpenApiConnection
+  type       : Microsoft.ProcessSimple/environments/flows
   ```
 
   </TabItem>

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -16,22 +16,22 @@ m365 flow run get [options]
 
 ```md definition-list
 `-n, --name <name>`
-: The name of the run to get information about
+: The name of the run to get information about.
 
 `--flowName <flowName>`
-: The name of the Power Automate flow for which to retrieve information
+: The name of the Power Automate flow for which to retrieve information.
 
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
 `--includeTriggerInformation`
-: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details
+: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.
 
 `--withTrigger`
-: If specified, include information about the trigger details
+: If specified, include information about the trigger details.
 
 `--withActions [withActions]`
-: If specified, include information about all actions when no action names are specified, or provide a specified list of actions separated by commas to include only the relevant action details
+: If specified, include information about all actions when no action names are specified, or provide a specified list of actions separated by commas to include only the relevant action details.
 
 ```
 
@@ -55,13 +55,13 @@ If the option `withTrigger` is specified, but the trigger does not contain an ou
 
 ## Examples
 
-Get information about the given run of the specified Power Automate flow
+Get information about the given run of the specified Power Automate flow.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
 ```
 
-Get information about the given run of the specified Power Automate flow including trigger information
+Get information about the given run of the specified Power Automate flow including trigger information.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withTrigger
@@ -73,7 +73,7 @@ Get information about the given run of the specified Power Automate flow includi
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withActions
 ```
 
-Get information about the given run of the specified Power Automate flow including exclusively the details of 'Action_Internal_Name1' and 'Action_Internal_Name2' actions
+Get information about the given run of the specified Power Automate flow including exclusively the details of 'Action_Internal_Name1' and 'Action_Internal_Name2' actions.
 
 ```sh
 m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --withActions "Action_Internal_Name1,Action_Internal_Name2"
@@ -137,11 +137,15 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
   <TabItem value="Text">
 
   ```text
-  endTime    : 2023-03-04T09:05:22.5880202Z
-  name       : 08585236861638480597867166179CU104
-  startTime  : 2023-03-04T09:05:21.8066368Z
-  status     : Succeeded
-  triggerName: When_an_email_is_flagged_(V4)
+  correlation: {"clientTrackingId":"08585329112602833829909892130CU00"}
+  endTime    : 
+  id         : /providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17
+  name       : 08585329112602833828909892130CU17
+  properties : {"correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"startTime":"2022-11-17T14:33:45.2763872Z","status":"Running","trigger":{"correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"endTime":"2022-11-17T14:33:45.1914506Z","inputsLink":{"contentHash":{"algorithm":"md5","value":"6ZrBBE+MJg7IvhMgyJLMmA=="},"contentSize":349,"contentVersion":"6ZrBBE+MJg7IvhMgyJLMmA==","uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerInputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig="},"name":"When_a_new_response_is_submitted","originHistoryName":"08585329112602833829909892130CU00","outputsLink":{"contentHash":{"algorithm":"md5","value":"Z/4a8tfYygNAR1xpc44iww=="},"contentSize":493,"contentVersion":"Z/4a8tfYygNAR1xpc44iww==","uri":"https://prod-08.centralindia.logic.azure.com:443/workflows/f7bf8f6b5c494e63bfc21b54087a596e/runs/08585329112602833828909892130CU17/contents/TriggerOutputs?api-version=2016-06-01&se=2022-11-17T18%3A00%3A00.0000000Z&sp=%2Fruns%2F08585329112602833828909892130CU17%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig="},"startTime":"2022-11-17T14:33:45.1914506Z","status":"Succeeded"}}
+  startTime  : 2022-11-17T14:33:45.2763872Z
+  status     : Running
+  triggerName: When_a_new_response_is_submitted
+  type       : Microsoft.ProcessSimple/environments/flows/runs
   ```
 
   </TabItem>

package/docs/docs/cmd/graph/directoryextension/directoryextension-add.mdx

@@ -0,0 +1,123 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension add
+
+Creates a new directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name <name>`
+: The name of the directory extension.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--dataType <dataType>`
+: The data type of the value the extension property can hold. Possible values are: `Binary`, `Boolean`, `DateTime`, `Integer`, `LargeInteger` and `String`.
+
+`--targetObjects <targetObjects>`
+: Comma-separated list of Microsoft Graph resources that can use the extension. Possible values are: `User`, `Group`, `Application`, `AdministrativeUnit`, `Device` and `Organization`.
+
+`--isMultiValued`
+: Defines the directory extension as a multi-valued property.
+```
+
+<Global />
+
+## Examples
+
+Create a new directory extension of string type defined for user resource.
+
+```sh
+m365 graph directoryextension add --name gitHubWorkAccountName --appName ContosoApp --targetObjects User --dataType String
+```
+
+Create a new multi-valued directory extension of integer type defined for device and application resource
+
+```sh
+m365 graph directoryextension add --name departmentIds --appId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --targetObjects 'Application,Device' --dataType Integer --isMultiValued
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
+    "deletedDateTime": null,
+    "appDisplayName": "ContosoApp",
+    "dataType": "String",
+    "isMultiValued": false,
+    "isSyncedFromOnPremises": false,
+    "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
+    "targetObjects": [
+      "User"
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 01e77f60-3dde-4fa3-825b-cac8048994a8
+  isMultiValued         : false
+  isSyncedFromOnPremises: false
+  name                  : extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
+
+  Date: 9/8/2024
+
+  ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
+
+  Property | Value|
+  ---------|-------|
+  id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | false
+  isSyncedFromOnPremises | false
+  name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx

@@ -0,0 +1,118 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# graph directoryextension get
+
+Retrieves the definition of a directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension get [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the directory extension. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: The name of the directory extension. Specify either `id` or `name`, but not both.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+```
+
+<Global />
+
+## Examples
+
+Get directory extension by id registered for an application specified by app id.
+
+```sh
+m365 directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
+```
+
+Get directory extension by name registered for an application specified by name.
+
+```sh
+m365 directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
+```
+
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
+    "deletedDateTime": null,
+    "appDisplayName": "ContosoApp",
+    "dataType": "String",
+    "isMultiValued": false,
+    "isSyncedFromOnPremises": false,
+    "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
+    "targetObjects": [
+      "User"
+    ]
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  appDisplayName        : ContosoApp
+  dataType              : String
+  deletedDateTime       : null
+  id                    : 01e77f60-3dde-4fa3-825b-cac8048994a8
+  isMultiValued         : false
+  isSyncedFromOnPremises: false
+  name                  : extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  targetObjects         : ["User"]
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
+  b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
+
+  Date: 3/2/2025
+
+  ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
+
+  Property | Value|
+  ---------|-------|
+  id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
+  appDisplayName | ContosoApp
+  dataType | String
+  isMultiValued | false
+  isSyncedFromOnPremises | false
+  name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/graph/directoryextension/directoryextension-remove.mdx

@@ -0,0 +1,57 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# graph directoryextension remove
+
+Removes a directory extension
+
+## Usage
+
+```sh
+m365 graph directoryextension remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The ID of the directory extension to remove. Specify either `id` or `name`, but not both.
+
+`-n, --name [name]`
+: The name of the directory extension to remove. Specify either `id` or `name`, but not both.
+
+`--appId [appId]`
+: Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appObjectId [appObjectId]`
+: Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`--appName [appName]`
+: The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
+
+`-f, --force`
+: Don't prompt for confirmation before removing the directory extension
+```
+
+<Global />
+
+## Examples
+
+Remove a directory extension specified by name from an application specified by app object id and don't prompt for confirmation
+
+```sh
+m365 graph directoryextension remove --name extension_105be60b603845fea385e58772d9d630_githubworkaccount --appObjectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --force
+```
+
+Remove a directory extension specified by id from an application specified by app name and don't prompt for confirmation
+
+```sh
+m365 graph directoryextension remove --id 522817ae-5c95-4243-96c1-f85231fcbc1f --appName ContosoApp
+```
+
+## Response
+
+The command won't return a response on success.
+
+## More information
+
+- Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions

package/docs/docs/cmd/login.mdx

@@ -22,7 +22,7 @@ m365 login [options]
 : ID of the tenant from which accounts should authenticate. Use `common` or `organization` for multitenant apps. Defaults to `common` if not specified and if the config value `tenantId` and the environment variable `CLIMICROSOFT365_TENANT` are also not set.
 
 `-t, --authType [authType]`
-: The type of authentication to use. Allowed values `certificate`, `deviceCode`, `password`, `identity`, `browser`, `secret`. Default `deviceCode`
+: The type of authentication to use. Allowed values `certificate`, `deviceCode`, `password`, `identity`, `federatedIdentity`, `browser`, `secret`. Default `deviceCode`
 
 `-u, --userName [userName]`
 : Name of the user to authenticate. Required when `authType` is set to `password`
@@ -78,6 +78,8 @@ When logging in to Microsoft 365 using the user name and password, next to the a
 
 When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.mdx) command.  
 
+Federated Identity is currently supported in GitHub Actions. To use this you need to set `authType` to `federatedIdentity` and specify `appId` and `tenant` to the values of the app registration you've configured a federated credential on. 
+
 To log in to Microsoft 365 using a certificate or secret, you will typically [create a custom Microsoft Entra application](../user-guide/using-own-identity.mdx). To use this application with the CLI for Microsoft 365, you will set the `CLIMICROSOFT365_ENTRAAPPID` environment variable to the application's ID and the `CLIMICROSOFT365_TENANT` environment variable to the ID of the Microsoft Entra tenant, where you created the Microsoft Entra application. Also, please make sure to read about [the caveats when using the certificate login option](../user-guide/cli-certificate-caveats.mdx).
 
 Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
@@ -182,6 +184,12 @@ Log in to Microsoft 365 using a user-assigned managed identity with `clientId` s
 m365 login --authType identity --userName ac9fbed5-804c-4362-a369-21a4ec51109e
 ```
 
+Log in to Microsoft 365 using a federated identity. Can currently only be used in GitHub Actions.
+
+```sh
+m365 login --authType federatedIdentity --appId eb96cfd0-abfa-4477-8d1d-c6dfde3efb19 --tenant 9a1a1bbd-e158-4cf5-967d-a53b8e85c628
+```
+
 Log in to Microsoft 365 using the interactive browser authentication with `clientId` set in the configuration. Uses the identity of the current user.
 
 ```sh

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

@@ -235,11 +235,17 @@ m365 pa app get --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --environmentName De
   <TabItem value="Text">
 
   ```text
+  appLocation: europe
+  appType    : ClassicCanvasApp
   appVersion : 2022-10-25T21:28:12Z
   description: App Description
-  displayName: Test application
+  displayName: PowerApps Application
+  id         : /providers/Microsoft.PowerApps/apps/37ea6004-f07b-46ca-8ef3-a256b67b4dbb
   name       : 37ea6004-f07b-46ca-8ef3-a256b67b4dbb
-  owner      : user@contoso.onmicrosoft.com
+  owner      : user@tenant.onmicrosoft.com
+  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
   ```
 
   </TabItem>

package/docs/docs/cmd/pa/environment/environment-get.mdx

@@ -143,13 +143,15 @@ m365 pa environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 
   ```text
   azureRegionHint  : westeurope
-  displayName      : environmentName (default)
+  displayName      : contoso (default)
   environmentSku   : Default
-  id               : /providers/Microsoft.PowerApps/environments/Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  id               : /providers/Microsoft.PowerApps/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
   isDefault        : true
   location         : europe
-  name             : Default-e1dd4030-a657-480a-8a0e-c1b1eec51e2e
+  name             : Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d
+  properties       : {"azureRegionHint":"westeurope","clientUris":{"admin":"https://admin.powerplatform.microsoft.com/environments/environment/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/hub","maker":"https://make.powerapps.com/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/home"},"cluster":{"category":"Prod","environment":"Prod","geoShortName":"EU","number":"109","uriSuffix":"eu-il109.gateway.prod.island"},"connectedGroups":[],"createdBy":{"displayName":"SYSTEM","id":"SYSTEM","type":"NotSpecified"},"createdTime":"2020-03-12T13:39:17.9876946Z","creationType":"DefaultTenant","databaseType":"CommonDataService","displayName":"contoso (default)","governanceConfiguration":{"protectionLevel":"Basic"},"lifecycleAuthority":"Environment","linkedEnvironmentMetadata":{"baseLanguage":1033,"createdTime":"2021-10-08T09:50:41.283Z","domainName":"org6633049a","friendlyName":"contoso (default)","instanceApiUrl":"https://org6633049a.api.crm4.dynamics.com","instanceState":"Ready","instanceUrl":"https://org6633049a.crm4.dynamics.com/","platformSku":"Standard","resourceId":"5041ef46-5a1c-4a0f-a185-6bb49b5c6686","uniqueName":"unq5041ef465a1c4a0fa1856bb49b5c6","version":"9.2.22101.00168"},"protectionStatus":{"keyManagedBy":"Microsoft"},"provisioningState":"Succeeded","retentionPeriod":"P7D","runtimeEndpoints":{"microsoft.ApiManagement":"https://management.EUROPE.azure-apihub.net","microsoft.BusinessAppPlatform":"https://europe.api.bap.microsoft.com","microsoft.CommonDataModel":"https://europe.api.cds.microsoft.com","microsoft.Flow":"https://emea.api.flow.microsoft.com","microsoft.PowerApps":"https://europe.api.powerapps.com","microsoft.PowerAppsAdvisor":"https://europe.api.advisor.powerapps.com","microsoft.PowerVirtualAgents":"https://powervamg.eu-il109.gateway.prod.island.powerapps.com"},"states":{"management":{"id":"NotSpecified"},"runtime":{"id":"Enabled","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"runtimeReasonCode":"NotSpecified"}},"trialScenarioType":"None","updateCadence":{"id":"Frequent"}}
   provisioningState: Succeeded
+  type             : Microsoft.PowerApps/environments
   ```
 
   </TabItem>

package/docs/docs/cmd/planner/plan/plan-add.mdx

@@ -103,6 +103,8 @@ m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Gro
   <TabItem value="Text">
 
   ```text
+  container      : {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+  createdBy      : {"application":{"displayName":null,"id":"ebf3b108-5234-4e22-b93d-656d7dae5874"},"user":{"displayName":null,"id":"95e27074-6c4a-447a-aa24-9d718a0b86fa"}}
   createdDateTime: 2015-03-30T18:36:49.2407981Z
   id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
   owner          : ebf3b108-5234-4e22-b93d-656d7dae5874

package/docs/docs/cmd/planner/plan/plan-get.mdx

@@ -131,10 +131,14 @@ m365 planner plan get --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"
   <TabItem value="Text">
 
   ```text
-  createdDateTime: 2015-03-30T18:36:49.2407981Z
-  id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
-  owner          : ebf3b108-5234-4e22-b93d-656d7dae5874
-  title          : My Planner Plan
+  categoryDescriptions: {"category1":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category2":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null}
+  container           : {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+  createdBy           : {"application":{"displayName":null,"id":"ebf3b108-5234-4e22-b93d-656d7dae5874"},"user":{"displayName":null,"id":"95e27074-6c4a-447a-aa24-9d718a0b86fa"}}
+  createdDateTime     : 2015-03-30T18:36:49.2407981Z
+  id                  : xqQg5FS2LkCp935s-FIFm2QAFkHM
+  owner               : ebf3b108-5234-4e22-b93d-656d7dae5874
+  sharedWith          : {"6463a5ce-2119-4198-9f2a-628761df4a62":true,"ebf3b108-5234-4e22-b93d-656d7dae5874":true}
+  title               : My Planner Plan
   ```
 
   </TabItem>

package/docs/docs/cmd/planner/plan/plan-set.mdx

@@ -112,6 +112,8 @@ m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --
   <TabItem value="Text">
 
   ```text
+  container      : {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+  createdBy      : {"application":{"displayName":null,"id":"ebf3b108-5234-4e22-b93d-656d7dae5874"},"user":{"displayName":null,"id":"95e27074-6c4a-447a-aa24-9d718a0b86fa"}}
   createdDateTime: 2015-03-30T18:36:49.2407981Z
   id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
   owner          : ebf3b108-5234-4e22-b93d-656d7dae5874

package/docs/docs/cmd/planner/task/task-checklistitem-add.mdx

@@ -67,9 +67,12 @@ m365 planner task checklistitem add --taskId 2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2 --titl
   <TabItem value="Text">
 
   ```txt
-  id       : b65db83e-d777-49db-8cdd-57a41b86f48c
-  isChecked: false
-  title    : Communicate with customer
+  id                  : b65db83e-d777-49db-8cdd-57a41b86f48c
+  isChecked           : false
+  lastModifiedBy      : {"user":{"displayName":null,"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65"}}
+  lastModifiedDateTime: 2023-01-25T22:11:42.2488405Z
+  orderHint           : 8585269221832287402
+  title               : Communicate with customer
   ```
 
   </TabItem>

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-get.mdx

@@ -94,9 +94,18 @@ m365 pp aibuildermodel get --environmentName "Default-d87a7535-dd31-4437-bfe1-95
   <TabItem value="Text">
 
   ```text
-  createdon             modifiedon            msdyn_aimodelid                       msdyn_name
-  --------------------  --------------------  ------------------------------------  -------------------------------------------
-  2022-10-25T14:44:48Z  2022-10-25T14:44:48Z  08ffffbe-ec1c-4e64-b64b-dd1db926c613  Document Processing 11/29/2022, 12:58:43 PM
+  _statecode               : 0
+  _createdby_value         : 5fa787c1-1c4d-ed11-bba1-000d3a2caf7f
+  _createdonbehalfby_value : null
+  _createdon               : 2022-11-29T11:58:45Z
+  _componentstate          : 0
+  _importsequencenumber    : null
+  _introducedversion       : "1.0"
+  _iscustomizable          : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"iscustomizableanddeletable"}
+  _modifiedonbehalfby_value: null
+  _msowningteam_value      : null
+  _statuscode              : 0
+  _modifiedby_value        : 5fa787c1-1c4d-ed11-bba1-000d3a2caf7f
   ```
 
   </TabItem>