@pnp/cli-microsoft365 10.1.0-beta.10765f6 → 10.1.0-beta.6c6be23

package/dist/m365/viva/commands/engage/engage-community-set.js

@@ -0,0 +1,111 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _VivaEngageCommunitySetCommand_instances, _VivaEngageCommunitySetCommand_initTelemetry, _VivaEngageCommunitySetCommand_initOptions, _VivaEngageCommunitySetCommand_initValidators, _VivaEngageCommunitySetCommand_initTypes, _VivaEngageCommunitySetCommand_initOptionSets;
+import request from '../../../../request.js';
+import { validation } from '../../../../utils/validation.js';
+import { vivaEngage } from '../../../../utils/vivaEngage.js';
+import GraphCommand from '../../../base/GraphCommand.js';
+import commands from '../../commands.js';
+class VivaEngageCommunitySetCommand extends GraphCommand {
+    get name() {
+        return commands.ENGAGE_COMMUNITY_SET;
+    }
+    get description() {
+        return 'Updates an existing Viva Engage community';
+    }
+    constructor() {
+        super();
+        _VivaEngageCommunitySetCommand_instances.add(this);
+        this.privacyOptions = ['public', 'private'];
+        __classPrivateFieldGet(this, _VivaEngageCommunitySetCommand_instances, "m", _VivaEngageCommunitySetCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunitySetCommand_instances, "m", _VivaEngageCommunitySetCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunitySetCommand_instances, "m", _VivaEngageCommunitySetCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunitySetCommand_instances, "m", _VivaEngageCommunitySetCommand_initTypes).call(this);
+        __classPrivateFieldGet(this, _VivaEngageCommunitySetCommand_instances, "m", _VivaEngageCommunitySetCommand_initOptionSets).call(this);
+    }
+    async commandAction(logger, args) {
+        let communityId = args.options.id;
+        if (args.options.displayName) {
+            communityId = (await vivaEngage.getCommunityByDisplayName(args.options.displayName, ['id'])).id;
+        }
+        else if (args.options.entraGroupId) {
+            communityId = (await vivaEngage.getCommunityByEntraGroupId(args.options.entraGroupId, ['id'])).id;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Updating Viva Engage community with ID ${communityId}...`);
+        }
+        const requestOptions = {
+            url: `${this.resource}/v1.0/employeeExperience/communities/${communityId}`,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json',
+            data: {
+                description: args.options.description,
+                displayName: args.options.newDisplayName,
+                privacy: args.options.privacy
+            }
+        };
+        try {
+            await request.patch(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+_VivaEngageCommunitySetCommand_instances = new WeakSet(), _VivaEngageCommunitySetCommand_initTelemetry = function _VivaEngageCommunitySetCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            id: typeof args.options.id !== 'undefined',
+            displayName: typeof args.options.displayName !== 'undefined',
+            entraGroupId: typeof args.options.entraGroupId !== 'undefined',
+            newDisplayName: typeof args.options.newDisplayName !== 'undefined',
+            description: typeof args.options.description !== 'undefined',
+            privacy: typeof args.options.privacy !== 'undefined'
+        });
+    });
+}, _VivaEngageCommunitySetCommand_initOptions = function _VivaEngageCommunitySetCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --id [id]'
+    }, {
+        option: '-d, --displayName [displayName]'
+    }, {
+        option: '--entraGroupId [entraGroupId]'
+    }, {
+        option: '--newDisplayName [newDisplayName]'
+    }, {
+        option: '--description [description]'
+    }, {
+        option: '--privacy [privacy]',
+        autocomplete: this.privacyOptions
+    });
+}, _VivaEngageCommunitySetCommand_initValidators = function _VivaEngageCommunitySetCommand_initValidators() {
+    this.validators.push(async (args) => {
+        if (args.options.entraGroupId && !validation.isValidGuid(args.options.entraGroupId)) {
+            return `${args.options.entraGroupId} is not a valid GUID for the option 'entraGroupId'.`;
+        }
+        if (args.options.newDisplayName && args.options.newDisplayName.length > 255) {
+            return `The maximum amount of characters for 'newDisplayName' is 255.`;
+        }
+        if (args.options.description && args.options.description.length > 1024) {
+            return `The maximum amount of characters for 'description' is 1024.`;
+        }
+        if (args.options.privacy && this.privacyOptions.map(x => x.toLowerCase()).indexOf(args.options.privacy.toLowerCase()) === -1) {
+            return `${args.options.privacy} is not a valid privacy. Allowed values are ${this.privacyOptions.join(', ')}`;
+        }
+        if (!args.options.newDisplayName && !args.options.description && !args.options.privacy) {
+            return 'Specify at least newDisplayName, description, or privacy.';
+        }
+        return true;
+    });
+}, _VivaEngageCommunitySetCommand_initTypes = function _VivaEngageCommunitySetCommand_initTypes() {
+    this.types.string.push('id', 'displayName', 'entraGroupId', 'newDisplayName', 'description', 'privacy');
+}, _VivaEngageCommunitySetCommand_initOptionSets = function _VivaEngageCommunitySetCommand_initOptionSets() {
+    this.optionSets.push({ options: ['id', 'displayName', 'entraGroupId'] });
+};
+export default new VivaEngageCommunitySetCommand();
+//# sourceMappingURL=engage-community-set.js.map

package/dist/m365/viva/commands.js

@@ -4,6 +4,7 @@ export default {
     ENGAGE_COMMUNITY_ADD: `${prefix} engage community add`,
     ENGAGE_COMMUNITY_GET: `${prefix} engage community get`,
     ENGAGE_COMMUNITY_LIST: `${prefix} engage community list`,
+    ENGAGE_COMMUNITY_SET: `${prefix} engage community set`,
     ENGAGE_COMMUNITY_USER_LIST: `${prefix} engage community user list`,
     ENGAGE_GROUP_LIST: `${prefix} engage group list`,
     ENGAGE_GROUP_USER_ADD: `${prefix} engage group user add`,

package/dist/utils/entraGroup.js

@@ -60,6 +60,24 @@ export const entraGroup = {
         }
         return groups[0].id;
     },
+    /**
+     * Get id of a group by its mail nickname.
+     * @param mailNickname Group mail nickname.
+     * @throws Error when group was not found.
+     * @throws Error when multiple groups with the same name were found.
+     */
+    async getGroupIdByMailNickname(mailNickname) {
+        const groups = await odata.getAllItems(`${graphResource}/v1.0/groups?$filter=mailNickname eq '${formatting.encodeQueryParameter(mailNickname)}'&$select=id`);
+        if (!groups.length) {
+            throw Error(`The specified group '${mailNickname}' does not exist.`);
+        }
+        if (groups.length > 1) {
+            const resultAsKeyValuePair = formatting.convertArrayToHashTable('id', groups);
+            const result = await cli.handleMultipleResultsFound(`Multiple groups with mail nickname '${mailNickname}' found.`, resultAsKeyValuePair);
+            return result.id;
+        }
+        return groups[0].id;
+    },
     async setGroup(id, isPrivate, logger, verbose) {
         if (verbose && logger) {
             await logger.logToStderr(`Updating Microsoft 365 Group ${id}...`);

package/docs/docs/cmd/entra/m365group/m365group-conversation-list.mdx

@@ -15,20 +15,29 @@ m365 entra m365group conversation list [options]
 ## Options
 
 ```md definition-list
-`-i, --groupId <groupId>`
-: The ID of the Microsoft 365 group
+`-i, --groupId [groupId]`
+: The ID of the Microsoft 365 Group. Specify either `groupId` or `groupName`, but not both.
+
+`-n, --groupName [groupName]`
+: Display name of the Microsoft 365 Group. Specify either `groupId` or `groupName`, but not both.
 ```
 
 <Global />
 
 ## Examples
 
-Lists conversations for the specified Microsoft 365 group
+Lists conversations for the Microsoft 365 group specified by id.
 
 ```sh
 m365 entra m365group conversation list --groupId '00000000-0000-0000-0000-000000000000'
 ```
 
+Lists conversations for the Microsoft 365 group specified by displayName.
+
+```sh
+m365 entra m365group conversation list --groupName Finance
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/entra/m365group/m365group-get.mdx

@@ -15,8 +15,11 @@ m365 entra m365group get [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group or Microsoft Teams team to retrieve information for
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group or Microsoft Teams team to retrieve information for. Specify either `id` or `displayName`, but not both.
 
 `--includeSiteUrl`
 : Set to retrieve the site URL for the group
@@ -32,6 +35,12 @@ Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-9
 m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844
 ```
 
+Get information about the Microsoft 365 Group with displayName _Finance_
+
+```sh
+m365 entra m365group get --displayName Finance
+```
+
 Get information about the Microsoft 365 Group with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_ and also retrieve the URL of the corresponding SharePoint site
 
 ```sh
@@ -80,7 +89,12 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
     "securityIdentifier": "S-1-12-1-4288263055-1337657931-1773679776-1830684296",
     "theme": null,
     "visibility": "Public",
-    "onPremisesProvisioningErrors": []
+    "onPremisesProvisioningErrors": [],
+    "allowExternalSenders": false,
+    "autoSubscribeNewMembers": false,
+    "isSubscribedByMail": false,
+    "hideFromOutlookClients": false,
+    "hideFromAddressLists": false
   }
   ```
 
@@ -88,6 +102,8 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   <TabItem value="Text">
 
   ```text
+  allowExternalSenders         : false
+  autoSubscribeNewMembers      : false
   classification               : null
   createdDateTime              : 2023-06-01T20:18:30Z
   creationOptions              : []
@@ -96,8 +112,11 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   displayName                  : Finance
   expirationDateTime           : null
   groupTypes                   : ["Unified"]
+  hideFromAddressLists         : false
+  hideFromOutlookClients       : false
   id                           : ff99b38f-0a4b-4fbb-a034-b86988061e6d
   isAssignableToRole           : null
+  isSubscribedByMail           : false
   mail                         : finance@contoso.onmicrosoft.com
   mailEnabled                  : true
   mailNickname                 : finance
@@ -126,8 +145,8 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   <TabItem value="CSV">
 
   ```csv
-  id,createdDateTime,description,displayName,mail,mailEnabled,mailNickname,renewedDateTime,securityEnabled,securityIdentifier,visibility
-  ff99b38f-0a4b-4fbb-a034-b86988061e6d,2023-06-01T20:18:30Z,"This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.",Finance,finance@contoso.onmicrosoft.com,1,finance,2023-06-01T20:18:30Z,,S-1-12-1-4288263055-1337657931-1773679776-1830684296,Public
+  id,createdDateTime,description,displayName,mail,mailEnabled,mailNickname,renewedDateTime,securityEnabled,securityIdentifier,visibility,allowExternalSenders,autoSubscribeNewMembers,isSubscribedByMail,hideFromOutlookClients,hideFromAddressLists
+  ff99b38f-0a4b-4fbb-a034-b86988061e6d,2023-06-01T20:18:30Z,"This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more.",Finance,finance@contoso.onmicrosoft.com,1,finance,2023-06-01T20:18:30Z,,S-1-12-1-4288263055-1337657931-1773679776-1830684296,Public,false,false,false,false,false
   ```
 
   </TabItem>
@@ -153,6 +172,11 @@ m365 entra m365group get --id 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --includeSite
   securityEnabled | false
   securityIdentifier | S-1-12-1-4288263055-1337657931-1773679776-1830684296
   visibility | Public
+  allowExternalSenders | false
+  autoSubscribeNewMembers | false
+  isSubscribedByMail | false
+  hideFromOutlookClients | false
+  hideFromAddressLists | false
   ```
 
   </TabItem>

package/docs/docs/cmd/entra/m365group/m365group-remove.mdx

@@ -13,8 +13,11 @@ m365 entra m365group remove [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 Group to remove
+`-i, --id [id]`
+: The ID of the Microsoft 365 Group to remove. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to remove. Specify either `id` or `displayName`, but not both.
 
 `-f, --force`
 : Don't prompt for confirming removing the group
@@ -47,10 +50,10 @@ Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_. Will prompt for con
 m365 entra m365group remove --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```
 
-Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_ without prompting for confirmation
+Remove group with displayName _Finance_ without prompting for confirmation
 
 ```sh
-m365 entra m365group remove --id 28beab62-7540-4db1-a23f-29a6018a3848 --force
+m365 entra m365group remove --displayName Finance --force
 ```
 
 Remove group with id _28beab62-7540-4db1-a23f-29a6018a3848_ without prompting for confirmation and without moving it to the Recycle Bin

package/docs/docs/cmd/entra/m365group/m365group-renew.mdx

@@ -13,8 +13,11 @@ m365 entra m365group renew [options]
 ## Options
 
 ```md definition-list
-`-i, --id <id>`
-: The ID of the Microsoft 365 group to renew
+`-i, --id [id]`
+: The ID of the Microsoft 365 group to renew. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to renew. Specify either `id` or `displayName`, but not both.
 ```
 
 <Global />
@@ -31,6 +34,12 @@ Renew the Microsoft 365 group with id _28beab62-7540-4db1-a23f-29a6018a3848_
 m365 entra m365group renew --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```
 
+Renew the Microsoft 365 group with displayName _Finance_
+
+```sh
+m365 entra m365group renew --displayName Finance
+```
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/entra/m365group/m365group-teamify.mdx

@@ -14,10 +14,13 @@ m365 entra m365group teamify [options]
 
 ```md definition-list
 `-i, --id [id]`
-: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id` or `mailNickname` but not both.
+: The ID of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
+
+`-n, --displayName [displayName]`
+: Display name of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
 
 `--mailNickname [mailNickname]`
-: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id` or `mailNickname` but not both.
+: The mail alias of the Microsoft 365 Group to connect to Microsoft Teams. Specify either `id`, `displayName` or `mailNickname`, but not multiple.
 ```
 
 <Global />
@@ -30,7 +33,13 @@ Creates a new Microsoft Teams team under existing Microsoft 365 group with the s
 m365 entra m365group teamify --id e3f60f99-0bad-481f-9e9f-ff0f572fbd03
 ```
 
-Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified mailNickname.
+Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified displayName.
+
+```sh
+m365 entra m365group teamify --displayName Finance
+```
+
+Creates a new Microsoft Teams team under existing Microsoft 365 group with the specified mailNickname._
 
 ```sh
 m365 entra m365group teamify --mailNickname GroupName

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

@@ -13,7 +13,7 @@ m365 entra m365group user add [options]
 ## Alias
 
 ```sh
-m365 teams user add
+m365 teams user add [options]
 ```
 
 ## Options
@@ -38,7 +38,7 @@ m365 teams user add
 : The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
 
 `-r, --role [role]`
-: The role to be assigned to the new user: `Owner,Member`. Default `Member`.
+: The role to be assigned to the new user. Allowed values: `Owner`, `Member`. Default `Member`.
 ```
 
 <Global />

package/docs/docs/cmd/entra/m365group/m365group-user-list.mdx

@@ -57,6 +57,12 @@ List specific properties for all group users from a group specified by ID.
 m365 entra m365group user list --groupId 03cba9da-3974-46c1-afaf-79caa2e45bbe --properties "id,jobTitle,companyName,accountEnabled"
 ```
 
+List all group members that are guest users.
+
+```sh
+m365 entra m365group user list --groupDisplayName Developers --filter "userType eq 'Guest'"
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/entra/m365group/m365group-user-remove.mdx

@@ -17,7 +17,7 @@ m365 entra m365group user remove [options]
 : The ID of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
 
 `--groupName [groupName]`
-: The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`..
+: The display name of the Microsoft 365 group. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.
 
 `--teamId [teamId]`
 : The ID of the Microsoft Teams team. Specify only one of the following: `groupId`, `groupName`, `teamId`, or `teamName`.

package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx

@@ -32,7 +32,7 @@ m365 entra m365group user set [options]
 : The user principal names of users. You can also pass a comma-separated list of UPNs. Specify only one of the following `ids` or `userNames`.
 
 `-r, --role <role>`
-: Role to set for the given user in the specified Microsoft 365 Group or Microsoft Teams team. Allowed values: `Owner`, `Member`
+: Role to set for the given user in the specified Microsoft 365 Group or Microsoft Teams team. Allowed values: `Owner`, `Member`.
 ```
 
 <Global />
@@ -70,13 +70,13 @@ m365 entra m365group user set --groupId '00000000-0000-0000-0000-000000000000' -
 Demote multiple users specified by the userNames parameter from Owner to Member of the given Microsoft Teams team
 
 ```sh
-m365 entra teams user set --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Member
+m365 teams user set --teamId '00000000-0000-0000-0000-000000000000' --userNames 'anne.matthews@contoso.onmicrosoft.com,john.doe@contoso.onmicrosoft.com' --role Member
 ```
 
 Demote multiple users specified by the ids parameter from Owner to Member in the given Microsoft Teams team
 
 ```sh
-m365 entra teams user set --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
+m365 teams user set --teamName 'Engineering' --ids '74a3b772-3122-447b-b9da-10895e238219,dd3d21e4-a142-46b9-8482-bca8fe9596b3' --role Member
 ```
 
 ## Response

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

@@ -29,6 +29,24 @@ m365 graph subscription add [options]
 
 `-s, --clientState [clientState]`
 : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters.
+
+`--lifecycleNotificationUrl [lifecycleNotificationUrl]`
+: The URL of the endpoint that will receive the lifecycle notifications. This URL must use the HTTPS protocol.
+
+`--notificationUrlAppId [notificationUrlAppId]`
+: The app ID that the subscription service can use to generate the validation token. The value allows the client to validate the authenticity of the notification received.
+
+`--latestTLSVersion [latestTLSVersion]`
+: The latest version of TLS that the notification endpoint supports. Allowed values are `v1_0`, `v1_1`, `v1_2`, `v1_3`. Default is `v1_2`.
+
+`--includeResourceData`
+: When set, the change notifications will include the changed resource data.
+
+`--encryptionCertificate [encryptionCertificate]`
+: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `includeResourceData`.
+
+`--encryptionCertificateId [encryptionCertificateId]`
+: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `includeResourceData`.
 ```
 
 <Global />
@@ -47,6 +65,13 @@ To subscribe to change notifications of Outlook contacts, events, or messages in
 - Use the corresponding application permission to subscribe to changes of items in a folder or mailbox of any user in the tenant.
 - Do not use the Outlook sharing permissions (Contacts.Read.Shared, Calendars.Read.Shared, Mail.Read.Shared, and their read/write counterparts), as they do not support subscribing to change notifications on items in shared or delegated folders.
 
+:::info
+
+For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. 
+For these subscribers, not setting this property per the timeline would result in subscription operations failing.
+
+:::
+
 ## Examples
 
 Create a subscription
@@ -55,16 +80,16 @@ Create a subscription
 m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
-Create a subscription on multiple change types
+Create a subscription on multiple change types and include resource data
 
 ```sh
-m365 graph subscription add --resource groups --changeTypes "updated,deleted" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --includeResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription using the maximum allowed expiration for Group resources
 
 ```sh
-m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
+m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --lifecycleNotificationUrl "https://webhook.azurewebsites.net/api/send/lifecycleNotifications"
 ```
 
 Create a subscription for Event Hub location if you are using Key Vault
@@ -79,10 +104,10 @@ Create a subscription for Event Hub location if you are using role-based access
 m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://eventHubNamespace.servicebus.windows.net/eventhubname/eventHubName?tenantId=contoso.com"
 ```
 
-Create a subscription for Event Grid Partner Topic.
+Create a subscription for Event Grid Partner Topic and use TLS 1.3
 
 ```sh
-m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
+m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --latestTLSVersion 'v1_3' --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
 ```
 
 ## Response