@pnp/cli-microsoft365 6.2.0-beta.d0cdaa3 → 6.2.0-beta.d850a76

package/dist/m365/spo/commands.js

@@ -57,11 +57,16 @@ exports.default = {
     FILE_MOVE: `${prefix} file move`,
     FILE_REMOVE: `${prefix} file remove`,
     FILE_RENAME: `${prefix} file rename`,
+    FILE_RETENTIONLABEL_ENSURE: `${prefix} file retentionlabel ensure`,
+    FILE_RETENTIONLABEL_REMOVE: `${prefix} file retentionlabel remove`,
     FILE_ROLEASSIGNMENT_ADD: `${prefix} file roleassignment add`,
     FILE_ROLEASSIGNMENT_REMOVE: `${prefix} file roleassignment remove`,
     FILE_ROLEINHERITANCE_BREAK: `${prefix} file roleinheritance break`,
     FILE_ROLEINHERITANCE_RESET: `${prefix} file roleinheritance reset`,
     FILE_SHARINGINFO_GET: `${prefix} file sharinginfo get`,
+    FILE_SHARINGLINK_GET: `${prefix} file sharinglink get`,
+    FILE_SHARINGLINK_LIST: `${prefix} file sharinglink list`,
+    FILE_SHARINGLINK_REMOVE: `${prefix} file sharinglink remove`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
     FILE_VERSION_LIST: `${prefix} file version list`,
@@ -74,6 +79,8 @@ exports.default = {
     FOLDER_MOVE: `${prefix} folder move`,
     FOLDER_REMOVE: `${prefix} folder remove`,
     FOLDER_RENAME: `${prefix} folder rename`,
+    FOLDER_RETENTIONLABEL_ENSURE: `${prefix} folder retentionlabel ensure`,
+    FOLDER_RETENTIONLABEL_REMOVE: `${prefix} folder retentionlabel remove`,
     FOLDER_ROLEASSIGNMENT_REMOVE: `${prefix} folder roleassignment remove`,
     FOLDER_ROLEASSIGNMENT_ADD: `${prefix} folder roleassignment add`,
     FOLDER_ROLEINHERITANCE_BREAK: `${prefix} folder roleinheritance break`,
@@ -117,6 +124,7 @@ exports.default = {
     LIST_REMOVE: `${prefix} list remove`,
     LIST_RETENTIONLABEL_ENSURE: `${prefix} list retentionlabel ensure`,
     LIST_RETENTIONLABEL_GET: `${prefix} list retentionlabel get`,
+    LIST_RETENTIONLABEL_REMOVE: `${prefix} list retentionlabel remove`,
     LIST_ROLEASSIGNMENT_REMOVE: `${prefix} list roleassignment remove`,
     LIST_ROLEASSIGNMENT_ADD: `${prefix} list roleassignment add`,
     LIST_ROLEINHERITANCE_BREAK: `${prefix} list roleinheritance break`,
@@ -143,8 +151,11 @@ exports.default = {
     LISTITEM_ISRECORD: `${prefix} listitem isrecord`,
     LISTITEM_LIST: `${prefix} listitem list`,
     LISTITEM_RECORD_DECLARE: `${prefix} listitem record declare`,
+    LISTITEM_RECORD_LOCK: `${prefix} listitem record lock`,
     LISTITEM_RECORD_UNDECLARE: `${prefix} listitem record undeclare`,
+    LISTITEM_RECORD_UNLOCK: `${prefix} listitem record unlock`,
     LISTITEM_REMOVE: `${prefix} listitem remove`,
+    LISTITEM_RETENTIONLABEL_ENSURE: `${prefix} listitem retentionlabel ensure`,
     LISTITEM_RETENTIONLABEL_REMOVE: `${prefix} listitem retentionlabel remove`,
     LISTITEM_ROLEASSIGNMENT_ADD: `${prefix} listitem roleassignment add`,
     LISTITEM_ROLEASSIGNMENT_REMOVE: `${prefix} listitem roleassignment remove`,

package/dist/m365/teams/commands/chat/chat-list.js

@@ -15,9 +15,12 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _TeamsChatListCommand_instances, _TeamsChatListCommand_initTelemetry, _TeamsChatListCommand_initOptions, _TeamsChatListCommand_initValidators;
 Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const accessToken_1 = require("../../../../utils/accessToken");
 const odata_1 = require("../../../../utils/odata");
 const GraphCommand_1 = require("../../../base/GraphCommand");
 const commands_1 = require("../../commands");
+const validation_1 = require("../../../../utils/validation");
 class TeamsChatListCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.CHAT_LIST;
@@ -31,16 +34,26 @@ class TeamsChatListCommand extends GraphCommand_1.default {
     constructor() {
         super();
         _TeamsChatListCommand_instances.add(this);
+        this.supportedTypes = ['oneOnOne', 'group', 'meeting'];
         __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initTelemetry).call(this);
         __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initOptions).call(this);
         __classPrivateFieldGet(this, _TeamsChatListCommand_instances, "m", _TeamsChatListCommand_initValidators).call(this);
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const filter = args.options.type !== undefined ? `?$filter=chatType eq '${args.options.type}'` : '';
-            const endpoint = `${this.resource}/v1.0/chats${filter}`;
+            const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAuth && !args.options.userId && !args.options.userName) {
+                throw `The option 'userId' or 'userName' is required when obtaining chats using app only permissions`;
+            }
+            else if (!isAppOnlyAuth && (args.options.userId || args.options.userName)) {
+                throw `The options 'userId' or 'userName' cannot be used when obtaining chats using delegated permissions`;
+            }
+            let requestUrl = `${this.resource}/v1.0/${!isAppOnlyAuth ? 'me' : `users/${args.options.userId || args.options.userName}`}/chats`;
+            if (args.options.type) {
+                requestUrl += `?$filter=chatType eq '${args.options.type}'`;
+            }
             try {
-                const items = yield odata_1.odata.getAllItems(endpoint);
+                const items = yield odata_1.odata.getAllItems(requestUrl);
                 logger.log(items);
             }
             catch (err) {
@@ -58,13 +71,22 @@ _TeamsChatListCommand_instances = new WeakSet(), _TeamsChatListCommand_initTelem
 }, _TeamsChatListCommand_initOptions = function _TeamsChatListCommand_initOptions() {
     this.options.unshift({
         option: '-t, --type [type]',
-        autocomplete: ['oneOnOne', 'group', 'meeting']
+        autocomplete: this.supportedTypes
+    }, {
+        option: '--userId [userId]'
+    }, {
+        option: '--userName [userName]'
     });
 }, _TeamsChatListCommand_initValidators = function _TeamsChatListCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
-        const supportedTypes = ['oneOnOne', 'group', 'meeting'];
-        if (args.options.type !== undefined && supportedTypes.indexOf(args.options.type) === -1) {
-            return `${args.options.type} is not a valid chatType. Accepted values are ${supportedTypes.join(', ')}`;
+        if (args.options.type !== undefined && this.supportedTypes.indexOf(args.options.type) === -1) {
+            return `${args.options.type} is not a valid chatType. Accepted values are ${this.supportedTypes.join(', ')}`;
+        }
+        if (args.options.userId && args.options.userName) {
+            return `You can only specify either 'userId' or 'userName'`;
+        }
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid GUID`;
         }
         return true;
     }));

package/dist/m365/teams/commands/message/message-send.js

@@ -0,0 +1,81 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+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 _TeamsMessageSendCommand_instances, _TeamsMessageSendCommand_initOptions, _TeamsMessageSendCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const validation_1 = require("../../../../utils/validation");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsMessageSendCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.MESSAGE_SEND;
+    }
+    get description() {
+        return 'Sends a message to a channel in a Microsoft Teams team';
+    }
+    constructor() {
+        super();
+        _TeamsMessageSendCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMessageSendCommand_instances, "m", _TeamsMessageSendCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMessageSendCommand_instances, "m", _TeamsMessageSendCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/teams/${args.options.teamId}/channels/${args.options.channelId}/messages`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json'
+                    },
+                    responseType: 'json',
+                    data: {
+                        body: {
+                            contentType: 'html',
+                            content: args.options.message
+                        }
+                    }
+                };
+                const response = yield request_1.default.post(requestOptions);
+                logger.log(response);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_TeamsMessageSendCommand_instances = new WeakSet(), _TeamsMessageSendCommand_initOptions = function _TeamsMessageSendCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --teamId <teamId>'
+    }, {
+        option: '-c, --channelId <channelId>'
+    }, {
+        option: '-m, --message <message>'
+    });
+}, _TeamsMessageSendCommand_initValidators = function _TeamsMessageSendCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.teamId)) {
+            return `${args.options.teamId} is not a valid GUID`;
+        }
+        if (!validation_1.validation.isValidTeamsChannelId(args.options.channelId)) {
+            return `${args.options.channelId} is not a valid Teams ChannelId`;
+        }
+        return true;
+    }));
+};
+module.exports = new TeamsMessageSendCommand();
+//# sourceMappingURL=message-send.js.map

package/dist/m365/teams/commands.js

@@ -35,6 +35,7 @@ exports.default = {
     MESSAGE_GET: `${prefix} message get`,
     MESSAGE_LIST: `${prefix} message list`,
     MESSAGE_REPLY_LIST: `${prefix} message reply list`,
+    MESSAGE_SEND: `${prefix} message send`,
     MESSAGINGSETTINGS_LIST: `${prefix} messagingsettings list`,
     MESSAGINGSETTINGS_SET: `${prefix} messagingsettings set`,
     REPORT_DEVICEUSAGEDISTRIBUTIONUSERCOUNTS: `${prefix} report deviceusagedistributionusercounts`,

package/dist/request.js

@@ -150,10 +150,10 @@ class Request {
             })
                 .then((res) => {
                 if (resolve) {
-                    resolve(options.responseType === 'stream' ? res : res.data);
+                    resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
                 else {
-                    _resolve(options.responseType === 'stream' ? res : res.data);
+                    _resolve((options.responseType === 'stream' || options.fullResponse) ? res : res.data);
                 }
             }, (error) => {
                 if (error && error.response &&

package/dist/utils/formatting.js

@@ -110,6 +110,28 @@ exports.formatting = {
             default:
                 return value;
         }
+    },
+    /**
+     * Converts an object into an xml:
+     * @obj the actual objec
+     * @returns A string containing the xml
+     */
+    objectToXml(obj) {
+        let xml = '';
+        for (const prop in obj) {
+            xml += "<" + prop + ">";
+            if (obj[prop] instanceof Array) {
+                for (const array in obj[prop]) {
+                    xml += this.objectToXml(new Object(obj[prop][array]));
+                }
+            }
+            else {
+                xml += obj[prop];
+            }
+            xml += "</" + prop + ">";
+        }
+        xml = xml.replace(/<\/?[0-9]{1,}>/g, '');
+        return xml;
     }
 };
 //# sourceMappingURL=formatting.js.map

package/docs/docs/cmd/context/option/option-remove.md

@@ -0,0 +1,37 @@
+# context option remove
+
+Removes an already available name from local context file.
+
+## Usage
+
+```sh
+m365 context option remove [options]
+```
+
+## Options
+
+`-n, --name <name>`
+: The name of the option which will be deleted from the context
+
+`--confirm`
+: Don't prompt for confirming removing the option
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes an already available name from the local context file
+
+```sh
+m365 context option remove --name "listName"
+```
+
+Removes an already available name from the local context file without confirmation
+
+```sh
+m365 context option remove --name "listName" --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/option/option-set.md

@@ -0,0 +1,31 @@
+# context option set
+
+Allows to add a new name for the option and value to the local context file.
+
+## Usage
+
+```sh
+m365 context option set [options]
+```
+
+## Options
+
+`-n, --name <name>`
+: The option name for which we will define the value
+
+`-v, --value <value>`
+: Default value for the option
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Define a new default value for name listName in the context
+
+```sh
+m365 context option set --name 'listName' --value 'testList'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/onenote/page/page-list.md

@@ -0,0 +1,140 @@
+# onenote page list
+
+Retrieve a list of OneNote pages.
+
+## Usage
+
+```sh
+m365 onenote page list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: Id of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--userName [userName]`
+: Name of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--groupId [groupId]`
+: Id of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--groupName [groupName]`
+: Name of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`-u, --webUrl [webUrl]`
+: URL of the SharePoint site. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+When we don't specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, the OneNote pages will be retrieved of the currently logged in user.
+
+## Examples
+
+List Microsoft OneNote pages for the currently logged in user
+
+```sh
+m365 onenote page list
+```
+
+List Microsoft OneNote pages in a specific group specified by id
+
+```sh
+m365 onenote page list --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+```
+
+List Microsoft OneNote pages in a specific group specified by name
+
+```sh
+m365 onenote page list --groupName "MyGroup"
+```
+
+List Microsoft OneNote pages for a specific user specified by name
+
+```sh
+m365 onenote page list --userName user1@contoso.onmicrosoft.com
+```
+
+List Microsoft OneNote pages for a specific user specified by id
+
+```sh
+m365 onenote page list --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
+List Microsoft OneNote pages for a specific site
+
+```sh
+m365 onenote page list --webUrl https://contoso.sharepoint.com/sites/testsite
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
+        "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
+        "createdDateTime": "2023-01-07T10:57:15Z",
+        "title": "Page B",
+        "createdByAppId": "",
+        "contentUrl": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content",
+        "lastModifiedDateTime": "2023-01-07T10:57:17Z",
+        "links": {
+          "oneNoteClientUrl": {
+            "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B&section-id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end"
+          },
+          "oneNoteWebUrl": {
+            "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"
+          }
+        },
+        "parentSection": {
+          "id": "1-3eb21088-b613-4698-98df-92a7d34e0678",
+          "displayName": "Test",
+          "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime       title   id
+    --------------------  ------  --------------------------------------------------------------------------
+    2023-01-07T10:57:15Z  Page B  1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    ```
+
+=== "CSV"
+
+    ```csv
+    createdDateTime,title,id
+    2023-01-07T10:57:15Z,Page B,1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    ```
+
+=== "Markdown"
+
+    ```md
+    # onenote page list --userName "mathijs@mathijsdev2.onmicrosoft.com"
+
+    Date: 07/01/2023
+
+    ## Page A (1-a26aaec43ed348bd82edf4eb44e73d6c!14-3eb21088-b613-4698-98df-92a7d34e0678)
+
+    ## Page B (1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678)
+
+    Property | Value
+    ---------|-------
+    id | 1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    self | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    createdDateTime | 2023-01-07T10:57:15Z
+    title | Page B
+    createdByAppId |
+    contentUrl | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content
+    lastModifiedDateTime | 2023-01-07T10:57:17Z
+    links | { "oneNoteClientUrl": { "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B& -id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end" }, "oneNoteWebUrl": { "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"}}
+    parentSection | {"id":"1-3eb21088-b613-4698-98df-92a7d34e0678","displayName":"Test","self":"https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"}
+    ```

package/docs/docs/cmd/planner/bucket/bucket-add.md

@@ -72,3 +72,20 @@ m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan"
     id,name,planId,orderHint
     ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner bucket add  --name "My Planner Bucket" --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
+
+    Date: 27/12/2022
+
+    ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
+
+    Property | Value
+    ---------|-------
+    name | My Planner Bucket
+    planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    orderHint | 8585363889524958496
+    id | ttEB_Uj690STdR3GC1MIDZgANq1U
+    ```

package/docs/docs/cmd/planner/bucket/bucket-get.md

@@ -84,3 +84,20 @@ m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerG
     id,name,planId,orderHint
     ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner bucket get --id "ttEB_Uj690STdR3GC1MIDZgANq1U"
+
+    Date: 27/12/2022
+
+    ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
+
+    Property | Value
+    ---------|-------
+    name | My Planner Bucket
+    planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    orderHint | 8585363889524958496
+    id | ttEB_Uj690STdR3GC1MIDZgANq1U
+    ```

package/docs/docs/cmd/planner/bucket/bucket-list.md

@@ -67,3 +67,20 @@ m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
     id,name,planId,orderHint
     ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner bucket list --planId "xqQg5FS2LkCp935s-FIFm2QAFkHM"
+
+    Date: 27/12/2022
+
+    ## My Planner Bucket (ttEB_Uj690STdR3GC1MIDZgANq1U)
+
+    Property | Value
+    ---------|-------
+    name | My Planner Bucket
+    planId | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    orderHint | 8585363889524958496
+    id | ttEB_Uj690STdR3GC1MIDZgANq1U
+    ```

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

@@ -97,6 +97,25 @@ m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Gro
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
 
+=== "Markdown"
+
+    ```md
+    # planner plan add --title "My Planner Plan" --ownerGroupId "ebf3b108-5234-4e22-b93d-656d7dae5874"
+
+    Date: 30/03/2015
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"95e27074-6c4a-447a-aa24-9d718a0b86fa"},"application":{"displayName":null,"id":"ebf3b108-5234-4e22-b93d-656d7dae5874"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    ```
+
 ### `shareWithUserIds`, `shareWithUserNames` response
 
 When we make use of the option `shareWithUserIds` or `shareWithUserNames` the response will differ. 
@@ -173,3 +192,24 @@ When we make use of the option `shareWithUserIds` or `shareWithUserNames` the re
     id,title,createdDateTime,owner
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner plan add --title "My Planner Plan" --ownerGroupId "ebf3b108-5234-4e22-b93d-656d7dae5874" --shareWithUserNames "Allan.Carroll@contoso.com,Ida.Stevens@contoso.com"
+
+    Date: 30/03/2015
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    sharedWith | {"ebf3b108-5234-4e22-b93d-656d7dae5874":true,"6463a5ce-2119-4198-9f2a-628761df4a62":true}
+    categoryDescriptions | {"category1":null,"category2":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null}
+    ```

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

@@ -118,3 +118,24 @@ m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
     id,title,createdDateTime,owner
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner plan get --id "xqQg5FS2LkCp935s-FIFm2QAFkHM"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    sharedWith | {"aa089c1a-0ca8-4b36-ae2e-c5d60f054a2c":true,"ebf3b108-5234-4e22-b93d-656d7dae5874":true}
+    categoryDescriptions | {"category1":null,"category2":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null}
+    ```

package/docs/docs/cmd/planner/plan/plan-list.md

@@ -76,3 +76,22 @@ m365 planner plan list --ownerGroupName "My Planner Group"
     id,title,createdDateTime,owner
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
+
+=== "Markdown"
+
+    ```md
+    # planner plan list --ownerGroupId "ebf3b108-5234-4e22-b93d-656d7dae5874"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2021-12-12T14:00:50.4522129Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"09abbdfd-ed23-44ee-a2d9-a627aa1c90f3"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    ```

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

@@ -142,3 +142,23 @@ m365 planner plan set --id 'gndWOTSK60GfPQfiDDj43JgACDCb' --category21 'ToDo' --
     xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
     ```
 
+=== "Markdown"
+
+    ```md
+    # planner plan set --id "xqQg5FS2LkCp935s-FIFm2QAFkHM" --newTitle "My Planner Plan"
+
+    Date: 27/12/2022
+
+    ## My Planner Plan (xqQg5FS2LkCp935s-FIFm2QAFkHM)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2015-03-30T18:36:49.2407981Z
+    owner | ebf3b108-5234-4e22-b93d-656d7dae5874
+    title | My Planner Plan
+    id | xqQg5FS2LkCp935s-FIFm2QAFkHM
+    createdBy | {"user":{"displayName":null,"id":"dd8b99a7-77c6-4238-a609-396d27844921"},"application":{"displayName":null,"id":"31359c7f-bd7e-475c-86db-fdb8c937548e"}}
+    container | {"containerId":"ebf3b108-5234-4e22-b93d-656d7dae5874","type":"group","url":"https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"}
+    sharedWith | {"ebf3b108-5234-4e22-b93d-656d7dae5874":true,"6463a5ce-2119-4198-9f2a-628761df4a62":true}
+    categoryDescriptions | {"category1":null,"category2":null,"category3":null,"category4":null,"category5":null,"category6":null,"category7":null,"category8":null,"category9":null,"category10":null,"category11":null,"category12":null,"category13":null,"category14":null,"category15":null,"category16":null,"category17":null,"category18":null,"category19":null,"category20":null,"category21":null,"category22":null,"category23":null,"category24":null,"category25":null}
+    ```