@pnp/cli-microsoft365 6.7.0-beta.f5f5666 → 6.8.0-beta.2463cfa

package/dist/m365/teams/commands/meeting/meeting-transcript-list.js

@@ -0,0 +1,124 @@
+"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 _TeamsMeetingTranscriptListCommand_instances, _TeamsMeetingTranscriptListCommand_initTelemetry, _TeamsMeetingTranscriptListCommand_initOptions, _TeamsMeetingTranscriptListCommand_initValidators, _TeamsMeetingTranscriptListCommand_initOptionSets;
+Object.defineProperty(exports, "__esModule", { value: true });
+const Auth_1 = require("../../../../Auth");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+const odata_1 = require("../../../../utils/odata");
+const validation_1 = require("../../../../utils/validation");
+const accessToken_1 = require("../../../../utils/accessToken");
+const aadUser_1 = require("../../../../utils/aadUser");
+class TeamsMeetingTranscriptListCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.MEETING_TRANSCRIPT_LIST;
+    }
+    get description() {
+        return 'Lists all transcripts for a given meeting';
+    }
+    defaultProperties() {
+        return ['id', 'createdDateTime'];
+    }
+    constructor() {
+        super();
+        _TeamsMeetingTranscriptListCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initTelemetry).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initValidators).call(this);
+        __classPrivateFieldGet(this, _TeamsMeetingTranscriptListCommand_instances, "m", _TeamsMeetingTranscriptListCommand_initOptionSets).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+                if (this.verbose) {
+                    logger.logToStderr(`Retrieving transcript list for the given meeting...`);
+                }
+                let requestUrl = `${this.resource}/beta/`;
+                if (isAppOnlyAccessToken) {
+                    if (!args.options.userId && !args.options.userName && !args.options.email) {
+                        throw `The option 'userId', 'userName' or 'email' is required when retrieving meeting transcripts list using app only permissions`;
+                    }
+                    requestUrl += 'users/';
+                    if (args.options.userId) {
+                        requestUrl += args.options.userId;
+                    }
+                    else if (args.options.userName) {
+                        requestUrl += args.options.userName;
+                    }
+                    else if (args.options.email) {
+                        if (this.verbose) {
+                            logger.logToStderr(`Getting user ID for user with email '${args.options.email}'.`);
+                        }
+                        const userId = yield aadUser_1.aadUser.getUserIdByEmail(args.options.email);
+                        requestUrl += userId;
+                    }
+                }
+                else {
+                    if (args.options.userId || args.options.userName || args.options.email) {
+                        throw `The options 'userId', 'userName' and 'email' cannot be used while retrieving meeting transcripts using delegated permissions`;
+                    }
+                    requestUrl += `me`;
+                }
+                requestUrl += `/onlineMeetings/${args.options.meetingId}/transcripts`;
+                const res = yield odata_1.odata.getAllItems(requestUrl);
+                logger.log(res);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_TeamsMeetingTranscriptListCommand_instances = new WeakSet(), _TeamsMeetingTranscriptListCommand_initTelemetry = function _TeamsMeetingTranscriptListCommand_initTelemetry() {
+    this.telemetry.push((args) => {
+        Object.assign(this.telemetryProperties, {
+            userId: typeof args.options.userId !== 'undefined',
+            userName: typeof args.options.userName !== 'undefined',
+            email: typeof args.options.email !== 'undefined'
+        });
+    });
+}, _TeamsMeetingTranscriptListCommand_initOptions = function _TeamsMeetingTranscriptListCommand_initOptions() {
+    this.options.unshift({
+        option: '-u, --userId [userId]'
+    }, {
+        option: '-n, --userName [userName]'
+    }, {
+        option: '--email [email]'
+    }, {
+        option: '-m, --meetingId <meetingId>'
+    });
+}, _TeamsMeetingTranscriptListCommand_initValidators = function _TeamsMeetingTranscriptListCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (args.options.userId && !validation_1.validation.isValidGuid(args.options.userId)) {
+            return `${args.options.userId} is not a valid Guid`;
+        }
+        if (args.options.userName && !validation_1.validation.isValidUserPrincipalName(args.options.userName)) {
+            return `${args.options.userName} is not a valid user principal name (UPN)`;
+        }
+        if (args.options.email && !validation_1.validation.isValidUserPrincipalName(args.options.email)) {
+            return `${args.options.email} is not a valid email`;
+        }
+        return true;
+    }));
+}, _TeamsMeetingTranscriptListCommand_initOptionSets = function _TeamsMeetingTranscriptListCommand_initOptionSets() {
+    this.optionSets.push({
+        options: ['userId', 'userName', 'email'],
+        runsWhen: (args) => args.options.userId || args.options.userName || args.options.email
+    });
+};
+module.exports = new TeamsMeetingTranscriptListCommand();
+//# sourceMappingURL=meeting-transcript-list.js.map

package/dist/m365/teams/commands.js

@@ -30,6 +30,7 @@ exports.default = {
     MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
     MEETING_GET: `${prefix} meeting get`,
     MEETING_LIST: `${prefix} meeting list`,
+    MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
     MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
     MEMBERSETTINGS_SET: `${prefix} membersettings set`,
     MESSAGE_GET: `${prefix} message get`,

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

@@ -19,6 +19,9 @@ m365 flow run get [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located
 
+`--includeTriggerInformation`
+: If specified, include information about the trigger details
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -32,6 +35,8 @@ If the Microsoft Flow with the name you specified doesn't exist, you will get th
 
 If the run with the name you specified doesn't exist, you will get the `The provided workflow run name is not valid.` error.
 
+If the option `includeTriggerInformation` is specified, but the trigger does not contain an outputsLink such as for example with a `Recurrence` trigger, this option will be ignored.
+
 ## Examples
 
 Get information about the given run of the specified Power Automate flow
@@ -40,6 +45,11 @@ Get information about the given run of the specified Power Automate flow
 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
+
+```sh
+m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62 --includeTriggerInformation
+```
 
 ## Response
 
@@ -61,7 +71,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
         "trigger": {
           "name": "When_a_new_response_is_submitted",
           "inputsLink": {
-            "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=jmdMRWvY7uGoxTmqd3_a2bJtegXuVyuKTKKUVLiwh38",
+            "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=",
             "contentVersion": "6ZrBBE+MJg7IvhMgyJLMmA==",
             "contentSize": 349,
             "contentHash": {
@@ -70,7 +80,7 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
             }
           },
           "outputsLink": {
-            "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=Y3qqjuWrrcQJrmF7uvm6LVzQy5w-dNOFWJ8Yt8khXvA",
+            "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=",
             "contentVersion": "Z/4a8tfYygNAR1xpc44iww==",
             "contentSize": 493,
             "contentHash": {
@@ -97,17 +107,108 @@ m365 flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 === "Text"
 
     ```text
-    endTime    :
-    name       : 08585329112602833828909892130CU17
-    startTime  : 2022-11-17T14:33:45.2763872Z
-    status     : Running
-    triggerName: When_a_new_response_is_submitted
+    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)
     ```
 
 === "CSV"
 
     ```csv
     name,startTime,endTime,status,triggerName
-    08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,,Running,When_a_new_response_is_submitted
+    08585236861638480597867166179CU104,2023-03-04T09:05:21.8066368Z,2023-03-04T09:05:22.5880202Z,Succeeded,When_an_email_is_flagged_(V4)
+    ```
+
+=== "Markdown"
+
+    ```md
+    # flow run get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --name 08586653536760200319026785874CU62
+
+    Date: 04/03/2023
+
+    ## 08586653536760200319026785874CU62 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/5923cb07-ce1a-4a5c-ab81-257ce820109a/runs/08586653536760200319026785874CU62)
+
+    Property | Value
+    ---------|-------
+    name | 08586653536760200319026785874CU62
+    id | /providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/c3c707b5-fefd-4f7a-a96c-b8e0d5ca3cc1/runs/08585208964855963748594654409CU47
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    startTime | 2023-03-04T09:05:21.8066368Z
+    endTime | 2023-03-04T09:05:22.5880202Z
+    status | Succeeded
+    triggerName | When\_an\_email\_is\_flagged\_(V4)
+    ```
+
+### `includeTriggerInformation` response
+
+When using the option `includeTriggerInformation`, the response for the json-output will differ.
+
+=== "JSON"
+
+    ```json
+    {
+      "name": "08585236861638480597867166179CU104",
+      "id": "/providers/Microsoft.ProcessSimple/environments/Default-e1dd4023-a656-480a-8a0e-c1b1eec51e1d/flows/24335774-daf6-4183-acb7-f5155c2cd2fe/runs/08585236861638480597867166179CU104",
+      "type": "Microsoft.ProcessSimple/environments/flows/runs",
+      "properties": {
+        "startTime": "2023-03-04T09:05:21.8066368Z",
+        "endTime": "2023-03-04T09:05:22.5880202Z",
+        "status": "Succeeded",
+        "correlation": {
+          "clientTrackingId": "08585236861638480598867166179CU131"
+        },
+        "trigger": {
+          "name": "When_an_email_is_flagged_(V4)",
+          "inputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerInputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerInputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "2v/VLXFrKV6JvwSdcN7aHg==",
+            "contentSize": 343,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "2v/VLXFrKV6JvwSdcN7aHg=="
+            }
+          },
+          "outputsLink": {
+            "uri": "https://prod-130.westeurope.logic.azure.com:443/workflows/3ebadb794f6641e0b7f4fda131cdfb0b/runs/08585236861638480597867166179CU104/contents/TriggerOutputs?api-version=2016-06-01&se=2023-03-04T14%3A00%3A00.0000000Z&sp=%2Fruns%2F08585236861638480597867166179CU104%2Fcontents%2FTriggerOutputs%2Fread&sv=1.0&sig=",
+            "contentVersion": "AHZEeWNlQ0bLe48yDmpzrQ==",
+            "contentSize": 3478,
+            "contentHash": {
+              "algorithm": "md5",
+              "value": "AHZEeWNlQ0bLe48yDmpzrQ=="
+            }
+          },
+          "startTime": "2023-03-04T09:05:21.6192576Z",
+          "endTime": "2023-03-04T09:05:21.7442626Z",
+          "scheduledTime": "2023-03-04T09:05:21.573561Z",
+          "originHistoryName": "08585236861638480598867166179CU131",
+          "correlation": {
+            "clientTrackingId": "08585236861638480598867166179CU131"
+          },
+          "code": "OK",
+          "status": "Succeeded"
+        }
+      },
+      "startTime": "2023-03-04T09:05:21.8066368Z",
+      "endTime": "2023-03-04T09:05:22.5880202Z",
+      "status": "Succeeded",
+      "triggerName": "When_an_email_is_flagged_(V4)",
+      "triggerInformation": {
+        "from": "john@contoso.com",
+        "toRecipients": "doe@contoso.com",
+        "subject": "Dummy email",
+        "body": "<html><head>\r\\\n<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body><p>This is dummy content</p></body></html>",
+        "importance": "normal",
+        "bodyPreview": "This is dummy content",
+        "hasAttachments": false,
+        "id": "AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALUqy81AAA=",
+        "internetMessageId": "<DB7PR03MB5018879914324FC65695809FE1AD9@DB7PR03MB5018.eurprd03.prod.outlook.com>",
+        "conversationId": "AAQkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgAQAMqP9zsK8a1CnIYEgHclLTk=",
+        "receivedDateTime": "2023-03-01T15:06:57+00:00",
+        "isRead": false,
+        "attachments": [],
+        "isHtml": true
+      }
+    }
     ```
-	

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

@@ -0,0 +1,109 @@
+# planner roster plan list
+
+Lists all Microsoft Planner Roster plans for a specific user
+
+## Usage
+
+```sh
+m365 planner roster plan list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: User's Azure AD ID. Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both. Specify this option only when using application permissions.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+List all Planner plans contained in a Roster where the current logged in user is member of.
+
+```sh
+m365 planner roster plan list
+```
+
+List all Planner plans contained in a Roster where specific user is member of by its UPN.
+
+```sh
+m365 planner roster plan list --userName john.doe@contoso.com
+```
+
+List all Planner plans contained in a Roster where specific user is member of by its Id.
+
+```sh
+m365 planner roster plan list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "createdDateTime": "2023-04-06T14:41:49.8676617Z",
+        "owner": "59f80e08-24b1-41f8-8586-16765fd830d3",
+        "title": "My Planner Plan",
+        "creationSource": null,
+        "id": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
+        "createdBy": {
+          "user": {
+            "displayName": null,
+            "id": "59f80e08-24b1-41f8-8586-16765fd830d3"
+          },
+          "application": {
+            "displayName": null,
+            "id": "31359c7f-bd7e-475c-86db-fdb8c937548e"
+          }
+        },
+        "container": {
+          "containerId": "_5GY9MJpZU2vb3DC46CP3MkACr8m",
+          "type": "unknownFutureValue",
+          "url": "https://graph.microsoft.com/beta/planner/rosters/_5GY9MJpZU2vb3DC46CP3MkACr8m"
+        },
+        "contexts": {},
+        "sharedWithContainers": []
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                            title            createdDateTime               owner
+    ----------------------------  ---------------  ----------------------------  ------------------------------------
+    _5GY9MJpZU2vb3DC46CP3MkACr8m  My Planner Plan  2023-04-06T14:41:49.8676617Z  59f80e08-24b1-41f8-8586-16765fd830d3
+    ```
+
+=== "CSV"
+
+    ```csv
+    createdDateTime,owner,title,id
+    2023-04-06T14:41:49.8676617Z,59f80e08-24b1-41f8-8586-16765fd830d3,My Planner Plan,_5GY9MJpZU2vb3DC46CP3MkACr8m
+    ```
+
+=== "Markdown"
+
+    ```md
+    # planner roster plan list --userId "59f80e08-24b1-41f8-8586-16765fd830d3"
+
+    Date: 4/8/2023
+
+    ## My Planner Plan (_5GY9MJpZU2vb3DC46CP3MkACr8m)
+
+    Property | Value
+    ---------|-------
+    createdDateTime | 2023-04-06T14:41:49.8676617Z
+    owner | 59f80e08-24b1-41f8-8586-16765fd830d3
+    title | My Planner Plan
+    id | \_5GY9MJpZU2vb3DC46CP3MkACr8m
+    ```

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

@@ -50,7 +50,7 @@ m365 planner task add [options]
 : Hint used to order items of this type in a list view. The format is defined as outlined [here](https://docs.microsoft.com/graph/api/resources/planner-order-hint-format?view=graph-rest-1.0).
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--appliedCategories [appliedCategories]`
 : Comma-separated categories that should be added to the task. The possible options are: `category1`, `category2`, `category3`, `category4`, `category5` and/or `category6`. Additional info defined [here](https://docs.microsoft.com/graph/api/resources/plannerappliedcategories?view=graph-rest-1.0).
@@ -81,6 +81,8 @@ When you specify an integer value for `priority`, consider the following:
 - values 5, 6 and 7 are interpreted as _Medium_
 - values 8, 9 and 10 are interpreted as _Low_
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Adds a Microsoft Planner task with the name _My Planner Task_ for plan with the ID _8QZEH7b3wkSbGQobscsM5gADCBa_ and for the bucket with the ID _IK8tuFTwQEa5vTonM7ZMRZgAKdna_

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

@@ -50,16 +50,16 @@ m365 planner task set [options]
 : Comma-separated UPNs of the assignees that should be added to the task assignment. Specify either `assignedToUserIds` or `assignedToUserNames` but not both.
 
 `--description [description]`
-: Description of the task
+: Description of the task.
 
 `--orderHint [orderHint]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--assigneePriority [assigneePriority]`
-: Hint used to order items of this type in a list view
+: Hint used to order items of this type in a list view.
 
 `--appliedCategories [appliedCategories]`
-: Comma-separated categories that should be added to the task
+: Comma-separated categories that should be added to the task.
 
 `--priority [priority]`
 : Priority of the task: Urgent, Important, Medium, Low. Or an integer between 0 and 10 (check remarks section for more info).
@@ -83,6 +83,8 @@ When you specify an integer value for `priority`, consider the following:
 
 You can add up to 6 categories to the task. An example to add _category1_ and _category3_ would be `category1,category3`.
 
+When using `description` with a multiple lines value, use the new line character of the shell you are using to indicate line breaks. For PowerShell this is `` `n ``. For Zsh or Bash use `\n` with a `$` in front. E.g. `$"Line 1\nLine 2"`.
+
 ## Examples
 
 Updates a Microsoft Planner task name to _My Planner Task_ for the task with the ID _Z-RLQGfppU6H3663DBzfs5gAMD3o_

package/docs/docs/cmd/spo/feature/feature-enable.md

@@ -33,11 +33,11 @@ If the specified url doesn't refer to an existing site collection, you will get
 Enable site feature
 
 ```sh
-m365 spo feature enable --url https://contoso.sharepoint.com/sites/sales --featureId 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
+m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 915c240e-a6cc-49b8-8b2c-0bff8b553ed3 --scope Site
 ```
 
 Enable web feature (with force to overwrite feature with same id)
 
 ```sh
-m365 spo feature enable --url https://contoso.sharepoint.com/sites/sales --featureId 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
+m365 spo feature enable --webUrl https://contoso.sharepoint.com/sites/sales --id 00bfea71-5932-4f9c-ad71-1557e5751100 --scope Web --force
 ```

package/docs/docs/cmd/spo/file/file-list.md

@@ -16,21 +16,106 @@ m365 spo file list [options]
 `-f, --folder <folder>`
 : The server- or site-relative URL of the folder from which to retrieve files
 
+`--fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
+
+`--filter [filter]`
+: OData filter to use to query the list of items with
+
 `-r, --recursive`
 : Set to retrieve files from subfolders
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+When the `fields` option includes values with a `/`, for example: `ListItemAllFields/Id`, an additional `$expand` query parameter will be included on `ListItemAllFields`.
+
 ## Examples
 
-Return all files from folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents'
 ```
 
-Return all files from the folder _Shared Documents_ and all the sub-folders of _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Return all files from a folder and all the sub-folders
 
 ```sh
 m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --recursive
 ```
+
+Return the files from a folder with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields "Title,Length"
+```
+
+Return the files from a folder that meet the criteria of the filter with specific fields which will be expanded
+
+```sh
+m365 spo file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --fields ListItemAllFields/Id --filter "Name eq 'document.docx'"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "CheckInComment": "",
+        "CheckOutType": 2,
+        "ContentTag": "{F09C4EFE-B8C0-4E89-A166-03418661B89B},9,12",
+        "CustomizedPageStatus": 0,
+        "ETag": "\"{F09C4EFE-B8C0-4E89-A166-03418661B89B},9\"",
+        "Exists": true,
+        "IrmEnabled": false,
+        "Length": 331673,
+        "Level": 1,
+        "LinkingUri": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "LinkingUrl": "https://contoso.sharepoint.com/sites/project-x/Shared Documents/Document.docx?d=wf09c4efeb8c04e89a16603418661b89b",
+        "MajorVersion": 3,
+        "MinorVersion": 0,
+        "Name": "Document.docx",
+        "ServerRelativeUrl": "/sites/project-x/Shared Documents/Document.docx",
+        "TimeCreated": "2018-02-05T08:42:36Z",
+        "TimeLastModified": "2018-02-05T08:44:03Z",
+        "Title": "",
+        "UIVersion": 1536,
+        "UIVersionLabel": "3.0",
+        "UniqueId": "f09c4efe-b8c0-4e89-a166-03418661b89b"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name                               ServerRelativeUrl                                UniqueId
+    ---------------------------------  -----------------------------------------------  ------------------------------------
+    Document.docx                      /sites/project-x/Shared Documents/Document.docx  5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,ServerRelativeUrl,UniqueId
+    Document.docx,/sites/project-x/Shared Documents/Document.docx,5eb97525-2167-4d26-94b8-092a97d65716
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo file list --webUrl "https://contoso.sharepoint.com" --folder "Shared Documents"
+
+    Date: 23/3/2023
+
+    ## Document.docx (5eb97525-2167-4d26-94b8-092a97d65716)
+
+    Property | Value
+    ---------|-------
+    Name | Document.docx
+    ServerRelativeUrl | /sites/project-x/Shared Documents/Document.docx
+    UniqueId | 5eb97525-2167-4d26-94b8-092a97d65716
+    ```

package/docs/docs/cmd/spo/folder/folder-list.md

@@ -16,6 +16,12 @@ m365 spo folder list [options]
 `-p, --parentFolderUrl <parentFolderUrl>`
 : Site-relative URL of the parent folder
 
+`-f, --fields [fields]`
+: Comma-separated list of fields to retrieve. Will retrieve all fields if not specified and json output is requested.
+
+`--filter [filter]`
+: OData filter to use to query the list of folders with.
+
 `-r, --recursive`
 : Set to retrieve nested folders
 
@@ -23,7 +29,7 @@ m365 spo folder list [options]
 
 ## Examples
 
-Gets list of folders under a parent folder with site-relative url _/Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
+Gets list of folders under a parent folder
 
 ```sh
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents'
@@ -35,6 +41,12 @@ Gets recursive list of folders under a specific folder on a specific site
 m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --recursive
 ```
 
+Return a filtered list of folders and only return the list item ID
+
+```sh
+m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/Shared Documents' --fields ListItemAllFields/Id --filter "startswith(Name,'Folder')"
+```
+
 ## Response
 
 === "JSON"
@@ -70,3 +82,26 @@ m365 spo folder list --webUrl https://contoso.sharepoint.com/sites/project-x --p
     Name,ServerRelativeUrl
     Folder A,/Shared Documents/Folder A
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo folder list --webUrl "https://contoso.sharepoint.com" --parentFolderUrl "/Shared Documents"
+
+    Date: 29/3/2023
+
+    ## Folder A (20523746-971b-4488-aa6d-b45d645f61c5)
+
+    Property | Value
+    ---------|-------
+    Exists | true
+    IsWOPIEnabled | false
+    ItemCount | 9
+    Name | Folder A
+    ProgID | null
+    ServerRelativeUrl | /Shared Documents/Folder A
+    TimeCreated | 2022-04-26T12:30:56Z
+    TimeLastModified | 2022-04-26T12:50:14Z
+    UniqueId | 20523746-971b-4488-aa6d-b45d645f61c5
+    WelcomePage |
+    ```

package/docs/docs/cmd/spo/spo-get.md

@@ -46,3 +46,15 @@ m365 spo get --output json
     SpoUrl
     https://contoso.sharepoint.com
     ```
+
+=== "Markdown"
+
+    ```md
+    # spo get 
+
+    Date: 4/10/2023
+
+    Property | Value
+    ---------|-------
+    SpoUrl | https://contoso.sharepoint.com
+    ```