@pnp/cli-microsoft365 6.2.0-beta.edaa477 → 6.3.0-beta.1140b31

package/dist/m365/teams/commands/meeting/meeting-get.js

@@ -53,23 +53,23 @@ class TeamsMeetingGetCommand extends GraphCommand_1.default {
     }
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const isAppOnlyAuth = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
-            if (isAppOnlyAuth) {
+            const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
+            if (isAppOnlyAccessToken) {
                 if (!args.options.userId && !args.options.userName && !args.options.email) {
                     this.handleError(`The option 'userId', 'userName' or 'email' is required when retrieving meetings using app only permissions`);
                 }
             }
             else {
-                if (!isAppOnlyAuth && (args.options.userId || args.options.userName || args.options.email)) {
+                if (!isAppOnlyAccessToken && (args.options.userId || args.options.userName || args.options.email)) {
                     this.handleError(`The options 'userId', 'userName' and 'email' cannot be used when retrieving meetings using delegated permissions`);
                 }
             }
             if (this.verbose) {
-                logger.logToStderr(`Retrieving meeting for ${isAppOnlyAuth ? 'specific user' : 'currently logged in user'}`);
+                logger.logToStderr(`Retrieving meeting for ${isAppOnlyAccessToken ? 'specific user' : 'currently logged in user'}`);
             }
             try {
                 let requestUrl = `${this.resource}/v1.0/`;
-                if (isAppOnlyAuth) {
+                if (isAppOnlyAccessToken) {
                     requestUrl += 'users/';
                     if (args.options.userId) {
                         requestUrl += args.options.userId;

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

@@ -22,6 +22,7 @@ const commands_1 = require("../../commands");
 const odata_1 = require("../../../../utils/odata");
 const validation_1 = require("../../../../utils/validation");
 const AadUserGetCommand = require("../../../aad/commands/user/user-get");
+const accessToken_1 = require("../../../../utils/accessToken");
 class TeamsMeetingListCommand extends GraphCommand_1.default {
     get name() {
         return commands_1.default.MEETING_LIST;
@@ -42,12 +43,12 @@ class TeamsMeetingListCommand extends GraphCommand_1.default {
     commandAction(logger, args) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                const isAppOnlyAuth = Auth_1.Auth.isAppOnlyAuth(Auth_1.default.service.accessTokens[this.resource].accessToken);
+                const isAppOnlyAccessToken = accessToken_1.accessToken.isAppOnlyAccessToken(Auth_1.default.service.accessTokens[this.resource].accessToken);
                 if (this.verbose) {
-                    logger.logToStderr(`Retrieving meetings for ${isAppOnlyAuth ? 'specific user' : 'currently logged in user'}`);
+                    logger.logToStderr(`Retrieving meetings for ${isAppOnlyAccessToken ? 'specific user' : 'currently logged in user'}`);
                 }
                 let requestUrl = `${this.resource}/v1.0/`;
-                if (isAppOnlyAuth) {
+                if (isAppOnlyAccessToken) {
                     if (!args.options.userId && !args.options.userName && !args.options.email) {
                         throw `The option 'userId', 'userName' or 'email' is required when retrieving meetings using app only permissions`;
                     }

package/dist/m365/teams/commands/message/message-send.js

@@ -0,0 +1,81 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TeamsMessageSendCommand_instances, _TeamsMessageSendCommand_initOptions, _TeamsMessageSendCommand_initValidators;
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const validation_1 = require("../../../../utils/validation");
+const GraphCommand_1 = require("../../../base/GraphCommand");
+const commands_1 = require("../../commands");
+class TeamsMessageSendCommand extends GraphCommand_1.default {
+    get name() {
+        return commands_1.default.MESSAGE_SEND;
+    }
+    get description() {
+        return 'Sends a message to a channel in a Microsoft Teams team';
+    }
+    constructor() {
+        super();
+        _TeamsMessageSendCommand_instances.add(this);
+        __classPrivateFieldGet(this, _TeamsMessageSendCommand_instances, "m", _TeamsMessageSendCommand_initOptions).call(this);
+        __classPrivateFieldGet(this, _TeamsMessageSendCommand_instances, "m", _TeamsMessageSendCommand_initValidators).call(this);
+    }
+    commandAction(logger, args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const requestOptions = {
+                    url: `${this.resource}/v1.0/teams/${args.options.teamId}/channels/${args.options.channelId}/messages`,
+                    headers: {
+                        accept: 'application/json;odata.metadata=none',
+                        'content-type': 'application/json'
+                    },
+                    responseType: 'json',
+                    data: {
+                        body: {
+                            contentType: 'html',
+                            content: args.options.message
+                        }
+                    }
+                };
+                const response = yield request_1.default.post(requestOptions);
+                logger.log(response);
+            }
+            catch (err) {
+                this.handleRejectedODataJsonPromise(err);
+            }
+        });
+    }
+}
+_TeamsMessageSendCommand_instances = new WeakSet(), _TeamsMessageSendCommand_initOptions = function _TeamsMessageSendCommand_initOptions() {
+    this.options.unshift({
+        option: '-i, --teamId <teamId>'
+    }, {
+        option: '-c, --channelId <channelId>'
+    }, {
+        option: '-m, --message <message>'
+    });
+}, _TeamsMessageSendCommand_initValidators = function _TeamsMessageSendCommand_initValidators() {
+    this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
+        if (!validation_1.validation.isValidGuid(args.options.teamId)) {
+            return `${args.options.teamId} is not a valid GUID`;
+        }
+        if (!validation_1.validation.isValidTeamsChannelId(args.options.channelId)) {
+            return `${args.options.channelId} is not a valid Teams ChannelId`;
+        }
+        return true;
+    }));
+};
+module.exports = new TeamsMessageSendCommand();
+//# sourceMappingURL=message-send.js.map

package/dist/m365/teams/commands.js

@@ -35,6 +35,7 @@ exports.default = {
     MESSAGE_GET: `${prefix} message get`,
     MESSAGE_LIST: `${prefix} message list`,
     MESSAGE_REPLY_LIST: `${prefix} message reply list`,
+    MESSAGE_SEND: `${prefix} message send`,
     MESSAGINGSETTINGS_LIST: `${prefix} messagingsettings list`,
     MESSAGINGSETTINGS_SET: `${prefix} messagingsettings set`,
     REPORT_DEVICEUSAGEDISTRIBUTIONUSERCOUNTS: `${prefix} report deviceusagedistributionusercounts`,

package/dist/utils/accessToken.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.accessToken = void 0;
 exports.accessToken = {
     isAppOnlyAccessToken(accessToken) {
-        let isAppOnlyAccessToken = false;
+        let isAppOnlyAccessToken;
         if (!accessToken || accessToken.length === 0) {
             return isAppOnlyAccessToken;
         }

package/dist/utils/formatting.js

@@ -110,6 +110,28 @@ exports.formatting = {
             default:
                 return value;
         }
+    },
+    /**
+     * Converts an object into an xml:
+     * @obj the actual objec
+     * @returns A string containing the xml
+     */
+    objectToXml(obj) {
+        let xml = '';
+        for (const prop in obj) {
+            xml += "<" + prop + ">";
+            if (obj[prop] instanceof Array) {
+                for (const array in obj[prop]) {
+                    xml += this.objectToXml(new Object(obj[prop][array]));
+                }
+            }
+            else {
+                xml += obj[prop];
+            }
+            xml += "</" + prop + ">";
+        }
+        xml = xml.replace(/<\/?[0-9]{1,}>/g, '');
+        return xml;
     }
 };
 //# sourceMappingURL=formatting.js.map

package/dist/utils/spo.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());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spo = void 0;
 const url = require("url");
@@ -237,6 +246,24 @@ exports.spo = {
             });
         });
     },
+    /**
+     * Returns the Graph id of a site
+     * @param webUrl web url e.g. https://contoso.sharepoint.com/sites/site1
+     */
+    getSpoGraphSiteId(webUrl) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = new URL(webUrl);
+            const requestOptions = {
+                url: `https://graph.microsoft.com/v1.0/sites/${url.hostname}:${url.pathname}?$select=id`,
+                headers: {
+                    'accept': 'application/json;odata.metadata=none'
+                },
+                responseType: 'json'
+            };
+            const result = yield request_1.default.get(requestOptions);
+            return result.id;
+        });
+    },
     /**
      * Ensures the folder path exists
      * @param webFullUrl web full url e.g. https://contoso.sharepoint.com/sites/site1

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

@@ -11,16 +11,16 @@ m365 aad app remove [options]
 ## Options
 
 `--appId [appId]`
-: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+: Application (client) ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
 
 `--objectId [objectId]`
-: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+: Object ID of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
 
 `--name [name]`
-: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name`
+: Name of the Azure AD application registration to remove. Specify either `appId`, `objectId` or `name` but not multiple.
 
-`--confirm`:
-: Don't prompt for confirmation to remove the app
+`--confirm`
+: Don't prompt for confirmation to remove the app.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -32,13 +32,13 @@ If the command finds multiple Azure AD application registrations with the specif
 
 ## Examples
 
-Remove the Azure AD application registration by its app (client) ID
+Remove the Azure AD application registration by its app (client) ID.
 
 ```sh
 m365 aad app remove --appId d75be2e1-0204-4f95-857d-51a37cf40be8
 ```
 
-Remove the Azure AD application registration by its object ID
+Remove the Azure AD application registration by its object ID.
 
 ```sh
 m365 aad app remove --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
@@ -49,3 +49,7 @@ Remove the Azure AD application registration by its name. Will NOT prompt for co
 ```sh
 m365 aad app remove --name "My app" --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/option/option-remove.md

@@ -0,0 +1,37 @@
+# context option remove
+
+Removes an already available name from local context file.
+
+## Usage
+
+```sh
+m365 context option remove [options]
+```
+
+## Options
+
+`-n, --name <name>`
+: The name of the option which will be deleted from the context
+
+`--confirm`
+: Don't prompt for confirming removing the option
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes an already available name from the local context file
+
+```sh
+m365 context option remove --name "listName"
+```
+
+Removes an already available name from the local context file without confirmation
+
+```sh
+m365 context option remove --name "listName" --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/option/option-set.md

@@ -0,0 +1,31 @@
+# context option set
+
+Allows to add a new name for the option and value to the local context file.
+
+## Usage
+
+```sh
+m365 context option set [options]
+```
+
+## Options
+
+`-n, --name <name>`
+: The option name for which we will define the value
+
+`-v, --value <value>`
+: Default value for the option
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Define a new default value for name listName in the context
+
+```sh
+m365 context option set --name 'listName' --value 'testList'
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-get.md

@@ -0,0 +1,99 @@
+# pp aibuildermodel get
+
+Gets a specific AI builder models in the specified Power Platform environment
+
+## Usage
+
+```sh
+pp aibuildermodel get [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`-i, --id [id]`
+: The id of the AI Builder model. Specify either `id` or `name` but not both
+
+`-n, --name [name]`
+: The name of the AI Builder model. Specify either `id` or `name` but not both
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get an AI Builder model in a specific environment
+
+```sh
+m365 pp aibuildermodel get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "Document Processing 11/29/2022, 12:58:43 PM"
+```
+
+Get an AI Builder models in a specific environment by id as admin
+
+```sh
+m365 pp aibuildermodel get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "08ffffbe-ec1c-4e64-b64b-dd1db926c613" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "statecode": 0,
+      "_msdyn_templateid_value": "10707e4e-1d56-e911-8194-000d3a6cd5a5",
+      "msdyn_modelcreationcontext": "{}",
+      "createdon": "2022-11-29T11:58:45Z",
+      "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "modifiedon": "2022-11-29T11:58:45Z",
+      "msdyn_sharewithorganizationoncreate": false,
+      "msdyn_aimodelidunique": "b0328b67-47e2-4202-8189-e617ec9a88bd",
+      "solutionid": "fd140aae-4df4-11dd-bd17-0019b9312238",
+      "ismanaged": false,
+      "versionnumber": 1458121,
+      "msdyn_name": "Document Processing 11/29/2022, 12:58:43 PM",
+      "introducedversion": "1.0",
+      "statuscode": 0,
+      "_modifiedby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "overwritetime": "1900-01-01T00:00:00Z",
+      "componentstate": 0,
+      "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "msdyn_aimodelid": "08ffffbe-ec1c-4e64-b64b-dd1db926c613",
+      "_msdyn_activerunconfigurationid_value": null,
+      "overriddencreatedon": null,
+      "_msdyn_retrainworkflowid_value": null,
+      "importsequencenumber": null,
+      "_msdyn_scheduleinferenceworkflowid_value": null,
+      "_modifiedonbehalfby_value": null,
+      "utcconversiontimezonecode": null,
+      "_createdonbehalfby_value": null,
+      "_owningteam_value": null,
+      "timezoneruleversionnumber": null,
+      "iscustomizable": {
+        "Value": true,
+        "CanBeChanged": true,
+        "ManagedPropertyLogicalName": "iscustomizableanddeletable"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    createdon             modifiedon            msdyn_aimodelid                       msdyn_name
+    --------------------  --------------------  ------------------------------------  -------------------------------------------
+    2022-10-25T14:44:48Z  2022-10-25T14:44:48Z  08ffffbe-ec1c-4e64-b64b-dd1db926c613  Document Processing 11/29/2022, 12:58:43 PM
+    ```
+
+=== "CSV"
+
+    ```csv
+    msdyn_name,msdyn_aimodelid,createdon,modifiedon
+    "Document Processing 11/29/2022, 12:58:43 PM",08ffffbe-ec1c-4e64-b64b-dd1db926c613,2022-11-29T11:58:45Z,2022-11-29T11:58:45Z
+    ```

package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-remove.md

@@ -0,0 +1,53 @@
+# pp aibuildermodel remove
+
+Removes the specified Microsoft Power Platform aibuildermodel in the specified Power Platform environment
+
+## Usage
+
+```sh
+m365 pp aibuildermodel remove [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the AI builder model. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the AI builder model. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the AI builder model owned by the currently signed-in user based on the name parameter
+
+```sh
+m365 pp aibuildermodel remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "AI Builder Model Name"
+```
+
+Removes the AI builder model owned by the currently signed-in user based on the name parameter without confirmation
+
+```sh
+m365 pp aibuildermodel remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "AI Builder Model Name" --confirm
+```
+
+Removes the AI builder model owned by another user based on the id parameter
+
+```sh
+m365 pp aibuildermodel remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 9d9a13d0-6255-ed11-bba2-000d3adf774e  --asAdmin
+```
+
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/solution/solution-publish.md

@@ -0,0 +1,52 @@
+# pp solution publish
+
+Publishes the components of a solution in a given Power Platform environment
+
+## Usage
+
+```sh
+m365 pp solution publish [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the solution. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The unique name (not the display name) of the solution. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--wait`
+: Wait for the job to complete
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Publishes the components of a specified solution with a specific name, owned by the currently signed-in user
+
+```sh
+m365 pp solution publish --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name"
+```
+
+Publishes the components of a specified solution owned by the currently signed-in user based on the id parameter and waits for completion
+
+```sh
+m365 pp solution publish --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 00000001-0000-0000-0001-00000000009b --wait
+```
+
+Publishes the components of a specified solution owned by another user based on the name parameter
+
+```sh
+m365 pp solution publish --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Solution Name" --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -38,4 +38,4 @@ m365 spo cdn get --type Private
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-origin-add.md

@@ -35,4 +35,4 @@ m365 spo cdn origin add --type Public --origin */CDN
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-origin-list.md

@@ -38,4 +38,4 @@ m365 spo cdn origin list --type Private
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-origin-remove.md

@@ -38,4 +38,4 @@ m365 spo cdn origin remove --type Public --origin */CDN
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-policy-list.md

@@ -38,4 +38,4 @@ m365 spo cdn policy list --cdnType Private
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-policy-set.md

@@ -38,4 +38,4 @@ m365 spo cdn policy set --cdnType Public --policy IncludeFileExtensions --value
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/cdn/cdn-set.md

@@ -66,4 +66,4 @@ m365 spo cdn set --type Both --enabled true --noDefaultOrigins
 
 ## More information
 
-- General availability of Microsoft 365 CDN: [https://dev.office.com/blogs/general-availability-of-office-365-cdn](https://dev.office.com/blogs/general-availability-of-office-365-cdn)
+- Use Microsoft 365 CDN with SharePoint Online: [https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide](https://learn.microsoft.com/microsoft-365/enterprise/use-microsoft-365-cdn-with-spo?view=o365-worldwide)

package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md

@@ -0,0 +1,47 @@
+# spo file retentionlabel ensure
+
+Apply a retention label to a file
+
+## Usage
+
+```sh
+m365 spo file retentionlabel ensure [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: URL of the site where the retentionlabel from a file to apply is located
+
+`--fileUrl [fileUrl]`
+: The site- or server relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
+
+`i, --fileId [fileId]`
+: The UniqueId (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
+
+`--name <name>`
+: Name of the retention label to apply to the file.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
+
+## Examples
+
+Applies a retention label to a file based on the label name and the fileUrl
+
+```sh
+m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileUrl '/Shared Documents/Document.docx' --name 'Some label'
+```
+
+Applies a retention label to a file based on the label name and the fileId
+
+```sh
+m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8'  --name 'Some label'
+```
+
+## Response
+
+The command won't return a response on success.