@pnp/cli-microsoft365 6.1.0 → 6.2.0-beta.0ce0a85

package/dist/m365/spo/commands/listitem/listitem-retentionlabel-ensure.js

@@ -0,0 +1,161 @@
+"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 _SpoListItemRetentionLabelEnsureCommand_instances, _SpoListItemRetentionLabelEnsureCommand_initTelemetry, _SpoListItemRetentionLabelEnsureCommand_initOptions, _SpoListItemRetentionLabelEnsureCommand_initValidators, _SpoListItemRetentionLabelEnsureCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const formatting_1 = require("../../../../utils/formatting");
+const urlUtil_1 = require("../../../../utils/urlUtil");
+const validation_1 = require("../../../../utils/validation");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+const SpoWebRetentionLabelListCommand = require("../web/web-retentionlabel-list");
+const Cli_1 = require("../../../../cli/Cli");
+class SpoListItemRetentionLabelEnsureCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.LISTITEM_RETENTIONLABEL_ENSURE;
+    }
+    get description() {
+        return 'Apply a retention label to a list item';
+    }
+    constructor() {
+        super();
+        _SpoListItemRetentionLabelEnsureCommand_instances.add(this);
+        __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _SpoListItemRetentionLabelEnsureCommand_instances, "m", _SpoListItemRetentionLabelEnsureCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const labelInformation = yield this.getLabelInformation(args.options, logger);
+                yield this.applyLabel(args.options, labelInformation, logger);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+    getLabelInformation(options, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const cmdOptions = {
+                webUrl: options.webUrl,
+                output: 'json',
+                debug: options.debug,
+                verbose: options.verbose
+            };
+            const output = yield Cli_1.Cli.executeCommandWithOutput(SpoWebRetentionLabelListCommand, { options: Object.assign(Object.assign({}, cmdOptions), { _: [] }) });
+            if (this.verbose) {
+                logger.logToStderr(output.stderr);
+            }
+            const labels = JSON.parse(output.stdout);
+            const label = labels.find(l => l.TagName === options.name || l.TagId === options.id);
+            if (this.verbose && label !== undefined) {
+                logger.logToStderr(`Retention label found in the list of available labels: '${label.TagName}' / '${label.TagId}'...`);
+            }
+            if (label === undefined) {
+                throw new Error(`The specified retention label does not exist`);
+            }
+            return {
+                complianceTag: label.TagName,
+                isTagPolicyHold: label.BlockDelete,
+                isTagPolicyRecord: label.BlockEdit,
+                isEventBasedTag: label.IsEventTag,
+                isTagSuperLock: label.SuperLock,
+                isUnlockedAsDefault: label.UnlockedAsDefault
+            };
+        });
+    }
+    applyLabel(options, labelInformation, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Applying retention label to item in list '${options.listId || options.listTitle || options.listUrl}' in site at ${options.webUrl}...`);
+            }
+            let requestUrl = `${options.webUrl}/_api/web`;
+            if (options.listId) {
+                requestUrl += `/lists(guid'${formatting_1.formatting.encodeQueryParameter(options.listId)}')/items(${options.listItemId})/SetComplianceTag()`;
+            }
+            else if (options.listTitle) {
+                requestUrl += `/lists/getByTitle('${formatting_1.formatting.encodeQueryParameter(options.listTitle)}')/items(${options.listItemId})/SetComplianceTag()`;
+            }
+            else if (options.listUrl) {
+                const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
+                requestUrl += `/GetList(@listUrl)/items(${options.listItemId})/SetComplianceTag()?@listUrl='${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}'`;
+            }
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                data: labelInformation,
+                responseType: 'json'
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
+}
+_SpoListItemRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoListItemRetentionLabelEnsureCommand_initTelemetry = function _SpoListItemRetentionLabelEnsureCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            listId: typeof args.options.listId !== 'undefined',
+            listTitle: typeof args.options.listTitle !== 'undefined',
+            listUrl: typeof args.options.listUrl !== 'undefined',
+            name: typeof args.options.name !== 'undefined',
+            id: typeof args.options.id !== 'undefined'
+        });
+    });
+}, _SpoListItemRetentionLabelEnsureCommand_initOptions = function _SpoListItemRetentionLabelEnsureCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --webUrl <webUrl>'
+    }, {
+        option: '--listItemId <listItemId>'
+    }, {
+        option: '--listId [listId]'
+    }, {
+        option: '--listTitle [listTitle]'
+    }, {
+        option: '--listUrl [listUrl]'
+    }, {
+        option: '-n, --name [name]'
+    }, {
+        option: '-i, --id [id]'
+    });
+}, _SpoListItemRetentionLabelEnsureCommand_initValidators = function _SpoListItemRetentionLabelEnsureCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        const id = parseInt(args.options.listItemId);
+        if (isNaN(id)) {
+            return `${args.options.listItemId} is not a valid list item ID`;
+        }
+        const isValidSharePointUrl = validation_1.validation.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (args.options.listId &&
+            !validation_1.validation.isValidGuid(args.options.listId)) {
+            return `${args.options.listId} is not a valid GUID`;
+        }
+        if (args.options.id &&
+            !validation_1.validation.isValidGuid(args.options.id)) {
+            return `${args.options.id} is not a valid GUID`;
+        }
+        return true;
+    }));
+}, _SpoListItemRetentionLabelEnsureCommand_initOptionSets = function _SpoListItemRetentionLabelEnsureCommand_initOptionSets() {
+    this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] });
+    this.optionSets.push({ options: ['name', 'id'] });
+};
+module.exports = new SpoListItemRetentionLabelEnsureCommand();
+//# sourceMappingURL=listitem-retentionlabel-ensure.js.map

package/dist/m365/spo/commands.js

@@ -62,6 +62,9 @@ exports.default = {
     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`,
@@ -143,8 +146,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/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/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}
+    ```

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-list.md

@@ -0,0 +1,95 @@
+# pp aibuildermodel list
+
+List available AI builder models in the specified Power Platform environment
+
+## Usage
+
+```sh
+pp aibuildermodel list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all AI Builder models in a specific environment
+
+```sh
+m365 pp aibuildermodel list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+```
+
+List all AI Builder models in a specific environment as admin
+
+```sh
+m365 pp aibuildermodel list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "statecode": 0,
+        "_msdyn_templateid_value": "10707e4e-1d56-e911-8194-000d3a6cd5a5",
+        "msdyn_modelcreationcontext": "{}",
+        "createdon": "2022-11-29T11:58:45Z",
+        "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "modifiedon": "2022-11-29T11:58:45Z",
+        "msdyn_sharewithorganizationoncreate": false,
+        "msdyn_aimodelidunique": "b0328b67-47e2-4202-8189-e617ec9a88bd",
+        "solutionid": "fd140aae-4df4-11dd-bd17-0019b9312238",
+        "ismanaged": false,
+        "versionnumber": 1458121,
+        "msdyn_name": "Document Processing 11/29/2022, 12:58:43 PM",
+        "introducedversion": "1.0",
+        "statuscode": 0,
+        "_modifiedby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "overwritetime": "1900-01-01T00:00:00Z",
+        "componentstate": 0,
+        "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "msdyn_aimodelid": "08ffffbe-ec1c-4e64-b64b-dd1db926c613",
+        "_msdyn_activerunconfigurationid_value": null,
+        "overriddencreatedon": null,
+        "_msdyn_retrainworkflowid_value": null,
+        "importsequencenumber": null,
+        "_msdyn_scheduleinferenceworkflowid_value": null,
+        "_modifiedonbehalfby_value": null,
+        "utcconversiontimezonecode": null,
+        "_createdonbehalfby_value": null,
+        "_owningteam_value": null,
+        "timezoneruleversionnumber": null,
+        "iscustomizable": {
+          "Value": true,
+          "CanBeChanged": true,
+          "ManagedPropertyLogicalName": "iscustomizableanddeletable"
+        }
+      }
+    ]
+    ```
+
+=== "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
+    ```
+
+=== "CSV"
+
+    ```csv
+    msdyn_name,msdyn_aimodelid,createdon,modifiedon
+    "Document Processing 11/29/2022, 12:58:43 PM",08ffffbe-ec1c-4e64-b64b-dd1db926c613,2022-11-29T11:58:45Z,2022-11-29T11:58:45Z
+    ```

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-get.md

@@ -0,0 +1,95 @@
+# purview retentionlabel get
+
+Get a retention label
+
+## Usage
+
+```sh
+m365 purview retentionlabel get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention label.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a retention label
+
+```sh
+m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## Response
+
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "TEST LABEL",
+      "descriptionForAdmins": "",
+      "descriptionForUsers": "",
+      "isInUse": false,
+      "retentionTrigger": "dateCreated",
+      "behaviorDuringRetentionPeriod": "retain",
+      "actionAfterRetentionPeriod": "delete",
+      "createdDateTime": "2022-12-12T15:14:53Z",
+      "lastModifiedDateTime": "2022-12-12T15:43:06Z",
+      "labelToBeApplied": "",
+      "defaultRecordBehavior": "startLocked",
+      "id": "5c8af2e2-b489-4fa0-9c16-180180245ac8",
+      "retentionDuration": {
+        "days": 100
+      },
+      "createdBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "lastModifiedBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "dispositionReviewStages": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    actionAfterRetentionPeriod   : delete
+    behaviorDuringRetentionPeriod: retain
+    createdBy                    : {"user":{"id":null,"displayName":"John Doe"}}
+    createdDateTime              : 2022-12-12T15:14:53Z
+    defaultRecordBehavior        : startLocked
+    descriptionForAdmins         :
+    descriptionForUsers          :
+    displayName                  : TEST LABEL
+    dispositionReviewStages      : []
+    id                           : 5c8af2e2-b489-4fa0-9c16-180180245ac8
+    isInUse                      : false
+    labelToBeApplied             :
+    lastModifiedBy               : {"user":{"id":null,"displayName":"John Doe"}}
+    lastModifiedDateTime         : 2022-12-12T15:43:06Z
+    retentionDuration            : {"days":100}
+    retentionTrigger             : dateCreated
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,descriptionForAdmins,descriptionForUsers,isInUse,retentionTrigger,behaviorDuringRetentionPeriod,actionAfterRetentionPeriod,createdDateTime,lastModifiedDateTime,labelToBeApplied,defaultRecordBehavior,id,retentionDuration,createdBy,lastModifiedBy,dispositionReviewStages
+    TEST LABEL,,,,dateCreated,retain,delete,2022-12-12T15:14:53Z,2022-12-12T15:43:06Z,,startLocked,5c8af2e2-b489-4fa0-9c16-180180245ac8,"{""days"":100}","{""user"":{""id"":null,""displayName"":""John Doe""}}","{""user"":{""id"":null,""displayName"":""John Doe""}}",[]
+    ```