@pnp/cli-microsoft365 6.4.0 → 6.5.0-beta.699c15b

package/dist/m365/spo/commands/web/web-set.js

@@ -69,20 +69,37 @@ class SpoWebSetCommand extends SpoCommand_1.default {
                 const searchScope = args.options.searchScope.toLowerCase();
                 payload.SearchScope = SpoWebSetCommand.searchScopeOptions.indexOf(searchScope);
             }
-            const requestOptions = {
-                url: `${args.options.url}/_api/web`,
-                headers: {
-                    'content-type': 'application/json;odata=nometadata',
-                    accept: 'application/json;odata=nometadata'
-                },
-                responseType: 'json',
-                data: payload
-            };
-            if (this.verbose) {
-                logger.logToStderr(`Updating properties of subsite ${args.options.url}...`);
-            }
             try {
+                const requestOptions = {
+                    url: `${args.options.url}/_api/web`,
+                    headers: {
+                        'content-type': 'application/json;odata=nometadata',
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json',
+                    data: payload
+                };
+                if (this.verbose) {
+                    logger.logToStderr(`Updating properties of subsite ${args.options.url}...`);
+                }
                 yield request_1.default.patch(requestOptions);
+                if (typeof args.options.welcomePage !== 'undefined') {
+                    if (this.verbose) {
+                        logger.logToStderr(`Setting welcome page to: ${args.options.welcomePage}...`);
+                    }
+                    const requestOptions = {
+                        url: `${args.options.url}/_api/web/RootFolder`,
+                        headers: {
+                            'content-type': 'application/json;odata=nometadata',
+                            accept: 'application/json;odata=nometadata'
+                        },
+                        responseType: 'json',
+                        data: {
+                            WelcomePage: args.options.welcomePage
+                        }
+                    };
+                    yield request_1.default.patch(requestOptions);
+                }
             }
             catch (err) {
                 this.handleRejectedODataJsonPromise(err);
@@ -105,7 +122,8 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
             quickLaunchEnabled: typeof args.options.quickLaunchEnabled !== 'undefined',
             footerEnabled: typeof args.options.footerEnabled !== 'undefined',
             navAudienceTargetingEnabled: typeof args.options.navAudienceTargetingEnabled !== 'undefined',
-            searchScope: args.options.searchScope !== 'undefined'
+            searchScope: typeof args.options.searchScope !== 'undefined',
+            welcomePage: typeof args.options.welcomePage !== 'undefined'
         });
         this.trackUnknownOptions(this.telemetryProperties, args.options);
     });
@@ -139,6 +157,8 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
     }, {
         option: '--searchScope [searchScope]',
         autocomplete: SpoWebSetCommand.searchScopeOptions
+    }, {
+        option: '--welcomePage [welcomePage]'
     });
 }, _SpoWebSetCommand_initTypes = function _SpoWebSetCommand_initTypes() {
     this.types.boolean.push('megaMenuEnabled', 'footerEnabled', 'quickLaunchEnabled', 'navAudienceTargetingEnabled');

package/dist/m365/spo/commands.js

@@ -14,6 +14,7 @@ exports.default = {
     APP_UNINSTALL: `${prefix} app uninstall`,
     APP_UPGRADE: `${prefix} app upgrade`,
     APPLICATIONCUSTOMIZER_ADD: `${prefix} applicationcustomizer add`,
+    APPLICATIONCUSTOMIZER_LIST: `${prefix} applicationcustomizer list`,
     APPPAGE_ADD: `${prefix} apppage add`,
     APPPAGE_SET: `${prefix} apppage set`,
     CDN_GET: `${prefix} cdn get`,

package/dist/m365/teams/commands/team/team-list.js

@@ -26,6 +26,9 @@ class TeamsTeamListCommand extends GraphCommand_1.default {
     get description() {
         return 'Lists Microsoft Teams in the current tenant';
     }
+    defaultProperties() {
+        return ['id', 'displayName', 'isArchived', 'description'];
+    }
     constructor() {
         super();
         _TeamsTeamListCommand_instances.add(this);
@@ -67,12 +70,7 @@ class TeamsTeamListCommand extends GraphCommand_1.default {
             request_1.default
                 .get(requestOptions)
                 .then((res) => {
-                resolve({
-                    id: group.id,
-                    displayName: group.displayName,
-                    isArchived: res.isArchived,
-                    description: group.description
-                });
+                resolve(res);
             }, (err) => {
                 // If the user is not member of the team he/she cannot access it
                 if (err.statusCode === 403) {

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

@@ -108,6 +108,15 @@ class TodoTaskSetCommand extends GraphCommand_1.default {
         if (options.reminderDateTime) {
             requestBody.reminderDateTime = this.getDateTimeTimeZone(options.reminderDateTime);
         }
+        if (options.categories) {
+            requestBody.categories = options.categories.split(',');
+        }
+        if (options.completedDateTime) {
+            requestBody.completedDateTime = this.getDateTimeTimeZone(options.completedDateTime);
+        }
+        if (options.startDateTime) {
+            requestBody.startDateTime = this.getDateTimeTimeZone(options.startDateTime);
+        }
         return requestBody;
     }
 }
@@ -122,7 +131,10 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_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'
         });
     });
 }, _TodoTaskSetCommand_initOptions = function _TodoTaskSetCommand_initOptions() {
@@ -149,6 +161,12 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_initTelemetry
         autocomplete: ['low', 'normal', 'high']
     }, {
         option: '--reminderDateTime [reminderDateTime]'
+    }, {
+        option: '--categories [categories]'
+    }, {
+        option: '--completedDateTime [completedDateTime]'
+    }, {
+        option: '--startDateTime [startDateTime]'
     });
 }, _TodoTaskSetCommand_initValidators = function _TodoTaskSetCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
@@ -172,6 +190,12 @@ _TodoTaskSetCommand_instances = new WeakSet(), _TodoTaskSetCommand_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.`;
+        }
         return true;
     }));
 }, _TodoTaskSetCommand_initOptionSets = function _TodoTaskSetCommand_initOptionSets() {

package/dist/settingsNames.js

@@ -15,7 +15,8 @@ const settingsNames = {
     output: 'output',
     printErrorsAsPlainText: 'printErrorsAsPlainText',
     prompt: 'prompt',
-    showHelpOnFailure: 'showHelpOnFailure'
+    showHelpOnFailure: 'showHelpOnFailure',
+    showSpinner: 'showSpinner'
 };
 exports.settingsNames = settingsNames;
 //# sourceMappingURL=settingsNames.js.map

package/dist/utils/md.js

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.md = void 0;
+const chalk = require("chalk");
 const fs = require("fs");
 const os_1 = require("os");
 const path = require("path");
 function convertTitle(md) {
     return md.replace(/^#\s+(.*)/gm, (match, title) => {
-        return title.toLocaleUpperCase() + os_1.EOL + Array(title.length + 1).join('=');
+        return chalk.bold(title.toLocaleUpperCase()) + os_1.EOL + Array(title.length + 1).join('=');
     });
 }
 function convertHeadings(md) {
     return md.replace(/^(#+)\s+(.*)/gm, (match, level, content) => {
-        return `${os_1.EOL}${content.toLocaleUpperCase()}`;
+        return `${os_1.EOL}${chalk.bold(content.toLocaleUpperCase())}`;
     });
 }
 function convertAdmonitions(md) {
@@ -31,7 +32,7 @@ function convertDd(md) {
     });
 }
 function convertHyperlinks(md) {
-    return md.replace(/\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
+    return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
         // if the link is the same as the content, return just the link
         if (label === url) {
             return url;

package/docs/docs/_clisettings.md

@@ -18,3 +18,4 @@ Setting name|Definition|Default value
 `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
 `prompt`|Prompts for missing values in required options|`false`
 `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
+`showSpinner`|Display spinner when executing commands|`true`

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

@@ -48,7 +48,7 @@ m365 aad o365group add [options]
 ## Remarks
 
 When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
-If an invalid user is provided in the comma-separated list or Owners or Members, the command operation will fail and the Micrsoft 365 Group will not be created.
+If an invalid user is provided in the comma-separated list of Owners or Members, the command operation will fail and the Microsoft 365 Group will not be created.
 
 ## Examples
 
@@ -76,13 +76,13 @@ Create a public Microsoft 365 Group and set specified users as its members
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
-Create a public Microsoft 365 Group and allows only group members to be able to post conversations to the group.
+Create a public Microsoft 365 Group and allow only group members to be able to post conversations to the group.
 
 ```sh
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --allowMembersToPost
 ```
 
-Create a public Microsoft 365 Group and hides it from the Outlook experiences (web and client).
+Create a public Microsoft 365 Group and hide it from the Outlook experiences (web and client).
 
 ```sh
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --hideGroupInOutlook

package/docs/docs/cmd/pa/app/app-export.md

@@ -0,0 +1,52 @@
+# pa app export
+
+Exports the specified Power App
+
+## Usage
+
+```sh
+m365 pa app export [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The id of the Power App to export
+
+`-e, --environment <environment>`
+: The name of the environment for which to export the app
+
+`-n, --packageDisplayName [packageDisplayName]`
+: The display name to use in the exported package
+
+`-d, --packageDescription [packageDescription]`
+: The description to use in the exported package
+
+`-c, --packageCreatedBy [packageCreatedBy]`
+: The name of the person to be used as the creator of the exported package
+
+`-s, --packageSourceEnvironment [packageSourceEnvironment]`
+: The name of the source environment from which the exported package was taken
+
+`-p, --path [path]`
+: The path to save the exported package to. If not specified the app will be exported in the current working directory
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Export the specified Power App as a ZIP file
+
+```sh
+m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d 
+```
+
+Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
+
+```sh
+m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -0,0 +1,191 @@
+# purview threatassessment get
+
+Get a threat assessment
+
+## Usage
+
+```sh
+m365 purview threatassessment get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the threat assessment
+
+`--includeResults`
+: Include the threat assessment results
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a threat assessment
+
+```sh
+m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
+
+Get a threat assessment including results
+
+```sh
+m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
+```
+
+## Response
+
+### Standard Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
+      "createdDateTime": "2023-02-25T00:23:33.0550644Z",
+      "contentType": "mail",
+      "expectedAssessment": "block",
+      "category": "spam",
+      "status": "pending",
+      "requestSource": "administrator",
+      "recipientEmail": "john@contoso.com",
+      "destinationRoutingReason": "notJunk",
+      "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
+      "createdBy": {
+        "user": {
+          "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+          "displayName": "John Doe"
+        }
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    category                : spam
+    contentType             : mail
+    createdBy               : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+    createdDateTime         : 2023-02-25T00:23:33.0550644Z
+    destinationRoutingReason: notJunk
+    expectedAssessment      : block
+    id                      : 8aaba0ac-ec4d-4e62-5774-08db16c68731
+    messageUri              : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
+    recipientEmail          : john@contoso.com
+    requestSource           : administrator
+    status                  : pending
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy
+    8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731"
+
+    Date: 25/02/2023
+
+    ## 8aaba0ac-ec4d-4e62-5774-08db16c68731
+
+    Property | Value
+    ---------|-------
+    id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
+    createdDateTime | 2023-02-25T00:23:33.0550644Z
+    contentType | mail
+    expectedAssessment | block
+    category | spam
+    status | pending
+    requestSource | administrator
+    recipientEmail | john@contoso.com
+    destinationRoutingReason | notJunk
+    messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
+    createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+    ```
+
+### `includeResults` response
+
+When we make use of the option `includeResults` the response will differ. 
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
+      "createdDateTime": "2023-02-25T00:23:33.0550644Z",
+      "contentType": "mail",
+      "expectedAssessment": "block",
+      "category": "spam",
+      "status": "pending",
+      "requestSource": "administrator",
+      "recipientEmail": "john@contoso.com",
+      "destinationRoutingReason": "notJunk",
+      "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
+      "createdBy": {
+        "user": {
+          "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
+          "displayName": "John Doe"
+        }
+      },
+      "results": [
+        {
+          "id": "a5455871-18d1-44d8-0866-08db16c68b85",
+          "createdDateTime": "2023-02-25T00:23:40.28Z",
+          "resultType": "checkPolicy",
+          "message": "No policy was hit."
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    category                : spam
+    contentType             : mail
+    createdBy               : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+    createdDateTime         : 2023-02-25T00:23:33.0550644Z
+    destinationRoutingReason: notJunk
+    expectedAssessment      : block
+    id                      : 8aaba0ac-ec4d-4e62-5774-08db16c68731
+    messageUri              : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
+    recipientEmail          : john@contoso.com
+    requestSource           : administrator
+    results                 : [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
+    status                  : pending
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy,results
+    8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}","[{""id"":""a5455871-18d1-44d8-0866-08db16c68b85"",""createdDateTime"":""2023-02-25T00:23:40.28Z"",""resultType"":""checkPolicy"",""message"":""No policy was hit.""}]"
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"
+
+    Date: 25/02/2023
+
+    ## 8aaba0ac-ec4d-4e62-5774-08db16c68731
+
+    Property | Value
+    ---------|-------
+    id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
+    createdDateTime | 2023-02-25T00:23:33.0550644Z
+    contentType | mail
+    expectedAssessment | block
+    category | spam
+    status | pending
+    requestSource | administrator
+    recipientEmail | john@contoso.com
+    destinationRoutingReason | notJunk
+    messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
+    createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
+    results | [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
+    ```

package/docs/docs/cmd/request.md

@@ -40,6 +40,12 @@ If you specify the `resource` option, the CLI will try to retrieve a valid token
 
 Specify additional headers by typing them as options, for example: `--content-type "application/json"`, `--if-match "*"`, `--x-requestdigest "somedigest"`.
 
+You can simplify the request by using tokens for the `url` option. Following tokens are available:
+
+- `@graph` resolves to `https://graph.microsoft.com/v1.0`
+- `@graphbeta` resolves to `https://graph.microsoft.com/beta`
+- `@spo` resolves to the current SharePoint URL if available. You can set a SharePoint URL using the [spo set](./spo/spo-set.md) command.
+
 !!! important
     When building the request, depending on the shell you use, you might need to escape all `$` characters in the URL, request headers, and the body. If you don't do it, the shell will treat it as a variable and will remove the following word from the request, breaking the request.
 
@@ -63,16 +69,16 @@ Call the SharePoint API to retrieve a form digest.
 m365 request --method post --url "https://contoso.sharepoint.com/sites/project-x/_api/contextinfo"
 ```
 
-Call the SharePoint API to update a site title.
+Call the SharePoint API to update a site title using the @spo token.
 
 ```sh
-m365 request --method post --url "https://contoso.sharepoint.com/sites/project-x/_api/web" --body '{ "Title": "New title" }' --content-type "application/json" --x-http-method "PATCH"
+m365 request --method post --url "@spo/sites/project-x/_api/web" --body '{ "Title": "New title" }' --content-type "application/json" --x-http-method "PATCH"
 ```
 
-Call the Microsoft Graph to get a profile photo.
+Call the Microsoft Graph to get a profile photo using the @graphbeta token.
 
 ```sh
-m365 request --url "https://graph.microsoft.com/beta/me/photo/\$value" --filePath ./profile-pic.jpg
+m365 request --url '@graphbeta/me/photo/$value' --filePath ./profile-pic.jpg
 ```
 
 ## Response

package/docs/docs/cmd/spfx/project/project-upgrade.md

@@ -29,13 +29,13 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.16.1).
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 
 !!! important
     Run this command in the folder where the project that you want to upgrade is located. This command doesn't change your project files.
-    
+
 ## Examples
 
 Get instructions to upgrade the current SharePoint Framework project to SharePoint Framework version 1.5.0 and save the findings in a Markdown file

package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-add.md

@@ -22,6 +22,9 @@ m365 spo applicationcustomizer add [options]
 `--clientSideComponentProperties [clientSideComponentProperties]`
 : JSON string with application customizer properties
 
+`-s, --scope [scope]`
+: Scope of the application customizer. Allowed values: `Site`, `Web`. Defaults to `Site`.
+
 --8<-- "docs/cmd/_global.md"
 
 ## Remarks
@@ -48,7 +51,7 @@ m365 spo applicationcustomizer add --title 'Some customizer' --clientSideCompone
 Adds an application customizer to the sales site with some properties.
 
 ```sh
-m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales
+m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales --scope 'Site'
 ```
 
 ## Response

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

@@ -0,0 +1,109 @@
+# spo applicationcustomizer list
+
+Get a list of application customizers that are added to a site.
+
+## Usage
+
+```sh
+m365 spo applicationcustomizer list [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The url of the site.
+
+`-s, --scope [scope]`
+: Scope of the application customizers. Allowed values `Site`, `Web`, `All`. Defaults to `All`
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Retrieves a list of application customizers.
+
+```sh
+m365 spo applicationcustomizer list --webUrl https://contoso.sharepoint.com/sites/sales
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "ClientSideComponentId": "4358e70e-ec3c-4713-beb6-39c88f7621d1",
+        "ClientSideComponentProperties": "{\"listTitle\":\"News\",\"listViewTitle\":\"Published News\"}",
+        "CommandUIExtension": null,
+        "Description": null,
+        "Group": null,
+        "HostProperties": "",
+        "Id": "f405303c-6048-4636-9660-1b7b2cadaef9",
+        "ImageUrl": null,
+        "Location": "ClientSideExtension.ApplicationCustomizer",
+        "Name": "{f405303c-6048-4636-9660-1b7b2cadaef9}",
+        "RegistrationId": null,
+        "RegistrationType": 0,
+        "Rights": {
+          "High": 0,
+          "Low": 0
+        },
+        "Scope": 3,
+        "ScriptBlock": null,
+        "ScriptSrc": null,
+        "Sequence": 65536,
+        "Title": "NewsTicker",
+        "Url": null,
+        "VersionOfUserCustomAction": "1.0.1.0"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    Name                                    Location                                   Scope  Id
+    --------------------------------------  -----------------------------------------  -----  ------------------------------------
+    {f405303c-6048-4636-9660-1b7b2cadaef9}  ClientSideExtension.ApplicationCustomizer  3      f405303c-6048-4636-9660-1b7b2cadaef9
+    ```
+
+=== "CSV"
+
+    ```csv
+    Name,Location,Scope,Id
+    {f405303c-6048-4636-9660-1b7b2cadaef9},ClientSideExtension.ApplicationCustomizer,3,f405303c-6048-4636-9660-1b7b2cadaef9
+    ```
+
+=== "Markdown"
+
+    ```md
+    # spo applicationcustomizer list --webUrl "https://contoso.sharepoint.com"
+
+    Date: 28/2/2023
+
+    ## NewsTicker (f405303c-6048-4636-9660-1b7b2cadaef9)
+
+    Property | Value
+    ---------|-------
+    ClientSideComponentId | 4358e70e-ec3c-4713-beb6-39c88f7621d1
+    ClientSideComponentProperties | {"listTitle":"News","listViewTitle":"Published News"}
+    CommandUIExtension | null
+    Description | null
+    Group | null
+    HostProperties |
+    Id | f405303c-6048-4636-9660-1b7b2cadaef9
+    ImageUrl | null
+    Location | ClientSideExtension.ApplicationCustomizer
+    Name | {f405303c-6048-4636-9660-1b7b2cadaef9}
+    RegistrationId | null
+    RegistrationType | 0
+    Rights | {"High":0,"Low":0}
+    Scope | 3
+    ScriptBlock | null
+    ScriptSrc | null
+    Sequence | 65536
+    Title | NewsTicker
+    Url | null
+    VersionOfUserCustomAction | 1.0.1.0
+    ```