@pnp/cli-microsoft365 10.5.0-beta.b872a3f → 10.5.0

package/dist/m365/viva/commands/engage/engage-community-user-add.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import request from '../../../../request.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { formatting } from '../../../../utils/formatting.js';
+const options = globalOptionsZod
+    .extend({
+    communityId: z.string().optional(),
+    communityDisplayName: zod.alias('n', z.string().optional()),
+    entraGroupId: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    ids: z.string()
+        .refine(ids => validation.isValidGuidArray(ids) === true, invalidIds => ({
+        message: `The following GUIDs are invalid: ${invalidIds}.`
+    })).optional(),
+    userNames: z.string()
+        .refine(userNames => validation.isValidUserPrincipalNameArray(userNames) === true, invalidUserNames => ({
+        message: `The following user principal names are invalid: ${invalidUserNames}.`
+    })).optional(),
+    role: zod.alias('r', z.enum(['Admin', 'Member']))
+})
+    .strict();
+class VivaEngageCommunityUserAddCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_USER_ADD;
+    }
+    get description() {
+        return 'Adds a user to a specific Microsoft 365 Viva Engage community';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
+            message: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+        })
+            .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
+            message: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+        })
+            .refine(options => options.ids || options.userNames, {
+            message: 'Specify either of ids or userNames.'
+        })
+            .refine(options => typeof options.userNames !== undefined && typeof options.ids !== undefined, {
+            message: 'Specify either ids or userNames, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (this.verbose) {
+                await logger.logToStderr('Adding users to community...');
+            }
+            let entraGroupId = args.options.entraGroupId;
+            if (args.options.communityDisplayName) {
+                const community = await vivaEngage.getCommunityByDisplayName(args.options.communityDisplayName, ['groupId']);
+                entraGroupId = community.groupId;
+            }
+            if (args.options.communityId) {
+                const community = await vivaEngage.getCommunityById(args.options.communityId, ['groupId']);
+                entraGroupId = community.groupId;
+            }
+            const userIds = args.options.ids ? formatting.splitAndTrim(args.options.ids) : await entraUser.getUserIdsByUpns(formatting.splitAndTrim(args.options.userNames));
+            const role = args.options.role === 'Member' ? 'members' : 'owners';
+            for (let i = 0; i < userIds.length; i += 400) {
+                const userIdsBatch = userIds.slice(i, i + 400);
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/$batch`,
+                    headers: {
+                        'content-type': 'application/json;odata.metadata=none'
+                    },
+                    responseType: 'json',
+                    data: {
+                        requests: []
+                    }
+                };
+                // only 20 requests per one batch are allowed
+                for (let j = 0; j < userIdsBatch.length; j += 20) {
+                    // only 20 users can be added in one request
+                    const userIdsChunk = userIdsBatch.slice(j, j + 20);
+                    requestOptions.data.requests.push({
+                        id: j + 1,
+                        method: 'PATCH',
+                        url: `/groups/${entraGroupId}`,
+                        headers: {
+                            'content-type': 'application/json;odata.metadata=none'
+                        },
+                        body: {
+                            [`${role}@odata.bind`]: userIdsChunk.map((u) => `${this.resource}/v1.0/directoryObjects/${u}`)
+                        }
+                    });
+                }
+                const res = await request.post(requestOptions);
+                for (const response of res.responses) {
+                    if (response.status !== 204) {
+                        throw response.body;
+                    }
+                }
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new VivaEngageCommunityUserAddCommand();
+//# sourceMappingURL=engage-community-user-add.js.map

package/dist/m365/viva/commands/engage/engage-community-user-remove.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { globalOptionsZod } from '../../../../Command.js';
+import { zod } from '../../../../utils/zod.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import request from '../../../../request.js';
+import { entraUser } from '../../../../utils/entraUser.js';
+import { cli } from '../../../../cli/cli.js';
+const options = globalOptionsZod
+    .extend({
+    communityId: z.string().optional(),
+    communityDisplayName: zod.alias('n', z.string().optional()),
+    entraGroupId: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    id: z.string()
+        .refine(id => validation.isValidGuid(id), id => ({
+        message: `'${id}' is not a valid GUID.`
+    })).optional(),
+    userName: z.string()
+        .refine(userName => validation.isValidUserPrincipalName(userName), userName => ({
+        message: `'${userName}' is not a valid user principal name.`
+    })).optional(),
+    force: z.boolean().optional()
+})
+    .strict();
+class VivaEngageCommunityUserRemoveCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_USER_REMOVE;
+    }
+    get description() {
+        return 'Removes a specified user from a Microsoft 365 Viva Engage community';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.communityId, options.communityDisplayName, options.entraGroupId].filter(x => x !== undefined).length === 1, {
+            message: 'Specify either communityId, communityDisplayName, or entraGroupId, but not multiple.'
+        })
+            .refine(options => options.communityId || options.communityDisplayName || options.entraGroupId, {
+            message: 'Specify at least one of communityId, communityDisplayName, or entraGroupId.'
+        })
+            .refine(options => options.id || options.userName, {
+            message: 'Specify either of id or userName.'
+        })
+            .refine(options => typeof options.userName !== undefined && typeof options.id !== undefined, {
+            message: 'Specify either id or userName, but not both.'
+        });
+    }
+    async commandAction(logger, args) {
+        try {
+            if (args.options.force) {
+                await this.deleteUserFromCommunity(args.options, logger);
+            }
+            else {
+                const result = await cli.promptForConfirmation({ message: `Are you sure you want to remove the user ${args.options.id || args.options.userName} from the community ${args.options.communityDisplayName || args.options.communityId || args.options.entraGroupId}?` });
+                if (result) {
+                    await this.deleteUserFromCommunity(args.options, logger);
+                }
+            }
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+    async deleteUserFromCommunity(options, logger) {
+        if (this.verbose) {
+            await logger.logToStderr('Removing user from community...');
+        }
+        let entraGroupId = options.entraGroupId;
+        if (options.communityDisplayName) {
+            const community = await vivaEngage.getCommunityByDisplayName(options.communityDisplayName, ['groupId']);
+            entraGroupId = community.groupId;
+        }
+        else if (options.communityId) {
+            const community = await vivaEngage.getCommunityById(options.communityId, ['groupId']);
+            entraGroupId = community.groupId;
+        }
+        const userId = options.id || await entraUser.getUserIdByUpn(options.userName);
+        await this.deleteUser(entraGroupId, userId, 'owners');
+        await this.deleteUser(entraGroupId, userId, 'members');
+    }
+    async deleteUser(entraGroupId, userId, role) {
+        try {
+            const requestOptions = {
+                url: `${this.resource}/v1.0/groups/${entraGroupId}/${role}/${userId}/$ref`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            await request.delete(requestOptions);
+        }
+        catch (err) {
+            if (err.response.status !== 404) {
+                throw err.response.data;
+            }
+        }
+    }
+}
+export default new VivaEngageCommunityUserRemoveCommand();
+//# sourceMappingURL=engage-community-user-remove.js.map

package/dist/m365/viva/commands/engage/engage-message-add.js

@@ -14,9 +14,6 @@ class VivaEngageMessageAddCommand extends VivaEngageCommand {
     get description() {
         return 'Posts a Viva Engage network message on behalf of the current user';
     }
-    defaultProperties() {
-        return ['id'];
-    }
     constructor() {
         super();
         _VivaEngageMessageAddCommand_instances.add(this);

package/dist/m365/viva/commands/engage/engage-message-get.js

@@ -14,9 +14,6 @@ class VivaEngageMessageGetCommand extends VivaEngageCommand {
     get description() {
         return 'Returns a Viva Engage message';
     }
-    defaultProperties() {
-        return ['id', 'sender_id', 'replied_to_id', 'thread_id', 'group_id', 'created_at', 'direct_message', 'system_message', 'privacy', 'message_type', 'content_excerpt'];
-    }
     constructor() {
         super();
         _VivaEngageMessageGetCommand_instances.add(this);

package/dist/m365/viva/commands/engage/engage-user-get.js

@@ -15,9 +15,6 @@ class VivaEngageUserGetCommand extends VivaEngageCommand {
     get description() {
         return 'Retrieves the current user or searches for a user by ID or e-mail';
     }
-    defaultProperties() {
-        return ['id', 'full_name', 'email', 'job_title', 'state', 'url'];
-    }
     constructor() {
         super();
         _VivaEngageUserGetCommand_instances.add(this);

package/dist/m365/viva/commands.js

@@ -5,7 +5,9 @@ export default {
     ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
     ENGAGE_COMMUNITY_LIST: `${prefix} engage community list`,
     ENGAGE_COMMUNITY_SET: `${prefix} engage community set`,
+    ENGAGE_COMMUNITY_USER_ADD: `${prefix} engage community user add`,
     ENGAGE_COMMUNITY_USER_LIST: `${prefix} engage community user list`,
+    ENGAGE_COMMUNITY_USER_REMOVE: `${prefix} engage community user remove`,
     ENGAGE_GROUP_LIST: `${prefix} engage group list`,
     ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,
     ENGAGE_GROUP_USER_REMOVE: `${prefix} engage group user remove`,

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/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>

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

@@ -115,11 +115,42 @@ m365 pp card get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5
   <TabItem value="Text">
 
   ```text
-  cardid     : 0eab9392-7354-ed11-bba2-000d3adf774e
-  createdon  : 2022-10-25T14:44:48Z
-  modifiedon : 2022-10-25T14:44:48Z
-  name       : Tasks List
-  publishdate: 2022-10-30T16:00:00Z
+  appdefinition            : {"screens":{"main":{"template":{"$schema":"http://adaptivecards.io/schemas/1.4.0/adaptive-card.json","actions":[],"body":[{"size":"Medium","text":"Your card title goes here","type":"TextBlock","weight":"bolder"},{"text":"Add and remove element to customize your new card.","type":"TextBlock","wrap":true}],"type":"AdaptiveCard","version":"1.4"},"verbs":{"submit":"echo"}}},"connections":{},"flows":{},"sampleData":{"main":{}},"variables":{}}
+  cardid                   : 0eab9392-7354-ed11-bba2-000d3adf774e
+  coowners                 : null
+  componentidunique        : 24205370-bc43-4c5e-b095-16da18f0b1a3
+  componentstate           : 0
+  createdon                : 2022-10-25T14:44:48Z
+  description              :  
+  hiddentags               : null
+  importsequencenumber     : null
+  ismanaged                : false
+  iscustomizable           : {"Value":true,"CanBeChanged":true,"ManagedPropertyLogicalName":"iscustomizableanddeletable"}
+  modifiedon               : 2022-10-25T14:44:48Z
+  name                     : Tasks List
+  overriddencreatedon      : null
+  overwritetime            : 1900-01-01T00:00:00Z
+  owninguser               : {"azureactivedirectoryobjectid":"78637d62-e872-4dc9-b7c1-bd161e631682","fullname":"# John Doe","ownerid":"4f175d04-b952-ed11-bba2-000d3adf774e","systemuserid":"4f175d04-b952-ed11-bba2-000d3adf774e"}
+  publishdate              : null
+  publishsourceid          : null
+  remixsourceid            : null
+  schemaversion            : null
+  sizes                    : null
+  solutionid               : fd140aae-4df4-11dd-bd17-0019b9312238
+  statecode                : 0
+  statuscode               : 1
+  tags                     : null
+  timezoneruleversionnumber: null
+  utcconversiontimezonecode: null
+  versionnumber            : 4451230
+  _ownerid_value           : 4f175d04-b952-ed11-bba2-000d3adf774e
+  _owningbusinessunit_value: b419f090-fe22-ec11-b6e5-000d3ab596a1
+  _owningteam_value        : null
+  _owninguser_value        : 4f175d04-b952-ed11-bba2-000d3adf774e
+  _createdby_value         : 4f175d04-b952-ed11-bba2-000d3adf774e
+  _createdonbehalfby_value : null
+  _modifiedby_value        : 4f175d04-b952-ed11-bba2-000d3adf774e
+  _modifiedonbehalfby_value: null
   ```
 
   </TabItem>