@pnp/cli-microsoft365 5.8.0-beta.c222170 → 5.8.0-beta.e60254a

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

@@ -122,28 +122,31 @@ class YammerMessageListCommand extends YammerCommand_1.default {
             });
         });
     }
-    commandAction(logger, args, cb) {
-        this.items = []; // this will reset the items array in interactive mode
-        this
-            .getAllItems(logger, args, -1)
-            .then(() => {
-            this.items.forEach(m => {
-                let shortBody;
-                const bodyToProcess = m.body.plain;
-                if (bodyToProcess) {
-                    let maxLength = 35;
-                    let addedDots = "...";
-                    if (bodyToProcess.length < maxLength) {
-                        maxLength = bodyToProcess.length;
-                        addedDots = "";
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.items = []; // this will reset the items array in interactive mode
+            try {
+                yield this.getAllItems(logger, args, -1);
+                this.items.forEach(m => {
+                    let shortBody;
+                    const bodyToProcess = m.body.plain;
+                    if (bodyToProcess) {
+                        let maxLength = 35;
+                        let addedDots = "...";
+                        if (bodyToProcess.length < maxLength) {
+                            maxLength = bodyToProcess.length;
+                            addedDots = "";
+                        }
+                        shortBody = bodyToProcess.replace(/\n/g, ' ').substring(0, maxLength) + addedDots;
                     }
-                    shortBody = bodyToProcess.replace(/\n/g, ' ').substring(0, maxLength) + addedDots;
-                }
-                m.shortBody = shortBody;
-            });
-            logger.log(this.items);
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+                    m.shortBody = shortBody;
+                });
+                logger.log(this.items);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
     }
 }
 _YammerMessageListCommand_instances = new WeakSet(), _YammerMessageListCommand_initTelemetry = function _YammerMessageListCommand_initTelemetry() {

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

@@ -33,38 +33,39 @@ class YammerMessageRemoveCommand extends YammerCommand_1.default {
     get description() {
         return 'Removes a Yammer message';
     }
-    commandAction(logger, args, cb) {
-        const removeMessage = () => {
-            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'
-            };
-            request_1.default
-                .delete(requestOptions)
-                .then(_ => cb(), (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
-        };
-        if (args.options.confirm) {
-            removeMessage();
-        }
-        else {
-            cli_1.Cli.prompt({
-                type: 'confirm',
-                name: 'continue',
-                default: false,
-                message: `Are you sure you want to remove the Yammer message ${args.options.id}?`
-            }, (result) => {
-                if (!result.continue) {
-                    cb();
+    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);
                 }
-                else {
-                    removeMessage();
+                catch (err) {
+                    this.handleRejectedODataJsonPromise(err);
                 }
             });
-        }
+            if (args.options.confirm) {
+                yield removeMessage();
+            }
+            else {
+                const result = yield cli_1.Cli.prompt({
+                    type: 'confirm',
+                    name: 'continue',
+                    default: false,
+                    message: `Are you sure you want to remove the Yammer message ${args.options.id}?`
+                });
+                if (result.continue) {
+                    yield removeMessage();
+                }
+            }
+        });
     }
 }
 _YammerMessageRemoveCommand_instances = new WeakSet(), _YammerMessageRemoveCommand_initTelemetry = function _YammerMessageRemoveCommand_initTelemetry() {

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

@@ -1,4 +1,13 @@
 "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");
@@ -25,24 +34,27 @@ class YammerNetworkListCommand extends YammerCommand_1.default {
     defaultProperties() {
         return ['id', 'name', 'email', 'community', 'permalink', 'web_url'];
     }
-    commandAction(logger, args, cb) {
-        const requestOptions = {
-            url: `${this.resource}/v1/networks/current.json`,
-            headers: {
-                accept: 'application/json;odata.metadata=none',
-                'content-type': 'application/json;odata=nometadata'
-            },
-            responseType: 'json',
-            data: {
-                includeSuspended: args.options.includeSuspended !== undefined && args.options.includeSuspended !== false
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${this.resource}/v1/networks/current.json`,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json;odata=nometadata'
+                },
+                responseType: 'json',
+                data: {
+                    includeSuspended: args.options.includeSuspended !== undefined && args.options.includeSuspended !== false
+                }
+            };
+            try {
+                const res = yield request_1.default.get(requestOptions);
+                logger.log(res);
             }
-        };
-        request_1.default
-            .get(requestOptions)
-            .then((res) => {
-            logger.log(res);
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
     }
 }
 _YammerNetworkListCommand_instances = new WeakSet(), _YammerNetworkListCommand_initTelemetry = function _YammerNetworkListCommand_initTelemetry() {

package/dist/m365/yammer/commands/user/user-get.js

@@ -35,28 +35,31 @@ class YammerUserGetCommand extends YammerCommand_1.default {
     defaultProperties() {
         return ['id', 'full_name', 'email', 'job_title', 'state', 'url'];
     }
-    commandAction(logger, args, cb) {
-        let endPoint = `${this.resource}/v1/users/current.json`;
-        if (args.options.userId) {
-            endPoint = `${this.resource}/v1/users/${encodeURIComponent(args.options.userId)}.json`;
-        }
-        else if (args.options.email) {
-            endPoint = `${this.resource}/v1/users/by_email.json?email=${encodeURIComponent(args.options.email)}`;
-        }
-        const requestOptions = {
-            url: endPoint,
-            headers: {
-                accept: 'application/json;odata.metadata=none',
-                'content-type': 'application/json;odata=nometadata'
-            },
-            responseType: 'json'
-        };
-        request_1.default
-            .get(requestOptions)
-            .then((res) => {
-            logger.log(res);
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let endPoint = `${this.resource}/v1/users/current.json`;
+            if (args.options.userId) {
+                endPoint = `${this.resource}/v1/users/${encodeURIComponent(args.options.userId)}.json`;
+            }
+            else if (args.options.email) {
+                endPoint = `${this.resource}/v1/users/by_email.json?email=${encodeURIComponent(args.options.email)}`;
+            }
+            const requestOptions = {
+                url: endPoint,
+                headers: {
+                    accept: 'application/json;odata.metadata=none',
+                    'content-type': 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            try {
+                const res = yield request_1.default.get(requestOptions);
+                logger.log(res);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
     }
 }
 _YammerUserGetCommand_instances = new WeakSet(), _YammerUserGetCommand_initTelemetry = function _YammerUserGetCommand_initTelemetry() {

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

@@ -98,14 +98,17 @@ class YammerUserListCommand extends YammerCommand_1.default {
             });
         });
     }
-    commandAction(logger, args, cb) {
-        this.items = []; // this will reset the items array in interactive mode
-        this
-            .getAllItems(logger, args, 1)
-            .then(() => {
-            logger.log(this.items);
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.items = []; // this will reset the items array in interactive mode
+            try {
+                yield this.getAllItems(logger, args, 1);
+                logger.log(this.items);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
     }
 }
 _YammerUserListCommand_instances = new WeakSet(), _YammerUserListCommand_initTelemetry = function _YammerUserListCommand_initTelemetry() {

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

@@ -110,85 +110,88 @@ class YammerSearchCommand extends YammerCommand_1.default {
             });
         });
     }
-    commandAction(logger, args, cb) {
-        this.summary = {
-            messages: 0,
-            groups: 0,
-            topics: 0,
-            users: 0
-        };
-        this.messages = [];
-        this.groups = [];
-        this.topics = [];
-        this.users = [];
-        this
-            .getAllItems(logger, args, 1)
-            .then(() => {
-            var _a;
-            if (args.options.output === 'json') {
-                logger.log({
-                    summary: this.summary,
-                    messages: this.messages,
-                    users: this.users,
-                    topics: this.topics,
-                    groups: this.groups
-                });
-            }
-            else {
-                const show = (_a = args.options.show) === null || _a === void 0 ? void 0 : _a.toLowerCase();
-                if (show === "summary") {
-                    logger.log(this.summary);
+    commandAction(logger, args) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            this.summary = {
+                messages: 0,
+                groups: 0,
+                topics: 0,
+                users: 0
+            };
+            this.messages = [];
+            this.groups = [];
+            this.topics = [];
+            this.users = [];
+            try {
+                yield this.getAllItems(logger, args, 1);
+                if (args.options.output === 'json') {
+                    logger.log({
+                        summary: this.summary,
+                        messages: this.messages,
+                        users: this.users,
+                        topics: this.topics,
+                        groups: this.groups
+                    });
                 }
                 else {
-                    let results = [];
-                    if (show === undefined || show === "messages") {
-                        results = [...results, ...this.messages.map((msg) => {
-                                let trimmedMessage = msg.content_excerpt;
-                                trimmedMessage = (trimmedMessage === null || trimmedMessage === void 0 ? void 0 : trimmedMessage.length) >= 80 ? (trimmedMessage.substring(0, 80) + "...") : trimmedMessage;
-                                trimmedMessage = trimmedMessage === null || trimmedMessage === void 0 ? void 0 : trimmedMessage.replace(/\n/g, " ");
-                                return {
-                                    id: msg.id,
-                                    description: trimmedMessage,
-                                    type: "message",
-                                    web_url: msg.web_url
-                                };
-                            })];
+                    const show = (_a = args.options.show) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+                    if (show === "summary") {
+                        logger.log(this.summary);
                     }
-                    if (show === undefined || show === "topics") {
-                        results = [...results, ...this.topics.map((topic) => {
-                                return {
-                                    id: topic.id,
-                                    description: topic.name,
-                                    type: "topic",
-                                    web_url: topic.web_url
-                                };
-                            })];
+                    else {
+                        let results = [];
+                        if (show === undefined || show === "messages") {
+                            results = [...results, ...this.messages.map((msg) => {
+                                    let trimmedMessage = msg.content_excerpt;
+                                    trimmedMessage = (trimmedMessage === null || trimmedMessage === void 0 ? void 0 : trimmedMessage.length) >= 80 ? (trimmedMessage.substring(0, 80) + "...") : trimmedMessage;
+                                    trimmedMessage = trimmedMessage === null || trimmedMessage === void 0 ? void 0 : trimmedMessage.replace(/\n/g, " ");
+                                    return {
+                                        id: msg.id,
+                                        description: trimmedMessage,
+                                        type: "message",
+                                        web_url: msg.web_url
+                                    };
+                                })];
+                        }
+                        if (show === undefined || show === "topics") {
+                            results = [...results, ...this.topics.map((topic) => {
+                                    return {
+                                        id: topic.id,
+                                        description: topic.name,
+                                        type: "topic",
+                                        web_url: topic.web_url
+                                    };
+                                })];
+                        }
+                        if (show === undefined || show === "users") {
+                            results = [...results, ...this.users.map((user) => {
+                                    return {
+                                        id: user.id,
+                                        description: user.name,
+                                        type: "user",
+                                        web_url: user.web_url
+                                    };
+                                })];
+                        }
+                        if (show === undefined || show === "groups") {
+                            results = [...results, ...this.groups.map((group) => {
+                                    return {
+                                        id: group.id,
+                                        description: group.name,
+                                        type: "group",
+                                        web_url: group.web_url
+                                    };
+                                })];
+                        }
+                        logger.log(results);
                     }
-                    if (show === undefined || show === "users") {
-                        results = [...results, ...this.users.map((user) => {
-                                return {
-                                    id: user.id,
-                                    description: user.name,
-                                    type: "user",
-                                    web_url: user.web_url
-                                };
-                            })];
-                    }
-                    if (show === undefined || show === "groups") {
-                        results = [...results, ...this.groups.map((group) => {
-                                return {
-                                    id: group.id,
-                                    description: group.name,
-                                    type: "group",
-                                    web_url: group.web_url
-                                };
-                            })];
-                    }
-                    logger.log(results);
                 }
             }
-            cb();
-        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
     }
 }
 _YammerSearchCommand_instances = new WeakSet(), _YammerSearchCommand_initTelemetry = function _YammerSearchCommand_initTelemetry() {

package/dist/utils/fsUtil.js

@@ -42,12 +42,10 @@ const addFileCommands = {
         addFileCommand: 'cat > [FILEPATH] << EOF [FILECONTENT]EOF'
     },
     powershell: {
-        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath "[FILEPATH]"
-    `
+        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath [FILEPATH]`
     },
     cmd: {
-        addFileCommand: `echo [FILECONTENT] > "[FILEPATH]"
-    `
+        addFileCommand: `echo [FILECONTENT] > [FILEPATH]`
     }
 };
 const removeFileCommands = {

package/dist/utils/md.js

@@ -46,7 +46,7 @@ function convertHyperlinks(md) {
     });
 }
 function convertCodeFences(md) {
-    const regex = new RegExp('^```.*?' + os_1.EOL + '(.*?)```' + os_1.EOL, 'gms');
+    const regex = new RegExp('^```.*?(?:\r\n|\n)(.*?)```(?:\r\n|\n)', 'gms');
     return md.replace(regex, (match, code) => {
         return `  ${code}${os_1.EOL}`;
     });

package/docs/docs/cmd/graph/changelog/changelog-list.md

@@ -0,0 +1,53 @@
+# graph changelog list
+
+Gets an overview of specific API-level changes in Microsoft Graph v1.0 and beta
+
+## Usage
+
+```sh
+m365 graph changelog list [options]
+```
+
+## Options
+
+`-v, --versions [versions]`
+: Comma-separated list of versions to show changes for. `Beta, v1.0`. When no version is selected all versions are returned.
+
+`-c, --changeType [changeType]`
+: Change type to show changes for. `Addition, Change, Deletion`. When no changeType is selected all change types are returned.
+
+`-s, --services [services]`
+: Comma-separated list of services to show changes for. `Applications, Calendar, Change notifications, Cloud communications, Compliance, Cross-device experiences, Customer booking, Device and app management, Education, Files, Financials, Groups, Identity and access, Mail, Notes, Notifications, People and workplace intelligence, Personal contacts, Reports, Search, Security, Sites and lists, Tasks and plans, Teamwork, To-do tasks, Users, Workbooks and charts`. When no service is selected all services are returned.
+
+`--startDate [startDate]`
+: The startdate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+`--endDate [endDate]`
+: The enddate used to query for changes. Supported date format is `YYYY-MM-DD`. When no date is specified all changes are returned.
+
+--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
+
+Get all changes within Microsoft Graph.
+
+```sh
+m365 graph changelog list
+```
+
+Get all changes within Microsoft Graph for the services _Groups_ and _Users_.
+
+```sh
+m365 graph changelog list --services 'Groups,Users'
+```
+
+Get all changes within Microsoft Graph that happend between _2021-01-01_ and _2021-05-01_.
+
+```sh
+m365 graph changelog list --startDate '2021-01-01' --endDate '2021-05-01'
+```

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

@@ -1,6 +1,6 @@
 # outlook sendmail
 
-Sends e-mail on behalf of the current user
+Sends an email
 
 ## Usage
 
@@ -17,44 +17,102 @@ m365 outlook sendmail [options]
 ## Options
 
 `-s, --subject <subject>`
-: E-mail subject
+: Email subject
 
 `-t, --to <to>`
-: Comma-separated list of e-mails to send the message to
+: Comma-separated list of emails to send the message to.
+
+`--cc [cc]`
+: Comma-separated list of CC recipients for the message.
+
+`--bcc [bcc]`
+: Comma-separated list of BCC recipients for the message.
+
+`--sender [sender]`
+: Optional upn or user id to specify what account to send the message from. Also see the remarks section.
+
+`-m, --mailbox [mailbox]`
+: Specify this option to send the email on behalf of another mailbox, for example a shared mailbox, group or distribution list. The sender needs to be a delegate on the specified mailbox. Also see the remarks section.
 
 `--bodyContents <bodyContents>`
-: String containing the body of the e-mail to send
+: 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 `Text`.
+
+`--importance [importance]`
+: The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
 
 `--saveToSentItems [saveToSentItems]`
-: Save e-mail in the sent items folder. Default `true`
+: Save email in the sent items folder. Default `true`.
 
 --8<-- "docs/cmd/_global.md"
 
+## Remarks
+
+### If you are connected using app only authentication
+
+- Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
+- You can optionally also specify the `--mailbox` option to send mail on behalf of a shared mailbox, group or distribution list. The account used in the `--sender` option, needs to have 'Send on behalf of' permissions on the mailbox in question.
+
+!!! important
+    You need `Mail.Send` application permissions on the Microsoft Graph to be able to send mails using an application identity. 
+
+### If you are connected with a regular user account
+
+- Specify the `--mailbox` option if you want to send an email on behalf of another mailbox. This can be a shared mailbox, group or distribution list. It will be visible in the email that the email was sent by you. You need to be assigned `Send on behalf of` permissions on the mailbox in question.  
+- You can specify the `--sender` option if you want to send an email as if you were the other user.
+The sent email can optionally be saved in the sent folder of that user account. You'll need `Read and manage (Full Access)` permissions on the mailbox of the other user. You can combine the `--sender` and `--mailbox` options to let the other user send a mail on behalf of the specified mailbox.
+
+!!! important
+    You need at least `Mail.Send` delegated permissions on the Microsoft Graph to be able to send emails. When specifying another user as sender, you'll need `Mail.Send.Shared` permissions.
+
 ## Examples
 
-Send a text e-mail to the specified e-mail address
+Send a text email to the specified email address
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site"
 ```
 
-Send an HTML e-mail to the specified e-mail addresses
+Send an HTML email to the specified email addresses
 
 ```sh
 m365 outlook mail send --to "chris@contoso.com,brian@contoso.com" --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the <a href='https://contoso.sharepoint.com/sites/marketing'>team site</a>" --bodyContentType HTML
 ```
 
-Send an HTML e-mail to the specified e-mail address loading e-mail contents from a file on disk
+Send an HTML email to the specified email address loading email contents from a file on disk
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents @email.html --bodyContentType HTML
 ```
 
-Send a text e-mail to the specified e-mail address. Don't store the e-mail in sent items
+Send a text email to the specified email address. Don't store the email in sent items
 
 ```sh
 m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --saveToSentItems false
 ```
+
+Send an email on behalf of a shared mailbox using the signed in user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --mailbox sales@contoso.com
+```
+
+Send an email as another user
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com
+```
+
+Send an email as another user, on behalf of a shared mailbox
+
+```sh
+m365 outlook mail send --to chris@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --sender svc_project@contoso.com --mailbox sales@contoso.com
+```
+
+Send an email with cc and bcc recipients marked as important
+
+```sh
+m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high
+```

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

@@ -10,7 +10,7 @@ m365 pp environment list [options]
 
 ## Options
 
-`-a, --asAdmin [teamId]`
+`-a, --asAdmin`
 Run the command as admin and retrieve all environments. Lists only environments you have explicitly are assigned permissions to by default.
 
 --8<-- "docs/cmd/_global.md"