@pnp/cli-microsoft365 6.2.0-beta.d5442a1 → 6.2.0-beta.edaa477

package/dist/m365/spo/commands/group/group-member-add.js

@@ -20,6 +20,7 @@ const request_1 = require("../../../../request");
 const formatting_1 = require("../../../../utils/formatting");
 const validation_1 = require("../../../../utils/validation");
 const AadUserGetCommand = require("../../../aad/commands/user/user-get");
+const AadGroupGetCommand = require("../../../aad/commands/group/group-get");
 const SpoUserGetCommand = require("../user/user-get");
 const SpoCommand_1 = require("../../../base/SpoCommand");
 const commands_1 = require("../../commands");
@@ -47,7 +48,7 @@ class SpoGroupMemberAddCommand extends SpoCommand_1.default {
                 const groupId = yield this.getGroupId(args, logger);
                 const resolvedUsernameList = yield this.getValidUsers(args, logger);
                 if (this.verbose) {
-                    logger.logToStderr(`Adding user(s) to SharePoint Group ${args.options.groupId ? args.options.groupId : args.options.groupName}`);
+                    logger.logToStderr(`Adding user(s) to SharePoint Group ${args.options.groupId || args.options.groupName}`);
                 }
                 const data = {
                     url: args.options.webUrl,
@@ -104,15 +105,19 @@ class SpoGroupMemberAddCommand extends SpoCommand_1.default {
         }
         const validUserNames = [];
         const invalidUserNames = [];
-        const userIdentifiers = args.options.userName || args.options.email || args.options.userId.toString();
+        const userIdentifiers = args.options.userName || args.options.email || args.options.aadGroupId || args.options.aadGroupName || args.options.userId.toString();
         return Promise
             .all(userIdentifiers.split(',').map((userIdentifier) => __awaiter(this, void 0, void 0, function* () {
+            const user = userIdentifier.trim();
             try {
                 if (args.options.userId) {
-                    yield this.spoUserGet(args.options, userIdentifier.trim(), logger, validUserNames);
+                    yield this.spoUserGet(args.options, user, logger, validUserNames);
+                }
+                else if (args.options.aadGroupId || args.options.aadGroupName) {
+                    yield this.aadGroupGet(args.options, user, logger, validUserNames);
                 }
                 else {
-                    yield this.aadUserGet(args.options, userIdentifier.trim(), logger, validUserNames);
+                    yield this.aadUserGet(args.options, user, logger, validUserNames);
                 }
             }
             catch (err) {
@@ -141,6 +146,19 @@ class SpoGroupMemberAddCommand extends SpoCommand_1.default {
             validUserNames.push(JSON.parse(aadUserGetOutput.stdout).userPrincipalName);
         });
     }
+    aadGroupGet(options, userIdentifier, logger, validUserNames) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Get UPN from Azure AD for group ${userIdentifier}`);
+            }
+            const aadUserGetCommandoptions = Object.assign(Object.assign(Object.assign({}, (options.aadGroupId && { id: userIdentifier })), (options.aadGroupName && { title: userIdentifier })), { output: 'json', debug: options.debug, verbose: options.verbose });
+            const aadGroupGetOutput = yield Cli_1.Cli.executeCommandWithOutput(AadGroupGetCommand, { options: Object.assign(Object.assign({}, aadUserGetCommandoptions), { _: [] }) });
+            if (this.debug) {
+                logger.logToStderr(aadGroupGetOutput.stderr);
+            }
+            validUserNames.push(JSON.parse(aadGroupGetOutput.stdout).mail);
+        });
+    }
     spoUserGet(options, userIdentifier, logger, validUserNames) {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.verbose) {
@@ -174,7 +192,9 @@ _SpoGroupMemberAddCommand_instances = new WeakSet(), _SpoGroupMemberAddCommand_i
             groupName: typeof args.options.groupName !== 'undefined',
             userName: typeof args.options.userName !== 'undefined',
             email: typeof args.options.email !== 'undefined',
-            userId: typeof args.options.userId !== 'undefined'
+            userId: typeof args.options.userId !== 'undefined',
+            aadGroupId: typeof args.options.aadGroupId !== 'undefined',
+            aadGroupName: typeof args.options.aadGroupName !== 'undefined'
         });
     });
 }, _SpoGroupMemberAddCommand_initOptions = function _SpoGroupMemberAddCommand_initOptions() {
@@ -190,6 +210,10 @@ _SpoGroupMemberAddCommand_instances = new WeakSet(), _SpoGroupMemberAddCommand_i
         option: '--email [email]'
     }, {
         option: '--userId [userId]'
+    }, {
+        option: '--aadGroupId [aadGroupId]'
+    }, {
+        option: '--aadGroupName [aadGroupName]'
     });
 }, _SpoGroupMemberAddCommand_initValidators = function _SpoGroupMemberAddCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
@@ -210,10 +234,13 @@ _SpoGroupMemberAddCommand_instances = new WeakSet(), _SpoGroupMemberAddCommand_i
         if (args.options.email && args.options.email.split(',').some(e => !validation_1.validation.isValidUserPrincipalName(e))) {
             return `${args.options.email} contains one or more invalid email addresses`;
         }
+        if (args.options.aadGroupId && args.options.aadGroupId.split(',').some(e => !validation_1.validation.isValidGuid(e))) {
+            return `${args.options.aadGroupId} contains one or more invalid GUIDs`;
+        }
         return true;
     }));
 }, _SpoGroupMemberAddCommand_initOptionSets = function _SpoGroupMemberAddCommand_initOptionSets() {
-    this.optionSets.push({ options: ['groupId', 'groupName'] }, { options: ['userName', 'email', 'userId'] });
+    this.optionSets.push({ options: ['groupId', 'groupName'] }, { options: ['userName', 'email', 'userId', 'aadGroupId', 'aadGroupName'] });
 };
 module.exports = new SpoGroupMemberAddCommand();
 //# sourceMappingURL=group-member-add.js.map

package/dist/m365/spo/commands/term/term-list.js

@@ -30,7 +30,7 @@ class SpoTermListCommand extends SpoCommand_1.default {
         return 'Lists taxonomy terms from the given term set';
     }
     defaultProperties() {
-        return ['Id', 'Name'];
+        return ['Id', 'Name', 'ParentTermId'];
     }
     constructor() {
         super();
@@ -50,27 +50,47 @@ class SpoTermListCommand extends SpoCommand_1.default {
                 }
                 const termGroupQuery = args.options.termGroupId ? `<Method Id="77" ParentId="75" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termGroupId}}</Parameter></Parameters></Method>` : `<Method Id="77" ParentId="75" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termGroupName)}</Parameter></Parameters></Method>`;
                 const termSetQuery = args.options.termSetId ? `<Method Id="82" ParentId="80" Name="GetById"><Parameters><Parameter Type="Guid">{${args.options.termSetId}}</Parameter></Parameters></Method>` : `<Method Id="82" ParentId="80" Name="GetByName"><Parameters><Parameter Type="String">${formatting_1.formatting.escapeXml(args.options.termSetName)}</Parameter></Parameters></Method>`;
-                const requestOptions = {
-                    url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
-                    headers: {
-                        'X-RequestDigest': res.FormDigestValue
-                    },
-                    data: `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="70" ObjectPathId="69" /><ObjectIdentityQuery Id="71" ObjectPathId="69" /><ObjectPath Id="73" ObjectPathId="72" /><ObjectIdentityQuery Id="74" ObjectPathId="72" /><ObjectPath Id="76" ObjectPathId="75" /><ObjectPath Id="78" ObjectPathId="77" /><ObjectIdentityQuery Id="79" ObjectPathId="77" /><ObjectPath Id="81" ObjectPathId="80" /><ObjectPath Id="83" ObjectPathId="82" /><ObjectIdentityQuery Id="84" ObjectPathId="82" /><ObjectPath Id="86" ObjectPathId="85" /><Query Id="87" ObjectPathId="85"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="Name" ScalarProperty="true" /><Property Name="Id" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><StaticMethod Id="69" Name="GetTaxonomySession" TypeId="{981cbc68-9edc-4f8d-872f-71146fcbb84f}" /><Method Id="72" ParentId="69" Name="GetDefaultSiteCollectionTermStore" /><Property Id="75" ParentId="72" Name="Groups" />${termGroupQuery}<Property Id="80" ParentId="77" Name="TermSets" />${termSetQuery}<Property Id="85" ParentId="82" Name="Terms" /></ObjectPaths></Request>`
-                };
-                const processQuery = yield request_1.default.post(requestOptions);
-                const json = JSON.parse(processQuery);
-                const response = json[0];
-                if (response.ErrorInfo) {
-                    throw response.ErrorInfo.ErrorMessage;
-                }
-                const result = json[json.length - 1];
+                const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="70" ObjectPathId="69" /><ObjectIdentityQuery Id="71" ObjectPathId="69" /><ObjectPath Id="73" ObjectPathId="72" /><ObjectIdentityQuery Id="74" ObjectPathId="72" /><ObjectPath Id="76" ObjectPathId="75" /><ObjectPath Id="78" ObjectPathId="77" /><ObjectIdentityQuery Id="79" ObjectPathId="77" /><ObjectPath Id="81" ObjectPathId="80" /><ObjectPath Id="83" ObjectPathId="82" /><ObjectIdentityQuery Id="84" ObjectPathId="82" /><ObjectPath Id="86" ObjectPathId="85" /><Query Id="87" ObjectPathId="85"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="Name" ScalarProperty="true" /><Property Name="Id" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><StaticMethod Id="69" Name="GetTaxonomySession" TypeId="{981cbc68-9edc-4f8d-872f-71146fcbb84f}" /><Method Id="72" ParentId="69" Name="GetDefaultSiteCollectionTermStore" /><Property Id="75" ParentId="72" Name="Groups" />${termGroupQuery}<Property Id="80" ParentId="77" Name="TermSets" />${termSetQuery}<Property Id="85" ParentId="82" Name="Terms" /></ObjectPaths></Request>`;
+                const result = yield this.executeCsomCall(data, spoAdminUrl, res);
+                const terms = [];
                 if (result._Child_Items_ && result._Child_Items_.length > 0) {
-                    result._Child_Items_.forEach(t => {
-                        t.CreatedDate = new Date(Number(t.CreatedDate.replace('/Date(', '').replace(')/', ''))).toISOString();
-                        t.Id = t.Id.replace('/Guid(', '').replace(')/', '');
-                        t.LastModifiedDate = new Date(Number(t.LastModifiedDate.replace('/Date(', '').replace(')/', ''))).toISOString();
+                    for (const term of result._Child_Items_) {
+                        this.setTermDetails(term);
+                        terms.push(term);
+                        if (args.options.includeChildTerms && term.TermsCount > 0) {
+                            yield this.getChildTerms(spoAdminUrl, res, term);
+                        }
+                    }
+                }
+                if (!args.options.output || args.options.output === 'json') {
+                    logger.log(terms);
+                }
+                else if (!args.options.includeChildTerms) {
+                    // Converted to text friendly output
+                    logger.log(terms.map(i => {
+                        return {
+                            Id: i.Id,
+                            Name: i.Name
+                        };
+                    }));
+                }
+                else {
+                    // Converted to text friendly output
+                    const friendlyOutput = [];
+                    terms.forEach(term => {
+                        term.ParentTermId = '';
+                        friendlyOutput.push(term);
+                        if (term.Children && term.Children.length > 0) {
+                            this.getFriendlyChildTerms(term, friendlyOutput);
+                        }
                     });
-                    logger.log(result._Child_Items_);
+                    logger.log(friendlyOutput.map(i => {
+                        return {
+                            Id: i.Id,
+                            Name: i.Name,
+                            ParentTermId: i.ParentTermId
+                        };
+                    }));
                 }
             }
             catch (err) {
@@ -78,6 +98,57 @@ class SpoTermListCommand extends SpoCommand_1.default {
             }
         });
     }
+    getFriendlyChildTerms(term, friendlyOutput) {
+        term.Children.forEach(childTerm => {
+            childTerm.ParentTermId = term.Id;
+            friendlyOutput.push(childTerm);
+            if (childTerm.Children && childTerm.Children.length > 0) {
+                this.getFriendlyChildTerms(childTerm, friendlyOutput);
+            }
+        });
+    }
+    getChildTerms(spoAdminUrl, res, parentTerm) {
+        return __awaiter(this, void 0, void 0, function* () {
+            parentTerm.Children = [];
+            const data = `<Request AddExpandoFieldTypeSuffix="true" SchemaVersion="15.0.0.0" LibraryVersion="16.0.0.0" ApplicationName="${config_1.default.applicationName}" xmlns="http://schemas.microsoft.com/sharepoint/clientquery/2009"><Actions><ObjectPath Id="20" ObjectPathId="19" /><Query Id="21" ObjectPathId="19"><Query SelectAllProperties="false"><Properties /></Query><ChildItemQuery SelectAllProperties="true"><Properties><Property Name="CustomSortOrder" ScalarProperty="true" /><Property Name="CustomProperties" ScalarProperty="true" /><Property Name="LocalCustomProperties" ScalarProperty="true" /></Properties></ChildItemQuery></Query></Actions><ObjectPaths><Property Id="19" ParentId="16" Name="Terms" /><Identity Id="16" Name="${parentTerm._ObjectIdentity_}" /></ObjectPaths></Request>`;
+            const result = yield this.executeCsomCall(data, spoAdminUrl, res);
+            if (result._Child_Items_ && result._Child_Items_.length > 0) {
+                for (const term of result._Child_Items_) {
+                    this.setTermDetails(term);
+                    parentTerm.Children.push(term);
+                    if (term.TermsCount > 0) {
+                        yield this.getChildTerms(spoAdminUrl, res, term);
+                    }
+                }
+            }
+        });
+    }
+    setTermDetails(term) {
+        term.CreatedDate = this.parseTermDateToIsoString(term.CreatedDate);
+        term.Id = term.Id.replace('/Guid(', '').replace(')/', '');
+        term.LastModifiedDate = this.parseTermDateToIsoString(term.LastModifiedDate);
+    }
+    parseTermDateToIsoString(dateAsString) {
+        return new Date(Number(dateAsString.replace('/Date(', '').replace(')/', ''))).toISOString();
+    }
+    executeCsomCall(data, spoAdminUrl, res) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = {
+                url: `${spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
+                headers: {
+                    'X-RequestDigest': res.FormDigestValue
+                },
+                data: data
+            };
+            const processQuery = yield request_1.default.post(requestOptions);
+            const json = JSON.parse(processQuery);
+            const response = json[0];
+            if (response.ErrorInfo) {
+                throw response.ErrorInfo.ErrorMessage;
+            }
+            return json[json.length - 1];
+        });
+    }
 }
 _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry = function _SpoTermListCommand_initTelemetry() {
     this.telemetry.push((args) => {
@@ -85,7 +156,8 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
             termGroupId: typeof args.options.termGroupId !== 'undefined',
             termGroupName: typeof args.options.termGroupName !== 'undefined',
             termSetId: typeof args.options.termSetId !== 'undefined',
-            termSetName: typeof args.options.termSetName !== 'undefined'
+            termSetName: typeof args.options.termSetName !== 'undefined',
+            includeChildTerms: !!args.options.includeChildTerms
         });
     });
 }, _SpoTermListCommand_initOptions = function _SpoTermListCommand_initOptions() {
@@ -97,18 +169,16 @@ _SpoTermListCommand_instances = new WeakSet(), _SpoTermListCommand_initTelemetry
         option: '--termSetId [termSetId]'
     }, {
         option: '--termSetName [termSetName]'
+    }, {
+        option: '--includeChildTerms'
     });
 }, _SpoTermListCommand_initValidators = function _SpoTermListCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {
-        if (args.options.termGroupId) {
-            if (!validation_1.validation.isValidGuid(args.options.termGroupId)) {
-                return `${args.options.termGroupId} is not a valid GUID`;
-            }
+        if (args.options.termGroupId && !validation_1.validation.isValidGuid(args.options.termGroupId)) {
+            return `${args.options.termGroupId} is not a valid GUID`;
         }
-        if (args.options.termSetId) {
-            if (!validation_1.validation.isValidGuid(args.options.termSetId)) {
-                return `${args.options.termSetId} is not a valid GUID`;
-            }
+        if (args.options.termSetId && !validation_1.validation.isValidGuid(args.options.termSetId)) {
+            return `${args.options.termSetId} is not a valid GUID`;
         }
         return true;
     }));

package/dist/m365/spo/commands.js

@@ -62,7 +62,9 @@ exports.default = {
     FILE_ROLEINHERITANCE_BREAK: `${prefix} file roleinheritance break`,
     FILE_ROLEINHERITANCE_RESET: `${prefix} file roleinheritance reset`,
     FILE_SHARINGINFO_GET: `${prefix} file sharinginfo get`,
+    FILE_SHARINGLINK_GET: `${prefix} file sharinglink get`,
     FILE_SHARINGLINK_LIST: `${prefix} file sharinglink list`,
+    FILE_SHARINGLINK_REMOVE: `${prefix} file sharinglink remove`,
     FILE_VERSION_CLEAR: `${prefix} file version clear`,
     FILE_VERSION_GET: `${prefix} file version get`,
     FILE_VERSION_LIST: `${prefix} file version list`,

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

@@ -0,0 +1,140 @@
+# onenote page list
+
+Retrieve a list of OneNote pages.
+
+## Usage
+
+```sh
+m365 onenote page list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: Id of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--userName [userName]`
+: Name of the user. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--groupId [groupId]`
+: Id of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`--groupName [groupName]`
+: Name of the SharePoint group. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+`-u, --webUrl [webUrl]`
+: URL of the SharePoint site. Use either `userId`, `userName`, `groupId`, `groupName` or `webUrl` but not multiple.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+When we don't specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, the OneNote pages will be retrieved of the currently logged in user.
+
+## Examples
+
+List Microsoft OneNote pages for the currently logged in user
+
+```sh
+m365 onenote page list
+```
+
+List Microsoft OneNote pages in a specific group specified by id
+
+```sh
+m365 onenote page list --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
+```
+
+List Microsoft OneNote pages in a specific group specified by name
+
+```sh
+m365 onenote page list --groupName "MyGroup"
+```
+
+List Microsoft OneNote pages for a specific user specified by name
+
+```sh
+m365 onenote page list --userName user1@contoso.onmicrosoft.com
+```
+
+List Microsoft OneNote pages for a specific user specified by id
+
+```sh
+m365 onenote page list --userId 2609af39-7775-4f94-a3dc-0dd67657e900
+```
+
+List Microsoft OneNote pages for a specific site
+
+```sh
+m365 onenote page list --webUrl https://contoso.sharepoint.com/sites/testsite
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
+        "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678",
+        "createdDateTime": "2023-01-07T10:57:15Z",
+        "title": "Page B",
+        "createdByAppId": "",
+        "contentUrl": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content",
+        "lastModifiedDateTime": "2023-01-07T10:57:17Z",
+        "links": {
+          "oneNoteClientUrl": {
+            "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B&section-id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end"
+          },
+          "oneNoteWebUrl": {
+            "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"
+          }
+        },
+        "parentSection": {
+          "id": "1-3eb21088-b613-4698-98df-92a7d34e0678",
+          "displayName": "Test",
+          "self": "https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime       title   id
+    --------------------  ------  --------------------------------------------------------------------------
+    2023-01-07T10:57:15Z  Page B  1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    ```
+
+=== "CSV"
+
+    ```csv
+    createdDateTime,title,id
+    2023-01-07T10:57:15Z,Page B,1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    ```
+
+=== "Markdown"
+
+    ```md
+    # onenote page list --userName "mathijs@mathijsdev2.onmicrosoft.com"
+
+    Date: 07/01/2023
+
+    ## Page A (1-a26aaec43ed348bd82edf4eb44e73d6c!14-3eb21088-b613-4698-98df-92a7d34e0678)
+
+    ## Page B (1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678)
+
+    Property | Value
+    ---------|-------
+    id | 1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    self | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678
+    createdDateTime | 2023-01-07T10:57:15Z
+    title | Page B
+    createdByAppId |
+    contentUrl | https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/pages/1-a26aaec43ed348bd82edf4eb44e73d6c!68-3eb21088-b613-4698-98df-92a7d34e0678/content
+    lastModifiedDateTime | 2023-01-07T10:57:17Z
+    links | { "oneNoteClientUrl": { "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote/Test.one#Page%20B& -id=94cacaca-d6b5-428d-b967-d3cf01b95c28&page-id=46a1b220-7ffd-4512-a571-55322097c08d&end" }, "oneNoteWebUrl": { "href": "https://contoso-my.sharepoint.com/personal/john_contoso_com/Documents/Notitieblokken/My%20OneNote?wd=target%28Test.one%7C94cacaca-d6b5-428d-b967-d3cf01b95c28%2FPage%20B%7C46a1b220-7ffd-4512-a571-55322097c08d%2F%29"}}
+    parentSection | {"id":"1-3eb21088-b613-4698-98df-92a7d34e0678","displayName":"Test","self":"https://graph.microsoft.com/v1.0/users/john@contoso.com/onenote/sections/1-3eb21088-b613-4698-98df-92a7d34e0678"}
+    ```

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.md

@@ -0,0 +1,128 @@
+# purview retentionlabel add
+
+Create a retention label
+
+## Usage
+
+```sh
+m365 purview retentionlabel add [options]
+```
+
+## Options
+
+`-n, --displayName <displayName>`
+: The display name of the label.
+
+`--behaviorDuringRetentionPeriod <behaviorDuringRetentionPeriod>`
+: Specifies how the behavior of a document with this label should be during the retention period. Allowed values: `doNotRetain`, `retain`, `retainAsRecord`, `retainAsRegulatoryRecord`.
+
+`--actionAfterRetentionPeriod <actionAfterRetentionPeriod>`
+: Specifies the action to take on a document with this label applied after the retention period. Allowed values: `none`, `delete`, `startDispositionReview`.
+
+`--retentionDuration <retentionDuration>`
+: The number of days to retain the content.
+
+`-t, --retentionTrigger [retentionTrigger]`
+: Specifies whether the retention duration is calculated from the content creation date, labeled date, or last modification date. Allowed values: `dateLabeled`, `dateCreated`, `dateModified`, `dateOfEvent`. Defaults to `dateLabeled`.
+
+`--defaultRecordBehavior [defaultRecordBehavior]`
+: Specifies the locked or unlocked state of a record label when it is created. Allowed values: `startLocked`, `startUnlocked`, Defaults to `startLocked`.
+
+`--descriptionForUsers [descriptionForUsers]`
+: The label information for the user.
+
+`--descriptionForAdmins [descriptionForAdmins]`
+: The label information for the admin.
+
+`--labelToBeApplied [labelToBeApplied]`
+: Specifies the replacement label to be applied automatically after the retention period of the current label ends.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Create a retention label that retains documents and deletes them after one year.
+
+```sh
+m365 purview retentionlabel add --displayName 'some label' --behaviorDuringRetentionPeriod retain --actionAfterRetentionPeriod delete --retentionDuration 365
+```
+
+Create a retention label that retains documents as records and does not take any action one year after the last modification date.
+
+```sh
+m365 purview retentionlabel add --displayName 'some label' --behaviorDuringRetentionPeriod retainAsRecord --actionAfterRetentionPeriod none --retentionDuration 365 --retentionTrigger dateModified
+```
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+## More information
+
+- Create retentionLabel: [https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http](https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http)
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "some label",
+      "descriptionForAdmins": "Description for admins",
+      "descriptionForUsers": "Description for users",
+      "isInUse": false,
+      "retentionTrigger": "dateLabeled",
+      "behaviorDuringRetentionPeriod": "retain",
+      "actionAfterRetentionPeriod": "delete",
+      "createdDateTime": "2022-12-21T09:28:37Z",
+      "lastModifiedDateTime": "2022-12-21T09:28:37Z",
+      "labelToBeApplied": "another label",
+      "defaultRecordBehavior": "startLocked",
+      "id": "f7e05955-210b-4a8e-a5de-3c64cfa6d9be",
+      "retentionDuration": {
+        "days": 365
+      },
+      "createdBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "lastModifiedBy": {
+        "user": {
+          "id": null,
+          "displayName": "John Doe"
+        }
+      },
+      "dispositionReviewStages": []
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    actionAfterRetentionPeriod   : delete
+    behaviorDuringRetentionPeriod: retain
+    createdBy                    : {"user":{"id":null,"displayName":"John Doe"}}
+    createdDateTime              : 2022-12-21T09:32:38Z
+    defaultRecordBehavior        : startLocked
+    descriptionForAdmins         : Description for admins
+    descriptionForUsers          : Description for users
+    displayName                  : some label
+    dispositionReviewStages      : []
+    id                           : 3b388f3c-541b-4696-ad0e-83f960695d89
+    isInUse                      : false
+    labelToBeApplied             : another label
+    lastModifiedBy               : {"user":{"id":null,"displayName":"John Doe"}}
+    lastModifiedDateTime         : 2022-12-21T09:32:38Z
+    retentionDuration            : {"days":365}
+    retentionTrigger             : dateLabeled
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,descriptionForAdmins,descriptionForUsers,isInUse,retentionTrigger,behaviorDuringRetentionPeriod,actionAfterRetentionPeriod,createdDateTime,lastModifiedDateTime,labelToBeApplied,defaultRecordBehavior,id,retentionDuration,createdBy,lastModifiedBy,dispositionReviewStages
+    some label,Description for admins,Description for users,,dateLabeled,retain,delete,2022-12-21T09:33:32Z,2022-12-21T09:33:32Z,another label,startLocked,cfc8b132-7aef-45f4-9fcf-3c199090ba2a,"{""days"":365}","{""user"":{""id"":null,""displayName"":""John Doe""}}","{""user"":{""id"":null,""displayName"":""John Doe""}}",[]
+    ```

package/docs/docs/cmd/spo/file/file-sharinglink-get.md

@@ -0,0 +1,107 @@
+# spo file sharinglink get
+
+Gets details about a specific sharing link of a file
+
+## Usage
+
+```sh
+m365 spo file sharinglink get [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+: The URL of the site where the file is located.
+
+`--fileUrl [fileUrl]`
+: The server-relative (decoded) URL of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`--fileId [fileId]`
+: The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
+
+`-i, --id <id>`
+: The ID of the sharing link.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets a specific sharing link of a file by id.
+
+```sh
+m365 spo file sharinglink get --webUrl 'https://contoso.sharepoint.com/sites/demo' --fileId daebb04b-a773-4baa-b1d1-3625418e3234 --id 1ba739c5-e693-4c16-9dfa-042e4ec62972
+```
+
+Gets a specific sharing link of a file by a specified site-relative URL.
+
+```sh
+m365 spo file sharinglink get --webUrl 'https://contoso.sharepoint.com/sites/demo' --fileUrl 'Shared Documents/document.docx' --id 1ba739c5-e693-4c16-9dfa-042e4ec62972
+```
+
+Gets a specific sharing link of a file by a specified server-relative URL.
+
+```sh
+m365 spo file sharinglink get --webUrl 'https://contoso.sharepoint.com/sites/demo' --fileUrl '/sites/demo/Shared Documents/document.docx' --id 1ba739c5-e693-4c16-9dfa-042e4ec62972
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "1ba739c5-e693-4c16-9dfa-042e4ec62972",
+      "roles": [
+        "write"
+      ],
+      "hasPassword": false,
+      "grantedToIdentitiesV2": [
+        {
+          "user": {
+            "displayName": "John Doe",
+            "email": "john@contoso.onmicrosoft.com",
+            "id": "04355ecd-2124-4097-bc2b-c2295a71d7a3"
+          },
+          "siteUser": {
+            "displayName": "John Doe",
+            "email": "john@contoso.onmicrosoft.com",
+            "id": "11",
+            "loginName": "i:0#.f|membership|john@contoso.onmicrosoft.com"
+          }
+        }
+      ],
+      "grantedToIdentities": [
+        {
+          "user": {
+            "displayName": "John Doe",
+            "email": "john@contoso.onmicrosoft.com",
+            "id": "04355ecd-2124-4097-bc2b-c2295a71d7a3"
+          }
+        }
+      ],
+      "link": {
+        "scope": "organization",
+        "type": "edit",
+        "webUrl": "https://contoso.sharepoint.com/:w:/s/demo/EecoJa3lri9Hu9NWp-W0aBQB8ZqmGqA5tdIiaab4o-6BZw",
+        "preventsDownload": false
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    grantedToIdentities  : [{"user":{"displayName":"John Doe","email":"john@contoso.onmicrosoft.com","id":"04355ecd-2124-4097-bc2b-c2295a71d7a3"}}]
+    grantedToIdentitiesV2: [{"user":{"displayName":"John Doe","email":"john@contoso.onmicrosoft.com","id":"04355ecd-2124-4097-bc2b-c2295a71d7a3"},"siteUser":{"displayName":"John Doe","email":"john@contoso.onmicrosoft.com","id":"11","loginName":"i:0#.f|membership|john@contoso.onmicrosoft.com"}}]
+    hasPassword          : false
+    id                   : 1ba739c5-e693-4c16-9dfa-042e4ec62972
+    link                 : {"scope":"organization","type":"edit","webUrl":"https://contoso.sharepoint.com/:w:/s/demo/EecoJa3lri9Hu9NWp-W0aBQB8ZqmGqA5tdIiaab4o-6BZw","preventsDownload":false}
+    roles                : ["write"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,roles,hasPassword,grantedToIdentitiesV2,grantedToIdentities,link
+    1ba739c5-e693-4c16-9dfa-042e4ec62972,"[""write""]",,"[{""user"":{""displayName"":""John Doe"",""email"":""john@contoso.onmicrosoft.com"",""id"":""04355ecd-2124-4097-bc2b-c2295a71d7a3""},""siteUser"":{""displayName"":""John Doe"",""email"":""john@contoso.onmicrosoft.com"",""id"":""11"",""loginName"":""i:0#.f|membership|john@contoso.onmicrosoft.com""}}]","[{""user"":{""displayName"":""John Doe"",""email"":""john@contoso.onmicrosoft.com"",""id"":""04355ecd-2124-4097-bc2b-c2295a71d7a3""}}]","{""scope"":""organization"",""type"":""edit"",""webUrl"":""https://contoso.sharepoint.com/:w:/s/demo/EecoJa3lri9Hu9NWp-W0aBQB8ZqmGqA5tdIiaab4o-6BZw"",""preventsDownload"":false}"
+    ```