@pnp/cli-microsoft365 6.3.0 → 6.4.0-beta.140530d

package/dist/m365/todo/commands/task/task-add.js

@@ -35,11 +35,12 @@ class TodoTaskAddCommand extends GraphCommand_1.default {
         __classPrivateFieldGet(this, _TodoTaskAddCommand_instances, "m", _TodoTaskAddCommand_initOptionSets).call(this);
     }
     commandAction(logger, args) {
-        var _a, _b;
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             const endpoint = `${this.resource}/v1.0`;
             try {
                 const listId = yield this.getTodoListId(args);
+                const status = args.options.status && TodoTaskAddCommand.allowedStatuses.filter(x => x.toLowerCase() === args.options.status.toLowerCase())[0];
                 const requestOptions = {
                     url: `${endpoint}/me/todo/lists/${listId}/tasks`,
                     headers: {
@@ -54,7 +55,11 @@ class TodoTaskAddCommand extends GraphCommand_1.default {
                         },
                         importance: (_b = args.options.importance) === null || _b === void 0 ? void 0 : _b.toLowerCase(),
                         dueDateTime: this.getDateTimeTimeZone(args.options.dueDateTime),
-                        reminderDateTime: this.getDateTimeTimeZone(args.options.reminderDateTime)
+                        reminderDateTime: this.getDateTimeTimeZone(args.options.reminderDateTime),
+                        categories: (_c = args.options.categories) === null || _c === void 0 ? void 0 : _c.split(','),
+                        completedDateTime: this.getDateTimeTimeZone(args.options.completedDateTime),
+                        startDateTime: this.getDateTimeTimeZone(args.options.startDateTime),
+                        status: status
                     },
                     responseType: 'json'
                 };
@@ -105,7 +110,11 @@ _TodoTaskAddCommand_instances = new WeakSet(), _TodoTaskAddCommand_initTelemetry
             bodyContentType: args.options.bodyContentType,
             dueDateTime: typeof args.options.dueDateTime !== 'undefined',
             importance: args.options.importance,
-            reminderDateTime: typeof args.options.reminderDateTime !== 'undefined'
+            reminderDateTime: typeof args.options.reminderDateTime !== 'undefined',
+            categories: typeof args.options.categories !== 'undefined',
+            completedDateTime: typeof args.options.completedDateTime !== 'undefined',
+            startDateTime: typeof args.options.startDateTime !== 'undefined',
+            status: typeof args.options.status !== 'undefined'
         });
     });
 }, _TodoTaskAddCommand_initOptions = function _TodoTaskAddCommand_initOptions() {
@@ -127,9 +136,19 @@ _TodoTaskAddCommand_instances = new WeakSet(), _TodoTaskAddCommand_initTelemetry
         autocomplete: ['low', 'normal', 'high']
     }, {
         option: '--reminderDateTime [reminderDateTime]'
+    }, {
+        option: '--categories [categories]'
+    }, {
+        option: '--completedDateTime [completedDateTime]'
+    }, {
+        option: '--startDateTime [startDateTime]'
+    }, {
+        option: '--status [status]',
+        autocomplete: TodoTaskAddCommand.allowedStatuses
     });
 }, _TodoTaskAddCommand_initValidators = function _TodoTaskAddCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        var _a;
         if (args.options.bodyContentType && ['text', 'html'].indexOf(args.options.bodyContentType.toLowerCase()) === -1) {
             return `'${args.options.bodyContentType}' is not a valid value for the bodyContentType option. Allowed values are text|html`;
         }
@@ -142,10 +161,23 @@ _TodoTaskAddCommand_instances = new WeakSet(), _TodoTaskAddCommand_initTelemetry
         if (args.options.reminderDateTime && !validation_1.validation.isValidISODateTime(args.options.reminderDateTime)) {
             return `'${args.options.reminderDateTime}' is not a valid ISO date string`;
         }
+        if (args.options.completedDateTime && !validation_1.validation.isValidISODateTime(args.options.completedDateTime)) {
+            return `'${args.options.completedDateTime}' is not a valid datetime.`;
+        }
+        if (args.options.startDateTime && !validation_1.validation.isValidISODateTime(args.options.startDateTime)) {
+            return `'${args.options.startDateTime}' is not a valid datetime.`;
+        }
+        if (args.options.status && TodoTaskAddCommand.allowedStatuses.map(x => x.toLowerCase()).indexOf(args.options.status.toLowerCase()) === -1) {
+            return `${args.options.status} is not a valid value for status. Valid values are ${TodoTaskAddCommand.allowedStatuses.join(', ')}`;
+        }
+        if (args.options.completedDateTime && ((_a = args.options.status) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== 'completed') {
+            return `The completedDateTime option can only be used when the status option is set to completed`;
+        }
         return true;
     }));
 }, _TodoTaskAddCommand_initOptionSets = function _TodoTaskAddCommand_initOptionSets() {
     this.optionSets.push({ options: ['listId', 'listName'] });
 };
+TodoTaskAddCommand.allowedStatuses = ['notStarted', 'inProgress', 'completed', 'waitingOnOthers', 'deferred'];
 module.exports = new TodoTaskAddCommand();
 //# sourceMappingURL=task-add.js.map

package/dist/utils/aadGroup.js

@@ -53,6 +53,24 @@ exports.aadGroup = {
             }
             return groups[0];
         });
+    },
+    /**
+     * Get id of a group by its display name.
+     * @param displayName Group display name.
+     * @throws Error when group was not found.
+     * @throws Error when multiple groups with the same name were found.
+     */
+    getGroupIdByDisplayName(displayName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const groups = yield odata_1.odata.getAllItems(`${graphResource}/v1.0/groups?$filter=displayName eq '${formatting_1.formatting.encodeQueryParameter(displayName)}'&$select=id`);
+            if (!groups.length) {
+                throw Error(`The specified group '${displayName}' does not exist.`);
+            }
+            if (groups.length > 1) {
+                throw Error(`Multiple groups with name '${displayName}' found: ${groups.map(x => x.id).join(',')}.`);
+            }
+            return groups[0].id;
+        });
     }
 };
 //# sourceMappingURL=aadGroup.js.map

package/dist/utils/aadUser.js

@@ -33,6 +33,43 @@ exports.aadUser = {
             }
             return res.value[0].id;
         });
+    },
+    /**
+    * Retrieve the ID of a user by its email.
+    * @param mail User email.
+    */
+    getUserIdByEmail(email) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${graphResource}/v1.0/users?$filter=mail eq '${formatting_1.formatting.encodeQueryParameter(email)}'&$select=id`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            if (res.value.length === 0) {
+                throw Error(`The specified user with email ${email} does not exist`);
+            }
+            return res.value[0].id;
+        });
+    },
+    /**
+     * Retrieve the UPN of a user by its ID.
+     * @param id User ID.
+     */
+    getUpnByUserId(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${graphResource}/v1.0/users/${id}?$select=userPrincipalName`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            return res.userPrincipalName;
+        });
     }
 };
 //# sourceMappingURL=aadUser.js.map

package/dist/utils/md.js

@@ -51,6 +51,12 @@ function convertContentTabs(md) {
         return `  ${title}${os_1.EOL}${os_1.EOL}${content.replace(/^    /gms, '')}`;
     });
 }
+function convertMdOutput(md) {
+    const regex = new RegExp('(?<=^    ```md)(.*)(?=    ```)', 'gms');
+    return md.replace(regex, (match, content) => {
+        return content.replace(/^    /gms, '');
+    });
+}
 function convertCodeFences(md) {
     const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
     return md.replace(regex, (match, code) => {
@@ -79,6 +85,7 @@ const convertFunctions = [
     convertAdmonitions,
     convertDd,
     convertHyperlinks,
+    convertMdOutput,
     convertContentTabs,
     convertCodeFences,
     removeInlineMarkup,

package/dist/utils/spo.js

@@ -536,6 +536,38 @@ exports.spo = {
             const customActionOnSite = yield getById(webUrl, id, "Site");
             return customActionOnSite;
         });
+    },
+    getTenantAppCatalogUrl(logger, debug) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const spoUrl = yield exports.spo.getSpoUrl(logger, debug);
+            const requestOptions = {
+                url: `${spoUrl}/_api/SP_TenantSettings_Current`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const result = yield request_1.default.get(requestOptions);
+            return result.CorporateCatalogUrl;
+        });
+    },
+    /**
+     * Retrieves the Azure AD ID from a SP user.
+     * @param webUrl Web url
+     * @param id The Id of the user
+     */
+    getUserAzureIdBySpoId(webUrl, id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${webUrl}/_api/web/siteusers/GetById('${formatting_1.formatting.encodeQueryParameter(id)}')?$select=AadObjectId`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            const res = yield request_1.default.get(requestOptions);
+            return res.AadObjectId.NameId;
+        });
     }
 };
 //# sourceMappingURL=spo.js.map

package/docs/docs/cmd/aad/app/app-add.md

@@ -77,7 +77,7 @@ If you don't use the manifest, you must specify the name of the Azure AD app reg
 
 You can also use the manifest to provision some of the configuration settings of your Azure AD app. All properties specified in the manifest are optional and will set if specified.
 
-If you specify the manifest along with some options, values specified in the options will override settings from the manifest. One exception is the name specified in the `name` option which will be overriden by the `displayName` property from the manifest if specified.
+If you specify the manifest along with some options, values specified in the options will override settings from the manifest. One exception is the name specified in the `name` option which will be overridden by the `displayName` property from the manifest if specified.
 
 The following properties specified in the manifest retrieved from Azure AD are not supported by this command:
 
@@ -137,7 +137,7 @@ Create new Azure AD app registration with an auto-generated secret (secret retur
 m365 aad app add --name 'My AAD app' --withSecret
 ```
 
-Create new Azure AD app registration for a deamon app with specified Microsoft Graph application permissions
+Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions
 
 ```sh
 m365 aad app add --name 'My AAD app' --withSecret --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All,https://graph.microsoft.com/Directory.Read.All'
@@ -161,7 +161,7 @@ Create new Azure AD app registration with Application ID URI set to a value that
 m365 aad app add --name 'My AAD app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
 ```
 
-Create new Azure AD app registration for a deamon app with specified Microsoft Graph application permissions, including admin consent
+Create new Azure AD app registration for a daemon app with specified Microsoft Graph application permissions, including admin consent
 
 ```sh
  m365 aad app add --name 'My AAD app' --apisApplication 'https://graph.microsoft.com/Group.ReadWrite.All' --grantAdminConsent

package/docs/docs/cmd/aad/approleassignment/approleassignment-add.md

@@ -20,10 +20,10 @@ m365 aad approleassignment add [options]
 : Application name of the App Registration to which the configured scopes (app roles) should be applied
 
 `-r, --resource <resource>`
-: Service principal name, appId or objectId that has the scopes (roles) ex. `SharePoint`.
+: Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`.
 
 `-s, --scope <scope>`
-: Permissions known also as scopes and roles to grant the application with. If multiple permissions have to be granted, they have to be comma separated ex. `Sites.Read.All,Sites.ReadWrite.all`
+: Permissions known also as scopes and roles to grant the application with. If multiple permissions have to be granted, they have to be comma-separated e.g. `Sites.Read.All,Sites.ReadWrite.all`
 
 --8<-- "docs/cmd/_global.md"
 
@@ -33,7 +33,7 @@ This command requires tenant administrator permissions.
 
 Specify either the `appId`, `appObjectId` or `appDisplayName` but not multiple. If you specify more than one option value, the command will fail with an error.
 
-Autocomplete values for the `resource` option do not mean allowed values. The autocomplete will just suggest some known names, but that doesn't restrict you to use name of your own custom application or other application within your tenant.
+Autocomplete values for the `resource` option do not mean allowed values. The autocomplete will just suggest some known names, but that doesn't restrict you to use the name of your own custom application or other application within your tenant.
 
 This command can also be used to assign permissions to system or user-assigned managed identity.
 
@@ -45,13 +45,13 @@ Adds SharePoint _Sites.Read.All_ application permissions to Azure AD application
 m365 aad approleassignment add --appId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "SharePoint" --scope "Sites.Read.All"
 ```
 
-Adds multiple Microsoft Graph application permissions to an Azure AD application with name _MyAppName_
+Adds multiple Microsoft Graph application permissions to an Azure AD application with the name _MyAppName__
 
 ```sh
 m365 aad approleassignment add --appDisplayName "MyAppName" --resource "Microsoft Graph" --scope "Mail.Read,Mail.Send"
 ```
 
-Adds Microsoft Graph _Mail.Read_ application permissions to a system managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
+Adds Microsoft Graph _Mail.Read_ application permissions to a system-managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
 
 ```sh
 m365 aad approleassignment add --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scope "Mail.Read"

package/docs/docs/cmd/aad/approleassignment/approleassignment-remove.md

@@ -20,10 +20,10 @@ m365 aad approleassignment remove [options]
 : Application name of the App Registration for which the configured scopes (app roles) should be deleted
 
 `-r, --resource <resource>`
-: Service principal name, appId or objectId that has the scopes (roles) ex. `SharePoint`
+: Service principal name, appId or objectId that has the scopes (roles) e.g. `SharePoint`
 
 `-s, --scope <scope>`
-: Permissions known also as scopes and roles to be deleted from the application. If multiple permissions have to be deleted, they have to be comma separated ex. `Sites.Read.All`,`Sites.ReadWrite.All`
+: Permissions known also as scopes and roles to be deleted from the application. If multiple permissions have to be deleted, they have to be comma-separated e.g. `Sites.Read.All`,`Sites.ReadWrite.All`
 
 `--confirm`
 : Don't prompt for confirming removing the all role assignment
@@ -54,7 +54,7 @@ Deletes multiple Microsoft Graph application permissions from an Azure AD applic
 m365 aad approleassignment remove --appDisplayName "MyAppName" --resource "Microsoft Graph" --scope "Mail.Read,Mail.Send"
 ```
 
-Deletes Microsoft Graph _Mail.Read_ application permissions from a system managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
+Deletes Microsoft Graph _Mail.Read_ application permissions from a system-managed identity app with objectId _57907bf8-73fa-43a6-89a5-1f603e29e451_
 
 ```sh
 m365 aad approleassignment remove --appObjectId "57907bf8-73fa-43a6-89a5-1f603e29e451" --resource "Microsoft Graph" --scope "Mail.Read"

package/docs/docs/cmd/aad/user/user-remove.md

@@ -43,7 +43,7 @@ m365 aad user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
 Removes a specific user by its UPN
 
 ```sh
-m365 aad user remove --name john.doe@contoso.com
+m365 aad user remove --userName john.doe@contoso.com
 ```
 
 ## Response

package/docs/docs/cmd/cli/completion/completion-clink-update.md

@@ -12,16 +12,16 @@ m365 cli completion clink update [options]
 
 --8<-- "docs/cmd/_global.md"
 
-!!! important
-    Before running this command, change the working directory to where your shell stores completion plugins. For cmder, it's `%CMDER_ROOT%\vendor\clink-completions`, where `%CMDER_ROOT%` is the folder where you installed cmder. After running this command, restart your terminal to load the completion.
-
 ## Remarks
 
 This commands updates the list of commands and their options used by command completion in Clink (cmder). You should run this command each time after upgrading the CLI for Microsoft 365.
 
+!!! important
+    Before running this command, change the working directory to where your shell stores completion plugins. For cmder, it's `%CMDER_ROOT%\vendor\clink-completions`, where `%CMDER_ROOT%` is the folder where you installed cmder. After running this command, restart your terminal to load the completion.
+
 ## Examples
 
-Write the list of commands for Clink (cmder) command completion to a file named `m365.lua` in the current directory
+Write the list of commands for Clink (cmder) command completion to a file named `m365.lua` in the current directory.
 
 ```powershell
 m365 cli completion clink update > m365.lua

package/docs/docs/cmd/flow/owner/owner-ensure.md

@@ -0,0 +1,61 @@
+# flow owner ensure
+
+Assigns/updates permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner ensure [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--roleName <roleName>`
+: Access level for the user on the flow. Valid options are `CanView` or `CanEdit`.
+
+`--asAdmin`
+: Run the command as admin.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Assign owner permissions to a specific Power Automate flow for a user with ID
+
+```sh
+m365 flow owner ensure --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a user with UPN
+
+```sh
+m365 flow owner ensure --userName "john.doe@contoso.com" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+Assign owner permissions to a specific Power Automate flow for a group
+
+```sh
+m365 flow owner ensure --groupId 8d4d9f32-1ab0-4f81-9054-efbb1759e8e6 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --roleName CanEdit
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/flow/owner/owner-list.md

@@ -0,0 +1,90 @@
+# flow owner list
+
+Lists all owners of a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner list [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--asAdmin`
+: Run the command as admin.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets the owners by the name of the Power Automate flow within a specified environment
+
+```sh
+m365 flow owner list --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72
+```
+
+Gets the owners by the name of the Power Automate flow within a specified environment with admin privileges
+
+```sh
+m365 flow owner list --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "name": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "id": "/providers/Microsoft.ProcessSimple/environments/Default-c5a5d746-3520-453f-8a69-780f8e44917e/flows/72f2be4a-78c1-4220-a048-dbf557296a72/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+        "type": "/providers/Microsoft.ProcessSimple/environments/flows/permissions",
+        "properties": {
+          "roleName": "Owner",
+          "permissionType": "Principal",
+          "principal": {
+            "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+            "type": "User"
+          }
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    roleName  id                                    type
+    --------  ------------------------------------  ----
+    Owner     fe36f75e-c103-410b-a18a-2bf6df06ac3a  User
+    ```
+
+=== "CSV"
+
+    ```csv
+    roleName,id,type
+    Owner,fe36f75e-c103-410b-a18a-2bf6df06ac3a,User
+    ```
+
+=== "Markdown"
+
+    ```md
+    # flow owner list --environmentName "Default-c5a5d746-3520-453f-8a69-780f8e44917e" --flowName "72f2be4a-78c1-4220-a048-dbf557296a72"
+
+    Date: 25/02/2023
+
+    ## fe36f75e-c103-410b-a18a-2bf6df06ac3a (/providers/Microsoft.ProcessSimple/environments/Default-c5a5d746-3520-453f-8a69-780f8e44917e/flows/72f2be4a-78c1-4220-a048-dbf557296a72/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a)
+
+    Property | Value
+    ---------|-------
+    name | fe36f75e-c103-410b-a18a-2bf6df06ac3a
+    id | /providers/Microsoft.ProcessSimple/environments/Default-c5a5d746-3520-453f-8a69-780f8e44917e/flows/72f2be4a-78c1-4220-a048-dbf557296a72/permissions/fe36f75e-c103-410b-a18a-2bf6df06ac3a
+    type | /providers/Microsoft.ProcessSimple/environments/flows/permissions
+    properties | {"roleName":"Owner","permissionType":"Principal","principal":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","type":"User"}}
+    ```

package/docs/docs/cmd/flow/owner/owner-remove.md

@@ -0,0 +1,67 @@
+# flow owner remove
+
+Removes owner permissions to a Power Automate flow
+
+## Usage
+
+```sh
+m365 flow owner remove [options]
+```
+
+## Options
+
+`-e, --environmentName <environmentName>`
+: The name of the environment.
+
+`-f, --flowName <flowName>`
+: The name of the Power Automate flow.
+
+`--userId [userId]`
+: The ID of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--userName [userName]`
+: User principal name of the user. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupId [groupId]`
+: The ID of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--groupName [groupName]`
+: The name of the group. Specify either `userId`, `userName`, `groupId` or `groupName`.
+
+`--asAdmin`
+: Run the command as admin.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Remove owner permissions from a specific Power Automate flow for a user by ID without prompting for confirmation
+
+```sh
+m365 flow owner remove --userId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --confirm
+```
+
+Remove owner permissions from a specific Power Automate flow for a user by UPN as admin
+
+```sh
+m365 flow owner remove --userName john.doe@contoso.com --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by ID
+
+```sh
+m365 flow owner remove --groupId 5c241023-2ba5-4ea8-a516-a2481a3e6c51 --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72
+```
+
+Remove owner permissions from a specific Power Automate flow for a group by name as admin
+
+```sh
+m365 flow owner remove --groupName "Test group" --environmentName Default-c5a5d746-3520-453f-8a69-780f8e44917e --flowName 72f2be4a-78c1-4220-a048-dbf557296a72 --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -25,6 +25,9 @@ m365 flow run list [options]
 `--triggerEndTime [triggerEndTime]`
 : Time indicating the exclusive end of a time range of flow runs to return. This should be defined as a valid ISO 8601 string (2021-12-16T18:28:48.6964197Z).
 
+`--asAdmin`
+: Run the command as admin. Use this flag when targeting flows you don't own.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -56,6 +59,12 @@ List runs of the specified Microsoft Flow between a specific time range
 m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --triggerStartTime 2023-01-21T18:19:00Z --triggerEndTime 2023-01-22T00:00:00Z
 ```
 
+List runs of the specified Microsoft Flow owned by another user
+
+```sh
+m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a --asAdmin
+```
+
 ## Response
 
 ### Standard response
@@ -123,3 +132,22 @@ m365 flow run list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c
     name,startTime,status
     08585329112602833828909892130CU17,2022-11-17T14:33:45.2763872Z,Running
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow run list --environmentName "Default-de348bc7-1aeb-4406-8cb3-97db021cadb4" --flowName "08585329112602833828909892130CU17"
+
+    Date: 1/3/2023
+
+    ## 08585329112602833828909892130CU17 (/providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17)
+
+    Property | Value
+    ---------|-------
+    name | 08585329112602833828909892130CU17
+    id | /providers/Microsoft.ProcessSimple/environments/Default-de348bc7-1aeb-4406-8cb3-97db021cadb4/flows/170fb67e-a514-4d84-8727-582022bd13a9/runs/08585329112602833828909892130CU17
+    type | Microsoft.ProcessSimple/environments/flows/runs
+    properties | {"startTime":"2022-11-17T14:33:45.2763872Z","status":"Running","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"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","contentVersion":"6ZrBBE+MJg7IvhMgyJLMmA==","contentSize":349,"contentHash":{"algorithm":"md5","value":"6ZrBBE+MJg7IvhMgyJLMmA=="}},"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","contentVersion":"Z/4a8tfYygNAR1xpc44iww==","contentSize":493,"contentHash":{"algorithm":"md5","value":"Z/4a8tfYygNAR1xpc44iww=="}},"startTime":"2022-11-17T14:33:45.1914506Z","endTime":"2022-11-17T14:33:45.1914506Z","originHistoryName":"08585329112602833829909892130CU00","correlation":{"clientTrackingId":"08585329112602833829909892130CU00"},"status":"Succeeded"}}
+    startTime | 2022-11-17T14:33:45.2763872Z
+    status | Running
+    ```

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

@@ -118,7 +118,7 @@ m365 onenote page list --webUrl https://contoso.sharepoint.com/sites/testsite
 === "Markdown"
 
     ```md
-    # onenote page list --userName "mathijs@mathijsdev2.onmicrosoft.com"
+    # onenote page list --userName "john.doe@contoso.onmicrosoft.com"
 
     Date: 07/01/2023
 

package/docs/docs/cmd/outlook/mail/mail-send.md

@@ -11,7 +11,7 @@ m365 outlook mail send [options]
 ## Options
 
 `-s, --subject <subject>`
-: Email subject
+: Email subject.
 
 `-t, --to <to>`
 : Comma-separated list of emails to send the message to.
@@ -32,10 +32,10 @@ m365 outlook mail send [options]
 : String containing the body of the email to send.
 
 `--bodyContentType [bodyContentType]`
-: Type of the body content. Available options: `Text,HTML`. Default `Text`.
+: Type of the body content. Available options: `Text`, `HTML`. Default is `Text`.
 
 `--importance [importance]`
-: The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
+: The importance of the message. Available options: `low`, `normal`, or `high`. Default is `normal`.
 
 `--attachment [attachment]`
 : Path to the file that will be added as attachment to the email. This option can be used multiple times to attach multiple attachments.
@@ -123,3 +123,7 @@ Send an email with multiple attachments
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "Monthly reports" --bodyContents "Here are the reports of this month." --attachment "C:/Reports/File1.jpg" --attachment "C:/Reports/File2.docx" --attachment "C:/Reports/File3.xlsx"
 ```
+
+## Response
+
+The command won't return a response on success.