@pnp/cli-microsoft365 6.10.0 → 6.11.0-beta.259c884

package/dist/m365/yammer/commands/message/message-like-set.js

@@ -36,34 +36,9 @@ class YammerMessageLikeSetCommand extends YammerCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const executeLikeAction = () => __awaiter(this, void 0, void 0, function* () {
-                const endpoint = `${this.resource}/v1/messages/liked_by/current.json`;
-                const requestOptions = {
-                    url: endpoint,
-                    headers: {
-                        accept: 'application/json;odata.metadata=none',
-                        'content-type': 'application/json;odata=nometadata'
-                    },
-                    responseType: 'json',
-                    data: {
-                        message_id: args.options.messageId
-                    }
-                };
-                try {
-                    if (args.options.enable !== false) {
-                        yield request_1.default.post(requestOptions);
-                    }
-                    else {
-                        yield request_1.default.delete(requestOptions);
-                    }
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.enable === false) {
                 if (args.options.confirm) {
-                    yield executeLikeAction();
+                    yield this.executeLikeAction(args.options);
                 }
                 else {
                     const messagePrompt = `Are you sure you want to unlike message ${args.options.messageId}?`;
@@ -74,12 +49,38 @@ class YammerMessageLikeSetCommand extends YammerCommand_1.default {
                         message: messagePrompt
                     });
                     if (result.continue) {
-                        yield executeLikeAction();
+                        yield this.executeLikeAction(args.options);
                     }
                 }
             }
             else {
-                yield executeLikeAction();
+                yield this.executeLikeAction(args.options);
+            }
+        });
+    }
+    executeLikeAction(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1/messages/liked_by/current.json`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    message_id: options.messageId
+                }
+            };
+            try {
+                if (options.enable !== false) {
+                    yield request_1.default.post(requestOptions);
+                }
+                else {
+                    yield request_1.default.delete(requestOptions);
+                }
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
             }
         });
     }

package/dist/m365/yammer/commands/message/message-list.js

@@ -37,7 +37,7 @@ class YammerMessageListCommand extends YammerCommand_1.default {
         __classPrivateFieldGet(this, _YammerMessageListCommand_instances, "m", _YammerMessageListCommand_initValidators).call(this);
     }
     getAllItems(logger, args, messageId) {
-        return new Promise((resolve, reject) => {
+        return __awaiter(this, void 0, void 0, function* () {
             let endpoint = `${this.resource}/v1`;
             if (args.options.threadId) {
                 endpoint += `/messages/in_thread/${args.options.threadId}.json`;
@@ -95,31 +95,14 @@ class YammerMessageListCommand extends YammerCommand_1.default {
                 },
                 responseType: 'json'
             };
-            request_1.default
-                .get(requestOptions)
-                .then((res) => {
-                this.items = this.items.concat(res.messages);
-                if (args.options.limit && this.items.length > args.options.limit) {
-                    this.items = this.items.slice(0, args.options.limit);
-                    resolve();
-                }
-                else {
-                    if (res.meta.older_available === true) {
-                        this
-                            .getAllItems(logger, args, this.items[this.items.length - 1].id)
-                            .then(() => {
-                            resolve();
-                        }, (err) => {
-                            reject(err);
-                        });
-                    }
-                    else {
-                        resolve();
-                    }
-                }
-            }, (err) => {
-                reject(err);
-            });
+            const res = yield request_1.default.get(requestOptions);
+            this.items = this.items.concat(res.messages);
+            if (args.options.limit && this.items.length > args.options.limit) {
+                this.items = this.items.slice(0, args.options.limit);
+            }
+            else if ((res.meta.older_available === true)) {
+                yield this.getAllItems(logger, args, this.items[this.items.length - 1].id);
+            }
         });
     }
     commandAction(logger, args) {

package/dist/m365/yammer/commands/message/message-remove.js

@@ -35,24 +35,8 @@ class YammerMessageRemoveCommand extends YammerCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const removeMessage = () => __awaiter(this, void 0, void 0, function* () {
-                try {
-                    const requestOptions = {
-                        url: `${this.resource}/v1/messages/${args.options.id}.json`,
-                        headers: {
-                            accept: 'application/json;odata.metadata=none',
-                            'content-type': 'application/json;odata=nometadata'
-                        },
-                        responseType: 'json'
-                    };
-                    yield request_1.default.delete(requestOptions);
-                }
-                catch (err) {
-                    this.handleRejectedODataJsonPromise(err);
-                }
-            });
             if (args.options.confirm) {
-                yield removeMessage();
+                yield this.removeMessage(args.options);
             }
             else {
                 const result = yield Cli_1.Cli.prompt({
@@ -62,11 +46,29 @@ class YammerMessageRemoveCommand extends YammerCommand_1.default {
                     message: `Are you sure you want to remove the Yammer message ${args.options.id}?`
                 });
                 if (result.continue) {
-                    yield removeMessage();
+                    yield this.removeMessage(args.options);
                 }
             }
         });
     }
+    removeMessage(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const requestOptions = {
+                    url: `${this.resource}/v1/messages/${options.id}.json`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json'
+                };
+                yield request_1.default.delete(requestOptions);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
 }
 _YammerMessageRemoveCommand_instances = new WeakSet(), _YammerMessageRemoveCommand_initTelemetry = function _YammerMessageRemoveCommand_initTelemetry() {
     this.telemetry.push((args) => {

package/dist/m365/yammer/commands/yammer-search.js

@@ -45,7 +45,7 @@ class YammerSearchCommand extends YammerCommand_1.default {
         __classPrivateFieldGet(this, _YammerSearchCommand_instances, "m", _YammerSearchCommand_initValidators).call(this);
     }
     getAllItems(logger, args, page) {
-        return new Promise((resolve, reject) => {
+        return __awaiter(this, void 0, void 0, function* () {
             const endpoint = `${this.resource}/v1/search.json?search=${formatting_1.formatting.encodeQueryParameter(args.options.queryText)}&page=${page}`;
             const requestOptions = {
                 url: endpoint,
@@ -54,65 +54,51 @@ class YammerSearchCommand extends YammerCommand_1.default {
                     accept: 'application/json;odata=nometadata'
                 }
             };
-            request_1.default
-                .get(requestOptions)
-                .then((results) => {
-                // results count should only read once
-                if (page === 1) {
-                    this.summary = {
-                        messages: results.count.messages,
-                        topics: results.count.topics,
-                        users: results.count.users,
-                        groups: results.count.groups
-                    };
-                }
-                const resultMessages = results.messages.messages;
-                const resultTopics = results.topics;
-                const resultGroups = results.groups;
-                const resultUsers = results.users;
-                if (resultMessages.length > 0) {
-                    this.messages = this.messages.concat(resultMessages);
-                    if (args.options.limit && this.messages.length > args.options.limit) {
-                        this.messages = this.messages.slice(0, args.options.limit);
-                    }
-                }
-                if (resultTopics.length > 0) {
-                    this.topics = this.topics.concat(resultTopics);
-                    if (args.options.limit && this.topics.length > args.options.limit) {
-                        this.topics = this.topics.slice(0, args.options.limit);
-                    }
-                }
-                if (resultGroups.length > 0) {
-                    this.groups = this.groups.concat(resultGroups);
-                    if (args.options.limit && this.groups.length > args.options.limit) {
-                        this.groups = this.groups.slice(0, args.options.limit);
-                    }
+            const results = yield request_1.default.get(requestOptions);
+            // results count should only read once
+            if (page === 1) {
+                this.summary = {
+                    messages: results.count.messages,
+                    topics: results.count.topics,
+                    users: results.count.users,
+                    groups: results.count.groups
+                };
+            }
+            const resultMessages = results.messages.messages;
+            const resultTopics = results.topics;
+            const resultGroups = results.groups;
+            const resultUsers = results.users;
+            if (resultMessages.length > 0) {
+                this.messages = this.messages.concat(resultMessages);
+                if (args.options.limit && this.messages.length > args.options.limit) {
+                    this.messages = this.messages.slice(0, args.options.limit);
                 }
-                if (resultUsers.length > 0) {
-                    this.users = this.users.concat(resultUsers);
-                    if (args.options.limit && this.users.length > args.options.limit) {
-                        this.users = this.users.slice(0, args.options.limit);
-                    }
+            }
+            if (resultTopics.length > 0) {
+                this.topics = this.topics.concat(resultTopics);
+                if (args.options.limit && this.topics.length > args.options.limit) {
+                    this.topics = this.topics.slice(0, args.options.limit);
                 }
-                const continueProcessing = resultMessages.length === 20 ||
-                    resultUsers.length === 20 ||
-                    resultGroups.length === 20 ||
-                    resultTopics.length === 20;
-                if (continueProcessing) {
-                    this
-                        .getAllItems(logger, args, ++page)
-                        .then(() => {
-                        resolve();
-                    }, (err) => {
-                        reject(err);
-                    });
+            }
+            if (resultGroups.length > 0) {
+                this.groups = this.groups.concat(resultGroups);
+                if (args.options.limit && this.groups.length > args.options.limit) {
+                    this.groups = this.groups.slice(0, args.options.limit);
                 }
-                else {
-                    resolve();
+            }
+            if (resultUsers.length > 0) {
+                this.users = this.users.concat(resultUsers);
+                if (args.options.limit && this.users.length > args.options.limit) {
+                    this.users = this.users.slice(0, args.options.limit);
                 }
-            }, (err) => {
-                reject(err);
-            });
+            }
+            const continueProcessing = resultMessages.length === 20 ||
+                resultUsers.length === 20 ||
+                resultGroups.length === 20 ||
+                resultTopics.length === 20;
+            if (continueProcessing) {
+                yield this.getAllItems(logger, args, ++page);
+            }
         });
     }
     commandAction(logger, args) {

package/dist/utils/planner.js

@@ -45,11 +45,14 @@ exports.planner = {
         return odata_1.odata.getAllItems(`${graphResource}/v1.0/groups/${groupId}/planner/plans`, metadata);
     },
     /**
-     * Get all Planner plans for a specific roster.
+     * Get the Planner plan for a specific Roster.
      * @param rosterId Roster ID.
      */
-    getPlansByRosterId(rosterId, metadata = 'none') {
-        return odata_1.odata.getAllItems(`${graphResource}/beta/planner/rosters/${rosterId}/plans`, metadata);
+    getPlanByRosterId(rosterId, metadata = 'none') {
+        return __awaiter(this, void 0, void 0, function* () {
+            const plans = yield odata_1.odata.getAllItems(`${graphResource}/beta/planner/rosters/${rosterId}/plans`, metadata);
+            return plans[0];
+        });
     },
     /**
      * Get Planner plan by title in a specific group.

package/dist/utils/spo.js

@@ -306,7 +306,7 @@ exports.spo = {
             nextFolder += `/${folders[folderIndex]}`;
             const folderServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(webFullUrl, nextFolder);
             const requestOptions = {
-                url: `${webFullUrl}/_api/web/GetFolderByServerRelativeUrl('${formatting_1.formatting.encodeQueryParameter(folderServerRelativeUrl)}')`,
+                url: `${webFullUrl}/_api/web/GetFolderByServerRelativePath(DecodedUrl='${formatting_1.formatting.encodeQueryParameter(folderServerRelativeUrl)}')`,
                 headers: {
                     'accept': 'application/json;odata=nometadata'
                 }

package/docs/docs/cmd/aad/user/user-set.mdx

@@ -87,7 +87,7 @@ If the user with the specified ID or username doesn't exist, or if the specified
 Update specific property _department_ of user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
 
 ```sh
-m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --Department IT
+m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --department IT
 ```
 
 Update multiple properties of user by name

package/docs/docs/cmd/cli/config/config-list.mdx

@@ -0,0 +1,78 @@
+import CLISettings from '/docs/_clisettings.mdx';
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# cli config list
+
+List all self set CLI for Microsoft 365 configurations
+
+## Usage
+
+```sh
+m365 cli config list [options]
+```
+
+## Options
+
+<Global />
+
+## Available settings
+
+Following is the list of configuration settings available in CLI for Microsoft 365.
+
+<CLISettings />
+
+## Examples
+
+List all self set configuration keys with their value
+
+```sh
+m365 cli config list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "errorOutput": "stdout"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  errorOutput: stdout
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  errorOutput
+  stdout
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # cli config list
+
+  Date: 29/6/2023
+
+  Property | Value
+  ---------|-------
+  errorOutput | stdout
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.mdx)

package/docs/docs/cmd/flow/flow-enable.mdx

@@ -44,13 +44,13 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
 Enables Power Automate flow owned by the currently signed-in user
 
 ```sh
-m365 flow enable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
+m365 flow enable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
 ```
 
 Enables Power Automate flow owned by another user
 
 ```sh
-m365 flow enable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
+m365 flow enable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
 ```
 
 ## Response

package/docs/docs/cmd/login.mdx

@@ -157,6 +157,12 @@ Log in to Microsoft 365 using your own Azure AD application that's restricted on
 m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a
 ```
 
+Log in to Microsoft 365 using your own Azure AD application and a personal information exchange (.pfx) file
+
+```sh
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
+```
+
 Log in to Microsoft 365 using the interactive browser authentication. Uses the identity of the current user.
 
 ```sh

package/docs/docs/cmd/pa/app/app-permission-ensure.mdx

@@ -0,0 +1,85 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa app permission ensure
+
+Assigns/updates permissions to a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app permission ensure [options]
+```
+
+## Options
+
+```md definition-list
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--roleName <roleName>`
+: Permission level given to the app. Valid values: `CanEdit`, `CanView`. Sharing with the entire tenant is only supported with `CanView` role.
+
+`--userId [userId]`
+: The Azure AD ID of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--userName [userName]`
+: The user principal name of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupId [groupId]`
+: The Azure AD ID of the group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupName [groupName]`
+: The name of the Azure AD group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--tenant`
+: Share the app with the entire tenant. When specifying this, only `CanView` role is supported. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--sendInvitationMail`
+: When set, an invitation mail will be sent.
+
+`--asAdmin`
+: Run the command as admin for apps you don't own.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Specify only a value when running the command as admin.
+```
+
+<Global />
+
+## Remarks
+
+:::note
+
+When specifying a value for `groupId` or `groupName`, note that you can only grant permissions to security groups.
+
+:::
+
+## Examples
+
+Share a Power App app with another user with run-only permissions
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com --roleName CanView --sendInvitationMail
+```
+
+Add co-owner permissions for a security group to a Power Apps app
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers --roleName CanEdit
+```
+
+Add permissions as admin to a Power App app that you do not own
+
+```sh
+m365 pa app permission ensure --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --roleName CanEdit --asAdmin
+```
+
+Share a Power Apps app with everyone in the tenant
+
+```sh
+m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --roleName CanView --tenant
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pa/app/app-permission-remove.mdx

@@ -0,0 +1,74 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# pa app permission remove
+
+Removes permissions to a Power Apps app
+
+## Usage
+
+```sh
+m365 pa app permission remove [options]
+```
+
+## Options
+
+```md definition-list
+`--appName <appName>`
+: The name (GUID) of the Microsoft Power App.
+
+`--userId [userId]`
+: The Azure AD ID of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--userName [userName]`
+: The user principal name of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupId [groupId]`
+: The Azure AD ID of the group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--groupName [groupName]`
+: The name of the Azure AD group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--tenant`
+: When specifying this, tenant permissions (everyone in the tenant) will be removed. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
+
+`--asAdmin`
+: Run the command as admin for apps you don't own.
+
+`-e, --environmentName [environmentName]`
+: The name of the environment. Specify only a value when running the command as admin.
+
+`--confirm`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Examples
+
+Remove permissions of a specific user for a specific app
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com 
+```
+
+Remove permissions of a specific security group for a specific app
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers
+```
+
+Removes permissions as administrator for an app which you do not own
+
+```sh
+m365 pa app permission remove --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --asAdmin
+```
+
+Unshare a Power Apps app with the entire tenant
+
+```sh
+m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --tenant
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/dataverse/dataverse-table-get.mdx

@@ -32,13 +32,13 @@ m365 pp dataverse table get [options]
 List a table for the given environment
 
 ```sh
-m365 pp dataverse table get -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
+m365 pp dataverse table get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
 ```
 
 List a table for the given environment as Admin
 
 ```sh
-m365 pp dataverse table get -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
+m365 pp dataverse table get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
 ```
 
 ## Response

package/docs/docs/cmd/pp/dataverse/dataverse-table-list.mdx

@@ -29,13 +29,13 @@ m365 pp dataverse table list [options]
 List all tables for the given environment
 
 ```sh
-m365 pp dataverse table list -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
+m365 pp dataverse table list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
 ```
 
 List all tables for the given environment as Admin
 
 ```sh
-m365 pp dataverse table list -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
+m365 pp dataverse table list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
 ```
 
 ## Response

package/docs/docs/cmd/pp/dataverse/dataverse-table-remove.mdx

@@ -33,19 +33,19 @@ m365 pp dataverse table remove [options]
 Removes a dataverse table in a given environment
 
 ```sh
-m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
+m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
 ```
 
 Removes a dataverse table in a given environment as Admin
 
 ```sh
-m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
+m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
 ```
 
 Removes a dataverse table in a given environment without prompting for confirmation
 
 ```sh
-m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --confirm
+m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --confirm
 ```
 
 ## Response